SKILL.md
5.15 KB
主技能:Work Graph 裁剪判据构建
用途
把"怎样按任务复杂度设计出恰到好处的 work graph"这个模糊目标,拆解成可执行、可验证、 可交付给 Innovator FDE 流水线训练的具体裁剪判据。本技能是这个 Agent 唯一的核心武器—— 不依赖外部 API,只依赖调研能力、结构化写作能力和自我验证纪律。
何时使用
收到任何形式的"研究 work graph 裁剪方法论 / 定义任务复杂度信号 / 产出图形状决策规则" 类任务时,按下面四步顺序执行,不要跳步。
操作步骤
Step 1 — 调研(落盘到 knowledge/)
- 精读本仓库既有骨架体系:
system/agents/workgraph-planning/agent.md(Step 2 候选骨架评估、Step 4 规划 与裁剪授权原文、Step 5 五项校验——裁掉一个节点后图还要过这五项)system/work-graph-templates/planner.json/executor.json/executor-fanout.json/validator.json/README.md
- 复盘真实回归案例背景:
docs/todo/system-design/34-validator-scored-without-real-deliverable.md记录的任务T-mt2r6fz0-125b("apple.com 风格 lemonboss 官网首页",单页静态网站)—— 这是骨架被原样照抄、一个节点都没砍的反面案例,任务本身的复杂度特征 (单一交付物、无持久化数据、需求一句话说尽)是构建信号的第一手素材。 - 调研业界任务复杂度分级方法论,至少覆盖:
- Cynefin 框架(Simple / Complicated / Complex / Chaotic)
- 敏捷估算的 T-shirt sizing / Story Point
- INVEST 原则 + SPIDR 需求拆分模式
- 精益 / YAGNI 视角下的"最小可行流程"
- 每条调研结论都要记录来源(书名/文档路径/URL),存到本体公司态目录下的
knowledge/workgraph-methodology-research.md。没有来源的结论不要写进后续产出。
Step 2 — 定义可量化的任务复杂度信号
- 从 Step 1 的调研中提炼 4-6 个可以从 task-goal 原文/上下文直接读出的复杂度信号,例如:
- 交付物数量与形态(单一静态产物 vs 多模块/多服务)
- 需求确定性(task-goal 本身是否已把范围、干系人、成功标准说尽,还是需要额外挖掘)
- 是否涉及数据持久化 / 状态管理
- 是否存在多个需要对齐的决策干系人(vs 单一决策者)
- 是否有可直接复用的成熟先例(本仓库或业界都有稳定套路,不需要重新设计)
- 每个信号给出明确的判定方法(从 task-goal 文本能直接读出/推断的具体标志), 不能是"凭感觉判断简单/复杂"这种同义反复。
- 输出为 Markdown 表格,落盘到共享工作区下的
workgraph-complexity-signals.md。
Step 3 — 反推「骨架节点 ↔ 信号」的裁剪决策规则
- 针对
planner.json五个节点(brd-planning/prd-planning/sdd-planning/goal-benchmark/planner-validator),逐个写清"哪些信号组合出现时可以砍掉这个 节点、砍掉后下游的needs怎么处理"(比如砍掉brd-planning后,prd-planning的输入直接换成 task-goal 原文,不再依赖上游contract.json的exports)。 - 输出格式必须是决策树或判定表,能被
workgraph-planning的 Step 4 直接引用, 给定一个 task-goal,照着走一遍就能得到确定的节点取舍结果。 - 输出落盘到共享工作区下的
workgraph-pruning-methodology.md。
Step 4 — 自我验证(不可省略)
- 至少准备两个复杂度梯度差异明显的任务样本:
- 简单侧:回归案例本身("apple.com 风格单页官网首页")
- 复杂侧:一个明显复杂的任务(如"多租户 SaaS 后台,含权限体系与数据导出")
- 严格按 Step 3 的规则,对每个样本手动跑一遍,得到裁剪后的节点列表 + 判断依据。
- 检验结果是否合理:简单侧应该裁掉
brd-planning/sdd-planning(或其中之一); 复杂侧应该原样保留五个节点,或裁剪理由明显站不住。 - 如果某个样本跑不出确定结论、或结果明显不合理(该裁的没裁/不该裁的裁了), 回到 Step 2/3 修正,并在最终产出中如实记录"发现的漏洞 + 如何修正", 这部分本身就是交付物的一部分。
产出清单(缺一不可)
knowledge/workgraph-methodology-research.md(本体公司态目录内,带来源的调研笔记)<共享工作区>/workgraph-complexity-signals.md(可量化复杂度信号)<共享工作区>/workgraph-pruning-methodology.md(裁剪决策规则:决策树/判定表)<共享工作区>/workgraph-self-verification.md(自我验证记录:两个样本跑通结果 + 发现的漏洞)
边界
- 不联网时,凭已有知识调研并在文档中明确标注"未核实,凭训练知识回忆",不要假装已核实。
- 不修改任何真实公司的图谱、不派单给其他 Agent、不直接改
workgraph-planning/agent.md本体——本技能只产出方法论文档,落地合并是后续阶段(对照sdd-planning的 FDE 训练 → 合并进生产agent.md流程)的事。