Menú
统一集成测试入口。按 env.yaml 显式指定 / 文件名约定 fallback 探测被测项目的 testing skill,委托其跑测试输出统一 schema 的 verdict.json。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
流程编排引擎。推进 task.json.flow 步骤（init/check/complete/reset）并维护任务级事件流 task.json.events（emit/check/recent）。触发关键词：flow advance、推进流程、当前步骤、初始化流程、emit event、查事件、task.json.events、flow-engine。
TAPD 统一入口 skill。工单拉取、共识管理、子任务回填、事件驱动同步。触发关键词：tapd、初始化、ticket sync、共识、Wiki 评审、子任务、工时回填、QA 通过、QA 打回、TAPD 事件、契约推送、同步工单、拉工单。
产出结构化 handoff 工件，让新 session 无痕接续当前任务。ctx-guard 阻断或主动切换 session 时使用。触发关键词：context reset、上下文重置、新开 session、切换 session、handoff。
运行架构适应度函数检查代码结构、契约、依赖方向。在代码修改前后使用，确保不引入架构违规。触发关键词：fitness、架构检查、适应度、lint、代码质量检查。
工作流熵管理。清理 stale TAPD cache、孤立 _index 条目、过期 task report。每日定时或手动触发。触发关键词：gc、垃圾回收、清理、cleanup、定时清理。
Git 操作统一入口。分支生命周期（create/merge/cleanup）、worktree（create/remove）、提交推送（commit-push）。按 docs/git-brance-spec.md + Conventional Commits 中文规范执行。触发关键词：创建分支、合并到 dev、合并到 uat、删除分支、清理分支、git push、commit、推送代码、worktree、提交代码。
| name | integration-test |
| description | 统一集成测试入口。按 env.yaml 显式指定 / 文件名约定 fallback 探测被测项目的 testing skill,委托其跑测试输出统一 schema 的 verdict.json。 |
薄路由 → 委托对应 testing skill 干活,自己不写测试不跑测试。输出 schema 由各 testing skill 实现。
集成测试、跑测试、回归测试、integration test、verify、evaluator Phase 2 调用。
scripts/route.py 探测应当委托哪个 testing skill/<skill-name>)verdict.json,透传给调用方(evaluator)verdict=ERROR,不要 fallback 到"任意一个 enabled skill"(随便选就会错)"skill": "java-test" 缺 -ing)→ route 还是返回该名,主 Claude 调用时报 skill 不存在,让错误暴露不要隐藏0. --force-stack <stack> (主 Claude 显式覆盖,跳过探测)
1. env.yaml.testing.skill (项目级显式,优先于约定)
2. 文件名约定 fallback (按 CONVENTION 字典顺序)
3. 都没命中 → ok=false,主 Claude 返回 verdict=ERROR
| 文件 | 委托给 |
|---|---|
pom.xml | java-testing |
package.json | frontend-testing(未来) |
requirements.txt / pyproject.toml | python-testing(未来) |
go.mod | go-testing(未来) |
Cargo.toml | rust-testing(未来) |
新增语言: 在 route.py 的 CONVENTION 字典加一行 + 新建 <name>-testing skill。SKILL.md 不必动。
flowchart LR
A[evaluator Phase 2 触发] --> B[调 route.py 取 skill name]
B --> C{ok?}
C -->|否| D[verdict=ERROR<br/>含 hint + candidates]
C -->|是| E[主 Claude 调用 /xxx-testing skill]
E --> F[testing skill 写 verdict.json]
F --> G[校验文件存在 + verdict 字段]
G --> H[透传给 evaluator]
evaluator agent / 其他调用方需:
python .claude/skills/integration-test/scripts/route.py --project-root <abs>ok=true: 用返回的 skill 名,通过 Skill 工具调对应 testing skill,透传 spec_path / story_id / project_root 三个上下文ok=false: 直接写 verdict.json 为 {"verdict": "ERROR", "meta": {"error_message": <route.error + hint>}},不要瞎猜路径: <project_root>/docs/reports/integration-tests/<story_id>/verdict.json
{
"verdict": "PASS | FAIL | ERROR",
"totals": {"tests": 10, "passed": 10, "failed": 0, "errors": 0, "skipped": 0},
"ac_coverage": {"passed_acs": ["AC-001"], "failed_acs": []},
"failures": [{"ac": "AC-003", "test_method": "...", "reason": "...", "severity": "major"}],
"meta": {"test_framework": "junit5", "skill_used": "java-testing", "test_file_path": "..."}
}
meta.test_file_path 必填,单文件模式指该文件、AC-split 并行模式指主支撑类。并行模式下可附可选 meta.test_files: [] 列全部分组文件,旧消费者忽略该字段不受影响。
verdict 语义:
PASS — 所有测试通过(failed=0 + errors=0)FAIL — 至少一个业务断言失败ERROR — 基础设施问题(编译失败 / 依赖缺失 / route 未命中)| 场景 | verdict | meta.error_message |
|---|---|---|
| route.py ok=false | ERROR | 透传 route.error + route.hint |
| 委托的 skill 没产 verdict.json | ERROR | Skill 'xxx-testing' did not produce verdict.json |
| verdict.json 字段缺失 / 损坏 | ERROR | verdict.json schema invalid: <details> |
| testing skill 不存在(主 Claude 调用失败) | ERROR | Skill 'xxx-testing' not found |
.claude/skills/integration-test/scripts/route.pyjava-testingdocs/reports/integration-tests/<story_id>/evaluator agent (Phase 2)adapters.json 注册表 + AI 探测