SuperAPI AI 工具集

implementation-readiness

智能体与模型

查看项目

更新于 10-16 07:24

技能介绍

用途:这是 agent-studio 中的实施就绪门禁,在生成 agent 前校验计划是否可实施。适用 HIGH 或 EPIC 复杂度任务、规划器产出计划需执行前验证、以及路由决策工作流中的 Step 0.6 创建预检。TRIVIAL/LOW 任务、单文件修复或文档更新,以及通过 READINESS_GATE=off 显式绕过的场景应跳过。

调用方式:Skill({ skill: 'implementation-readiness' });

主要能力:含五项检查。检查一计划完整性,每个任务需有清晰标题、至少一条可测试验收标准、至少一个待创建或修改的文件路径、以及 blockedBy 依赖声明。检查二架构合规,新 skill 用 .claude/skills/<name>/SKILL.md 路径,新 agent 用 .claude/agents/<category>/<name>.md,新 hook 用 .claude/hooks/<category>/<name>.cjs,新模块用 kebab-case 命名,Gate 4 路径须用 creator 技能而非直接写入。检查三依赖图有效性,不允许循环依赖,blockedBy 须指向存在的任务,并识别关键路径。检查四风险评审,HIGH/EPIC 任务需有回滚策略、已知风险及性能影响考量(hook 低于 100ms)。检查五测试策略,每个功能任务需有对应测试文件路径、指定测试方式(单元、集成或两者)并确认 TDD 顺序。

输出:返回 JSON,包含 verdict(PASS/FAIL)、complexity、checks 数组(每项含 name、passed、details)、blockers 与 warnings。

与路由器集成:路由将任务分类为 HIGH/EPIC 后调用本技能;PASS 则继续生成 agent,FAIL 则将 blockers 退回规划器解决。环境变量 READINESS_GATE=off 可禁用门禁。

限制与反模式:不得为省时对 HIGH/EPIC 任务跳过此门禁;不得自动通过缺少验收标准的任务;不得把警告当通过;不得对 TRIVIAL 任务套用,以免增加无谓开销。