用途:simplify 是工作流中的质量门阶段,安排在实现完成之后、测试之前运行,用于审查本次任务范围内的改动文件是否符合规范与可维护性要求。运行时可通过斜杠命令、菜单操作或自然语言技能调用,可移植的阶段名称为 simplify。
主要能力:读取 AGENTS.md,解析任务 ID 并读取 docs/task/{ID}-{task-name}.md;依据 Implementation Notes 和 git diff --name-only 识别改动文件,只读取这些文件;检查编码规范与可维护性;将实现与需求、文件改动、范围外边界和验收标准对照;对偏差分级;把 Quality Gate Notes 追加到任务文档;最终返回 PASS 或 FAIL。若任务文档有 Implementation Notes 但 TASKS.md 仍显示为 Planned 或 In Progress,需将状态对齐为 Testing 再继续;若无 Implementation Notes 则不对齐,说明实现确实未运行。
规范检查项:无未使用代码、死代码或注释掉的实现;有类型替代方案时不使用广泛 any 或未类型化逃逸口;能用守卫子句时避免深层嵌套;函数与文件职责清晰;命名准确描述行为;重复逻辑在造成维护风险时提取;错误被有意处理;生产路径无密钥、凭证或调试日志;遵循 AGENTS.md、LEARNINGS.md 与任务文档中的项目约定。
偏差分级:Minor 表示仍满足范围的小差异,记录后继续;Medium 表示用户可见的有意义差异,风险可接受时记录后继续;Major 表示违反需求、扩大范围或未经批准改变架构,返回 FAIL 并停止。
输出格式:在任务文档中写入 Quality Gate Notes,包含 Result(PASS 或 FAIL)、Standards Review、Deviations、Required Fixes(仅 FAIL 时)。交接信息:通过则提示质量门通过并进入测试阶段;失败则提示返回实现阶段,并列出任务文档中的必需修复项。
限制:仅审查任务范围与改动文件,不新增产品范围;必须在测试前阻塞重大偏差;资料未提供具体安装命令或收费信息。