SuperAPI AI 工具集

trace-requirements

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

用途:对任务规格中的验收标准(AC)做双向追溯分析,确保每条 AC 都有实现且有测试覆盖,生成可审计的追溯文档与缺口报告。

主要能力:前向追溯(AC → 实现,含文件路径、行号、函数名与代码片段证据);后向追溯(测试 → AC,识别单测/E2E 映射);缺口识别(未实现、部分实现、未测试等);严重度分级(CRITICAL/HIGH/MEDIUM/LOW,可结合风险档案放大严重度);计算实现覆盖率、测试覆盖率、缺口覆盖率与综合追溯分数;预测质量门禁结果(PASS/CONCERNS/FAIL)。支持与 risk-profile、test-design 集成,读取任务规格、风险档案、测试设计与实现/测试文件作为证据。

使用方式:用户提出“trace requirements”“check coverage”“verify AC implementation”等诉求时触发;按顺序执行加载配置与上下文、构建前向矩阵、构建后向矩阵、识别缺口、生成矩阵、给出建议、输出报告几步,前一步未完成不进入下一步。配置文件为 .claude/config.yaml,可设置 assessmentLocation、riskScoreThreshold 及追溯阈值(implementationCoverage: 90、testCoverage: 85、traceabilityScore: 80),模板文件为 .claude/templates/trace-requirements.md(可选),报告输出到 .claude/quality/assessments/{task-id}-trace-{YYYYMMDD}.md。

适用场景:实现评审时验证需求是否覆盖、质量门禁前检查完整性、审计准备、test-design 之后建立测试映射、需要识别并排序覆盖缺口时。

限制:依赖已存在的任务规格与验收标准,缺配置、缺任务文件或无 AC 时会中止;实现文件不可读或超过 50% 的 AC 状态不明确时中止;实现缺口超过 50% 时中止;无测试时仍会继续并生成缺口。具体收费、价格、支持平台与效果资料暂未提供。