SuperAPI AI 工具集

artifact-review

设计与创作

查看项目

更新于 10-15 21:35

技能介绍

用途:在交接前审查单个工件(PBI、用户故事集、测试规格、设计规格)的完整性与质量,确保其有证据支撑、可交接,不遗漏假设与验收缺口。默认立场是怀疑者,而非仅检查章节是否存在;存在但内容薄弱或不可测试的章节比缺失更糟。

主要能力:按 --type={pbi|story|spec-tests|design} 分派类型,省略时自动推断;执行全部 6 项对抗式技术(为被拒方案辩护、压力测试 3 个假设、验收标准可测试性、事前验尸、未见的替代方案、反向论证)并通过反偏见门;按类型评分必选与推荐项;执行 M1-M7 门禁(阻塞性,适用于所有类型);可读性检查;按类型输出模板(判定 + 必选/推荐统计 + 覆盖/AC 矩阵);验证-修复循环。

判定规则:PASS 为全部必选通过且推荐项通过率≥50%;WARN 为必选全过但推荐项<50%;FAIL 为任一必选失败。M1-M5 或 M7 违规强制判为 NEEDS WORK,并引用 mandate ID 与具体章节/行;证据载体([Source:]、Evidence、CoveredBy、legacy IntegrationTest、frontmatter、mermaid)内的来源标识豁免。

使用方式:以 $skill-name 在 Codex 中调用;执行前先建立并同步任务跟踪;按声明顺序执行步骤,不得跳过、重排或合并,除非用户明确批准;每步需给出简要证据或跳过原因。修复前须先运行 $why-review --validate-findings <report-path> 验证发现,仅修复已验证项,然后重启完整审查(使用新的通用子代理),循环至干净通过。

适用场景:PBI、用户故事、测试规格、设计规格的交接前质量审查。

限制:需项目文档(docs/project-config.json、docs-index-reference.md、lessons.md 等)存在且不过期,缺失时先运行 $project-init 或窄范围设置路由;若 Codex 镜像或 AGENTS.md 缺失/过期,需请用户运行 $sync-codex,不自动执行;若必需步骤或工具在当前环境无法运行,应停止并询问用户后再调整。具体收费、价格、平台支持等信息暂未提供。