Omd Rule

/omd-rule — 裁决一张票

调 omd MCP path_rule(可能带前缀 mcp__omd__;未加载先 ToolSearch "path_rule"),参数 ticketId + ruling(多图带 slug)。

裁决怎么落地看后端:md 后端写进 docs/plan/pathfinder/.md 的票 status/ruling;gh 后端写一条 resolution 评论(首行约定 **ruling**: )并 close 对应 issue。两后端语义等价。

裁决成功后工具还把「: 裁决 = 」写进 omd 自记忆(omd.pattern fact),供 memory_recall / 会话开场检索复用;这步是增益,写失败只 warn(输出里 ⚠ … memory 是增益)不阻断裁决本身。

纪律:裁决权属于 owner

• 只有 owner 明确表达决定("就用 SQLite"、"按方案 B 来"、"/omd-rule t3 …")才调。你的角色是把口头决定提炼成一句清晰 ruling——task 票的 ruling 会成为将来 slice 节点的执行目标 goal,要写到弱 executor 也能独立完成。
• owner 表达模糊 → 先复述你理解的裁决让其确认,再落。
• 裁决后工具重算前沿回报解锁/散尽。区域散尽只是报信——执行永远等 owner 显式 /omd-deliver,不自作主张接着交付。

写 ruling 前过判定树(承终裁手册)

裁一张 task 票 = 一次终裁。这几件事在 ruling 里先判清,别留给弱执行体乱猜:

1. 真源三层分离(最重要)

「有没有真源」是三个问题,分开答,别混成一个 defer:

| 层 | 问题 | 缺了怎么写 ruling | |---|---|---| | 读面 | 契约/端点/字段存在吗 | 缺 → ruling 含「先建读面」 | | producer | 有东西往里写吗 | 缺 → 照常实装读面,注明 producer 是哪张票的活;不算造假 | | 数据 | 有样本吗 | 缺 → ruling 含「扩 seed,只用真机制造数」 |

错误做法:因 producer 缺就把票裁成 defer(= 静默砍范围)。

2. 灰态三种合法画法(上游能力物理不存在时)

外部 API / 定时任务 / 凭证链真不存在 → 灰,只三种画法,ruling 指明哪种:

1. 无源恒缺席:数据键不出现,前端显 "—"。
2. 断链说明卡:禁用态 + 断链图标 + 原因句,零假数据(方案画了假明细也不渲染)。
3. 灰常量即真值:管道不存在时状态就是常量,不需要状态端点(端点等上游一起来)。

判别:方案自己画了断链/禁用态 = 灰态确证,不是 defer 借口。

3. 有据偏差(唯一合法的偏离)

实装语义比方案更准时可偏离,条件 = ruling 写明依据一句话。说不清依据 → 照方案做或标 ?。

4. 敏感判定(哪些不能自裁,标 ? 等 owner)

敏感:签核/审批闸、修改/冲销通道、状态机转移与过账、金额/税率派生公式、契约字段语义变更、DB 层不变量迁移、删既有闸。 不敏感(可直接裁):读面聚合、展示派生(排序/格式)、i18n、seed、灰态卡、前端交互态。 判别:错了会污染账面或绕过审计 = 敏感;错了只是显示难看 = 不敏感。

撤销/改判

地图是 docs/plan/pathfinder/.md 人可编辑 markdown,直接改 status/ruling(未知状态词不丢票,进 unrecognized 分组)。

与既有 skill 的边界

• omd-rule 只裁决(记决定);执行改文件是 /omd-deliver 的权力闸,裁完不自动交付。
• 裁前方案未定 → 先 /omd-grill 审问或 /omd-council 择优;裁不动的敏感项标 ? 升级 owner。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: AbyssCN
• Source: AbyssCN/oh-my-dag
• License: MIT

Install and usage instructions live in the source repository linked above.