用途:在动手写代码前规划功能或变更,暴露对既有功能的影响,先取得共识再实施。触发场景:新增功能、接口、组件或行为;改动触及共享/核心代码;范围不清或存在多种解读。非目标:不写代码(停在审批关口);不生成代码级执行计划(那是 /plan,在 SPEC 获批后运行);除被要求外不访谈用户。
主要能力:先强制查询 wiki(concepts/、entities/、sources/adr/、decisions.md)并引用到 ## Context;梳理未知项,区分事实(去查)与决策((default)、find-out-later、[CẦN LÀM RÕ]);列出受影响文件/函数/模块与可能的副作用;给出 2–3 个本质不同的方案及取舍,禁止默默选择;产出 SPEC 草稿 llmwiki/wiki/sources/draft/DDMMYY-feature-name-module.md,含 R7 要求的各节(Context、Global constraints、Non-goals、Approaches、Plan、FR、SC、Assumptions、Agent Task Assignment、Sequence diagram、Self-review);配套 HTML 页面,每个任务一张由引擎渲染的序列图加完整散文说明;更新 index.md 与 log.md;自审后停在审批关口。
使用方式:按 W01–W08 流程执行,草稿以 YAML frontmatter(type: draft)开头,正文保留 Status: proposed。任务 ID 通过 python3 harness/scripts/code-logger.py --task new title="<feature>" 生成,失败则留空不阻塞。序列图用 archify 渲染,批量命令:for s in llmwiki/html/DDMMYY-feature-name-t*.sequence.json; do o="${s%.sequence.json}.html"; node ~/.agents/skills/archify/bin/archify.mjs deliver sequence "$s" "$o" --json && node ~/.agents/skills/archify/bin/archify.mjs visual-check "$o" --json; done。未知项记账用 python3 harness/scripts/unknown-ledger.py --add …,解决用 --resolve。
限制:SPEC 中仍有未回答的 [CẦN LÀM RÕ] 会被 R7-n 挡在审批关口;缺 R7 必填节会被校验器在写入和提交时拦截;序列图两轮修复后仍为红则停下询问用户,不循环校验;用户未批准则停在第 9 步,无 PLAN 不派发。