用途:在当前 Spec Pack 内按流程顺序扫描文档,找出待澄清、待确认等高价值不确定点,并把结论回写文档,直至不确定性消除或转为可验证条目。核心原则是不猜、不批量问、不留口头结论,每轮只提一个最高杠杆的澄清问题。
主要能力:识别关键词信号与结构缺口信号,生成候选澄清点清单;按文档流程顺序优先处理靠前文档的未决点;将裁决结果回写对应文档并联动更新 AC、范围、数据口径、接口契约、测试计划等;每轮澄清后按要求执行 git 提交(受 AUTO_COMMIT 控制)。
使用方式:读写 {FEATURE_DIR}/requirements 等目录前,必须先执行子技能 spec-context 获取上下文并回显 FEATURE_DIR=...;该步骤失败即停止,仅输出阻断原因与最小输入。用户提供文档路径时仅聚焦该文件,但仍须满足门禁。AUTO_COMMIT=true(默认)时,每轮澄清后执行 git status、git diff、git add 与 git commit,提交信息使用中文;AUTO_COMMIT=false 时改为输出已变更文件清单请手动提交。
适用场景:Spec Pack 文档中出现待确认、待澄清、TBD、TODO、未定、暂定、Open Questions、FIXME 等占位或假设,需要将其收敛为已确认结论或可执行验证项时。
限制:不得把合理默认值当作已确认结论写入;禁止一次问多个问题;前置文档未收敛不得跳到后置文档;用户施压“别问了/一次问完”时仍只问一个最高杠杆问题,其余转为验证项。未回显 FEATURE_DIR 就读写、只口头总结不回写等均属红旗,须立即停止纠正。