用途:审计任意规格说明(spec)是否达到 AI-agent 可执行标准,并在用户确认后重写为清晰、可测试、无歧义的版本。支持 Jira、Linear、GitHub issue 和本地 spec 文件。
两种模式:
- 完整审计模式——用户明确要求 audit/improve/review/rewrite 时触发,运行 6 个阶段:抓取 → 类型识别 → 审计 → 澄清 → 预览 → 回写。
- 快速检查模式——在“implement this”“start on PROJ-123”等即将开工时触发的护栏检查,仅评分问题陈述、验收标准、错误处理、可测试性四个关键维度,输出报告后给出两个选项(先审查改进,或直接继续);若评分为 A/B 则直接放行。
来源识别:Jira 用 atlassian:getJiraIssue(键如 PROJ-123);Linear 用 linear:<read_tool_name>;GitHub 用 github:get_issue(owner/repo/issue_number);本地文件用 Read;也可直接粘贴 spec 文本。来源不明时会询问。
主要能力:识别 spec 类型(API endpoint、UI component、backend feature、bug fix、data migration、generic);按通用维度和类型专属维度评分(0–100,A–F);加载项目约定文件(CLAUDE.md、AGENTS.md 等)避免误报;对父工单做继承覆盖与不一致检测;生成固定格式质量报告并标注 Agent Readiness(READY / CONDITIONALLY READY / NOT READY);逐条提出澄清问题(可回答 skip 记为 [TO BE DEFINED]);生成完整重写预览,显式确认后才回写源(如 atlassian:updateJiraIssue、github:update_issue、Edit)。
限制:需对应 MCP 工具已连接,否则提示用户粘贴内容或检查配置;父工单抓取失败视为非阻塞;不静默解决父子不一致,会标记待人工处理;未确认前绝不回写;评分细则与模板位于 references/ 目录。