Menü
测试资产维护分诊台：诊断项目当前状态，定位管线断裂层，路由到正确的 skill 或 CLI 命令
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | test-maintain |
| description | 测试资产维护分诊台：诊断项目当前状态，定位管线断裂层，路由到正确的 skill 或 CLI 命令 |
| when_to_use | 当用户不确定该用哪个 skill/CLI 命令，或需要对测试资产做维护但不确定从哪入手时 |
| argument-hint | <maintenance_request> |
| arguments | ["maintenance_request"] |
| user-invocable | true |
| allowed-tools | Read Glob Grep Bash Agent |
| effort | high |
本 skill 是测试维护的分诊入口，不是 codegen 引擎，不直接修改文件。
核心工作模式：
理解用户意图
→ 诊断项目当前状态（确定性命令）
→ 定位最左侧断裂层
→ 路由到对应 skill / CLI
→ 验证修复结果 + 摘要
refs/routing.md — 症状映射、验证命令、废弃影响面模板test_workspace/generated/ 是编译产物，修改必须回到上游源头。refs/routing.md），用户确认后才执行。test_workspace/results/。提取三个要素：
意图不明确时，直接进入 Step 2 诊断，用项目状态帮用户定位问题。
删除、发布、修改 .env 或改待测系统代码的请求，必须先停下确认。
测试资产管线从左到右：
knowledge → cases → scaffold → codegen → execution → emitter
L0/L1/L2 Markdown fixture/profile generated report 模式沉淀
按层序检查，找到最左侧断裂层。 右侧问题可能是左侧断裂的连锁反应。
诊断命令（按需选用）：
| 层 | 命令 | 看什么 |
|---|---|---|
| knowledge | ls test_workspace/knowledge/L*/，检查 target/module/suite effective knowledge refs | 知识库覆盖与追溯 |
| cases | ls test_workspace/suites/{target}/{suite}/ | 用例和 suite.yaml |
| scaffold | aitest codegen --suite-file <s.yaml> --validate-profile，检查 module.yaml.knowledge_refs.l1 | fixture/profile/L1 接线 |
| codegen | aitest codegen --suite-file <s.yaml> --check | generated 与源头同步 |
| execution | ls test_workspace/reports/{target}/.../latest/ | 最近执行结果 |
不涉及特定模块时，优先用健康检查或显式 task；--all 只作为最后兜底，避免在大 workspace 中盲目扫描全部 suites：
aitest doctor
aitest codegen --task-file test_workspace/tasks/<task>.yaml --check
aitest codegen --all --check
多模块诊断：scope > 1 module 时委托子 Agent 并行诊断（见子 Agent 策略节），主 Agent 只看聚合结论。
常见症状到断裂层的映射见 refs/routing.md。
诊断输出：
## 诊断结果
范围：{target} / {module} / {suite}
断裂层：{layer}
症状：{description}
建议路由：{skill / CLI}
一条原则：修最左侧断裂层。
| 断裂层 | 路由 | 需确认 | 交接信息 |
|---|---|---|---|
| knowledge | knowledge-build | 是（影响面大） | 模块名、缺口描述、关联文档 |
| cases | test-design / test-fix | 否 | 模块+知识库引用 / case_id+错误描述 |
| scaffold | test-scaffold | 否 | target、模块、缺口清单 |
| codegen | test-codegen | 否 | suite.yaml 路径 |
| execution | aitest run | 否 | 无需路由 skill |
| emitter | emitter-build | 是（框架级变更） | 已验证 pytest、可沉淀模式 |
"需确认"列为"是"时，向用户说明影响范围，确认后再路由。
特殊路由：
aitest registry register-suiteaitest task createrefs/routing.md），用户确认后路由底层 skill交接时只传底层 skill 需要的最小上下文，不传本 skill 的分析原文。
底层 skill 报告"问题不在本层"时，回退到 Step 2 重新诊断，不重复执行同一路由。连续 2 次误路由后停下，向用户呈现完整诊断数据，请求人工判断。
底层 skill 完成后，重跑 Step 2 的诊断命令，确认断裂层已修复。验证命令序列见 refs/routing.md。
发现新的断裂层（如修了 scaffold 后 codegen 需要重跑）时，继续路由下一层。
验证通过后输出摘要：
## 维护摘要
动作：{add/update/retire/delete/sync/diagnose}
断裂层：{layer} → 已修复 / 仍有问题
路由：{skill} → {结果}
资产变化：{简要列表}
后续：{需要人工确认的 / 下一个断裂层}
| 步骤 | 任务 | 输入 | 输出 | 确认方式 |
|---|---|---|---|---|
| Step 2 | 多模块并行诊断 | module 列表、诊断命令表 | 每模块（断裂层 / 症状 / 建议路由） | 主 Agent 聚合后呈现 |
| Step 4 | 验证闭环 | 验证命令序列 | pass/fail 摘要 | 失败时阻塞 |
scope ≤ 1 module 或验证命令 ≤ 3 条时主 Agent 直接处理，不委托子 Agent。
从 target-aware case suite、task manifest 或 target/module/all selector 生成 pytest，执行 profile gate、Case IR、freshness check，并处理少量 UNPARSED 补写
构建模块级 fixture/module profile 或用例级 suite profile，把 Markdown 用例接入 test-codegen 管线
从已验证 pytest、Case IR 和 profile 中识别可沉淀模式，评估是否晋升为 assertion_rules、case_flows、fixture helper 或 emitter 规则
基于测试知识库和测试规范，为指定模块或需求 suite 生成 Markdown 用例和 mismatch 记录
将外部/历史/公司测试平台用例迁移为 AITest Markdown suite 用例，并保留语义追溯、阻塞分类和人工 review 清单
从源码和现有文档生成面向测试的设计文档，补全知识库构建所需的输入