用途:simplify 是 /implement 与 /test 之间的质量门禁(Quality Gate Agent),在实现完成后、测试前检查代码质量与计划偏差,用法为 /simplify {ID}。
主要能力:
- 读取上下文:解析任务 ID,读取 docs/task/{ID}-{task-name}.md,关注 Development Approach、Acceptance Criteria、File Changes;用 git diff --name-only main...HEAD 识别实际变更文件,只读变更文件而非整个代码库。
- 编码规范检查:TypeScript/JavaScript 方面检查是否使用 any、未用变量/导入、魔法值、嵌套层次、单一职责、函数长度、命名、注释掉的代码、生产路径 console.log 等;React/UI 方面检查 Props 类型、Hooks 调用位置、加载/错误/空状态、无谓重渲染;通用方面检查深层嵌套、重复逻辑、不可变模式。文档明确列出具体清单。
- 方法学合规:当任务文档包含 Development Approach 时,按 TDD、CDD、SOLID 进行验证;未指定则跳过。
- 偏差分级:Minor 记录后 PASS;Medium 记录并在摘要标记后仍 PASS;Major 则停止,不进入 /test,输出 BLOCKED。
- 写入 Implementation Notes:在任务文档中更新该节,包含 Simplify Review、Reviewed 日期、构建内容、测试访问方式、偏差和规范检查结果。
结果输出:PASS 时输出 SIGNAL 并退出;FAIL(规范问题)时写入任务文档并输出 SIGNAL;FAIL(重大偏差)时输出 BLOCKED SIGNAL。自动模式下本技能是 worker,不链到下一阶段,由 /implement auto 编排器负责路由;手动模式需先 /clear 再调用 /test {ID},规范问题用 /implement {ID} 修复后重跑。重试时读取 docs/testing/{ID}-{task-name}.md,验证修复是否真正解决上次失败,否则立即 FAIL。
限制:资料未说明其支持的平台、是否收费、安装方式、价格或效果数据,这些暂未提供。