SuperAPI AI 工具集

spec-review

编程与开发

查看项目

更新于 10-16 00:02

技能介绍

用途:这是两阶段审查中的第一阶段(Stage 1),在任务实现完成后、质量审查之前,验证实现是否与设计规格一致,并确认遵循 TDD。触发方式包括用户运行 /exarchos:review 命令、任务实现完成、子代理报告任务完成等。

主要能力:审查功能完整性、TDD 合规性、规格对齐与测试覆盖;不覆盖代码风格、SOLID 原则、性能优化与错误处理优雅性(这些属于质量审查)。审查基于集成分支相对 main 的完整差异(main...integration),可发现跨任务接口不匹配与孤立视角看不到的缺陷。

使用方式:该技能在编排器派生的子代理中运行,而非内联执行。编排器负责先生成 diff(exarchos_orchestrate({ action: "review_diff", worktreePath: "<worktree-path>", baseBranch: "main" }))并传入派发提示,子代理读取状态文件获取设计/计划产物路径,运行验证命令(npm run test:run、npm run test:coverage、npm run typecheck),并调用 exarchos_orchestrate({ action: "check_tdd_compliance", featureId, taskId, branch })。子代理必须返回结构化 JSON,包含 verdict(pass/fail/blocked)、summary、issues 与 test_results。

流程与限制:审查失败时创建修复任务并派发给实现者,修复后重新审查直至通过;跨任务问题归类为 cross-task integration 并阻塞相关任务。审查结果写入状态时必须是带 status 字段的对象(如 { "status": "pass" }),扁平字符串会被 all-reviews-passed 守卫静默忽略。通过后自动继续质量审查,无需人工确认。组合 diff 超过 2000 行时建议按任务增量审查。资料未提供具体收费、平台支持范围等信息。