SuperAPI AI 工具集

blueprint-derive-tests

测试与质量

查看项目

更新于 10-15 23:49

技能介绍

用途:分析 git 历史,找出缺少对应测试变更的 fix 与 feat 提交,生成结构化的测试回归计划(TRP)文档,作为按优先级排序的测试待办清单,用于系统性补齐回归测试覆盖缺口。

主要能力:检测测试框架与命名约定(vitest、jest、pytest、cargo test、go test 等),映射源码目录到测试目录;分类 fix:/feat: 提交并判断是否带有内联测试文件变更;按固定矩阵分配严重级别(fix 且无内联测试为 CRITICAL,feat 且无内联测试为 MEDIUM,带测试的提交为 COVERED);输出 TRP 文档到 docs/trps/{slug}.md,含 YAML frontmatter、按严重级别统计的摘要、缺口明细表(提交 SHA、主题、严重级别、受影响文件、建议测试类型)与建议创建顺序;若已初始化 Blueprint,则更新 manifest 的 id_registry 与 task_registry。

使用方式:命令为 /blueprint:derive-tests。参数支持 --quick(仅扫描最近 50 个提交)、--since DATE(从指定日期起)、--scope AREA(限定某区域);无参数时默认分析最近 200 个提交。核心分类由脚本执行:bash "${CLAUDE_SKILL_DIR}/scripts/blueprint-derive-tests.sh" --home-dir "$HOME" --project-dir "$(pwd)",可传 --limit 限制扫描数量。更细的 High/Low 分级、邻近测试提交软化与按语言的源码到测试映射需参考 REFERENCE.md。

适用场景:缺陷修复上线但无回归测试、需要从历史生成优先级测试待办、项目入职时评估测试健康状况、查找哪些修复缺少测试覆盖。

限制:需在 git 仓库根目录运行,仓库无提交历史会报错;未检测到测试框架时仅按文件检测并给出警告;TRP 必须写在 docs/trps/ 顶层,不能写入 docs/blueprint/;Blueprint 未初始化时会询问是否初始化或跳过 manifest 更新。其余细节暂未提供。