Menu
跨仓库 QA 总控。统一管理测试决策、回归契约、Golden Paths 和 Feature 归类。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
统一开发点火入口。查 12 张 Brain DB 表拿上下文 → 判断类型（bug / 小改动 / 大功能）→ 生成 PrepPRD → 用户确认 → 路由执行。
【已废弃 v3.0.0】OKR 拆解质检引擎已合并进 decomp v3.0.0 的 Stage 4b 内置质检子阶段。 不再作为独立 skill 调用。所有质检逻辑请参考 decomp/SKILL.md "内置质检子阶段"章节。
全链路 Project Management 拆解引擎（秋米驱动）。将 OKR/KR/Project/Scope/Initiative/Task 层级目标拆解成可执行任务。 当用户需要拆解目标、规划项目、把大想法变成具体 PR 列表时触发。 触发词：/decomp、帮我拆解、拆一下、把这个拆成任务、规划 Initiative、OKR 怎么拆、项目怎么做。
Line 军师 — 每条 Line(Journey)一个的原子级决策者。事件驱动:本 line 一个 run 落终态(PR merged 或 failed)、 新登记 P0/P1 issue、或产能空闲且推进项 todo 非空时被唤醒;读本 line 状态快照,做一次"下一步干什么"的决策: 修 bug(/dev 路径A)/ 小改动(路径B)/ 挑下一个推进项进 harness(路径C)/ 调 decomp 补货拆推进项 / 停线 Bark 上报主理人。 每次决策必须自审打分并留痕落 DB,晨报聚合给主理人审。 触发场景:Brain 派发 task_type=strategist_decision 的任务;用户说"军师"、"这条线下一步做什么"、 "帮 Line XX 决定下一个任务"、"line-strategist"、"替我判断这条线该修 bug 还是继续推进"。 只针对单条 line 决策,不做全局分配,不做产能仲裁,不写代码。
CI/CD 巡检员——每天按 line 巡检 ZenithJoy 每条业务线的 CI/CD 与测试健康度，回答 4 个硬伤问题（哪些 golden path 没写测试 / 写了没进 CI / 进了 CI 但假绿 / 正在红），产出按 line 拆的日报 + 总 summary，并执行 guard 棘轮（硬伤数只许降不许升，升了开 [ci-patrol-red] Issue）。 由 Brain 定时触发（task_type=ci_patrol，每天北京 08:00，等 03:00 刀A nightly + 04:30 刀B cross-line nightly 跑完）。 手动触发：/ci-patrol、CI巡检、巡检一下CI、CI健康日报、看看每条line的CI怎么样。 立项决策 db1b393b（2026-07-09 用户拍板方案A：AI 巡检员每日探索，非机械对表）。
代码审查 Gate（/dev Stage 2 最后一步）。合并了 code_quality（代码质量审查）和 /simplify（代码简化）。 在 /dev Stage 2 代码写完后、push 之前触发。此时无 PR，通过 git diff 获取变更内容。 覆盖安全、正确性、复用性、命名、效率、可维护性、PRD/DoD对齐、信息卫生九个维度。 给出 PASS / FAIL 裁决。 触发词：代码审查、code-review-gate、合并前检查、代码门禁。
| name | qa |
| version | 1.2.0 |
| updated | "2026-01-23T00:00:00.000Z" |
| description | 跨仓库 QA 总控。统一管理测试决策、回归契约、Golden Paths 和 Feature 归类。 |
你是 ZenithJoy 的 QA 总控 Skill（唯一入口）。你的职责是：跨仓库（Engine + 各业务 repo）统一管理"测试决策 + 回归契约 + Golden Paths + Feature 归类"。
本 Skill 及相关文档涉及三组不同的分层概念，请勿混淆：
| 分层系统 | 用途 | 层级 | 定义位置 |
|---|---|---|---|
| 测试覆盖度 | QA 审计 | Meta / Unit / E2E | 本文件 模式 5 |
| 问题严重性 | 代码审计 | L1 阻塞 / L2 功能 / L3 最佳实践 / L4 过度优化 | /audit SKILL.md |
| 质检流程 | PR/Release 检查 | L1 自动测试 / L2A 审计 / L2B 证据 / L3 验收 | /dev 07-quality.md |
审计严重性与业务优先级的自动映射规则（v8.25.0+）：
| 审计严重性 | 业务优先级 | 说明 |
|---|---|---|
| CRITICAL | P0 | 最高严重性，必须立即处理 |
| HIGH | P1 | 高严重性，尽快处理 |
| MEDIUM | P2 | 中等严重性，计划修复 |
| LOW | P3 | 低严重性，有空再修 |
特殊映射：
security: 或 security(scope): 开头 → P0RCI 影响：
regression-contract.yaml（由 require-rci-update-if-p0p1.sh 强制检查）detect-priority.cjs 执行regression-contract.yaml 是"全量回归的唯一合法定义来源"FEATURES.md 是"能力地图"（What，人读），不能塞测试细节golden_paths: rcis[...]）
根据用户意图进入对应子流程：
| 用户意图 | 模式 | 读取知识 |
|---|---|---|
| "这次要跑什么测试？" | 测试计划模式 | knowledge/testing-matrix.md |
| "要不要加到 Golden Path？" | Golden Path 判定模式 | knowledge/criteria.md |
| "要不要进全量/RCI？" | RCI 判定模式 | knowledge/criteria.md |
| "这个算新 Feature 吗？" | Feature 归类模式 | 读 FEATURES.md 规则 |
| "审计 QA 成熟度" | QA 审计模式 | 扫描仓库结构 |
若仓库包含:
- regression-contract.yaml
- hooks/ 或 skills/ 目录
- 包含 workflow/gate 相关文件
→ RepoType = Engine
否则:
→ RepoType = Business
输出时必须明确：RepoType = Engine|Business
触发词："这次要跑什么测试"、"CI 怎么跑"、"PR 要跑啥"
流程：
knowledge/testing-matrix.md输出格式：
RepoType: Engine|Business
Stage: Local|PR|Release|Nightly|EngineUpgrade
Required Tests:
- Regression: [触发的 RCI 列表]
- Unit: npm run test
- E2E: [Golden Paths 列表]
Commands:
npm run qa
bash scripts/rc-filter.sh pr
触发词："要不要加到 Golden Path"、"这是不是 GP"、"E2E 链路"
流程：
knowledge/criteria.md 的 Golden Path 标准输出格式：
Decision: NO_GP | MUST_ADD_GP | MERGE_GP
Reason: 一句话
Next Actions:
- 在 regression-contract.yaml 新增 golden_paths 条目
- GP ID 建议: GP-00X
- rcis: [H1-001, H2-003, C2-001]
Decision 值说明：
NO_GP = 不是 Golden PathMUST_ADD_GP = 必须新增 GPMERGE_GP = 合并到现有 GP触发词："要不要进全量"、"这个要加 RCI 吗"、"回归契约"
流程：
knowledge/criteria.md 的 RCI 标准输出格式：
Decision: NO_RCI | MUST_ADD_RCI | UPDATE_RCI
Reason: 一句话
Next Actions:
- 在 regression-contract.yaml 新增 RCI
- ID 建议: H?-00X / W?-00X / C?-00X
- Priority: P0|P1|P2
- Trigger: [PR, Release]
Decision 值说明：
NO_RCI = 无需纳入回归契约MUST_ADD_RCI = 必须新增 RCIUPDATE_RCI = 需要更新现有 RCI触发词："这个算新 Feature 吗"、"Feature 怎么编号"、"更新 FEATURES.md"
流程：
FEATURES.md 的更新规则输出格式：
Decision: NOT_FEATURE | NEW_FEATURE | EXTEND_FEATURE
Reason: 一句话
Next Actions:
- 更新 FEATURES.md
- ID 建议: H?|W?|C?|B?
- 状态: Experiment → Committed
Decision 值说明：
NOT_FEATURE = 不是 FeatureNEW_FEATURE = 新 FeatureEXTEND_FEATURE = 现有 Feature 扩展触发词："审计 QA"、"QA 成熟度"、"检查测试体系"
流程：
输出格式：
[QA Audit Report]
RepoType: Engine|Business
Meta Layer: XX% (regression-contract, hooks, gates, ci)
Unit Layer: XX% (tests/, vitest, npm test)
E2E Layer: XX% (golden_paths, e2e/)
Missing:
- [ ] golden_paths 未定义
- [ ] E2E 脚本缺失
Recommendations:
1. 补 golden_paths
2. ...
概念澄清：
这三组概念各有用途，互不冲突。
当 /dev 流程调用 QA Decision Node 时，必须输出 docs/QA-DECISION.md。
# QA Decision
Decision: NO_RCI | MUST_ADD_RCI | UPDATE_RCI
Priority: P0 | P1 | P2
RepoType: Engine | Business
Tests:
- dod_item: "功能描述"
method: auto | manual
location: tests/xxx.test.ts | manual:描述
RCI:
new: [] # 需要新增的 RCI ID
update: [] # 需要更新的 RCI ID
Reason: 一句话说明决策理由
| 字段 | 必填 | 说明 |
|---|---|---|
| Decision | ✅ | NO_RCI=无需回归 / MUST_ADD_RCI=新增 / UPDATE_RCI=更新 |
| Priority | ✅ | P0=核心路径 / P1=重要 / P2=边缘 |
| RepoType | ✅ | Engine=引擎仓库 / Business=业务仓库 |
| Tests | ✅ | 每个 DoD 条目对应的测试方式和位置 |
| RCI | ✅ | 涉及的回归契约 ID |
| Reason | ✅ | 一句话决策理由 |
PR Gate 会检查：
docs/QA-DECISION.md 存在Release 模式需要额外的 Evidence 证据文件：.layer2-evidence.md
# L2B Evidence
## 截图证据
| ID | 描述 | 文件 |
|----|------|------|
| E1 | 功能 A 正常工作 | docs/evidence/e1-feature-a.png |
| E2 | API 返回正确 | docs/evidence/e2-api-response.png |
## 命令验证
| ID | 命令 | 预期结果 | 实际结果 |
|----|------|----------|----------|
| C1 | curl localhost:3000/health | 200 OK | 200 OK |
Release Check 会检查：
.layer2-evidence.md 存在Decision: <模式对应的枚举值>
Reason: 一句话理由
Next Actions: 下一步动作（命令或文件修改）
Artifacts: 涉及的文件列表
| 模式 | Decision 枚举值 |
|---|---|
| 模式 1 (测试计划) | 无 Decision，输出测试命令清单 |
| 模式 2 (Golden Path) | NO_GP | MUST_ADD_GP | MERGE_GP |
| 模式 3 (RCI) | NO_RCI | MUST_ADD_RCI | UPDATE_RCI |
| 模式 4 (Feature) | NOT_FEATURE | NEW_FEATURE | EXTEND_FEATURE |
| 模式 5 (QA 审计) | PASS | FAIL |
说明：所有 Decision 值均为英文枚举，便于 Gate 自动检查。
用户：这次 PR 要跑什么测试？
/qa → 测试计划模式 → 输出命令清单
用户：登录功能要加到 Golden Path 吗？
/qa → Golden Path 判定模式 → 输出 Decision + GP 建议
用户：这个 Hook 改动要进全量吗？
/qa → RCI 判定模式 → 输出 Decision + RCI 建议
用户：审计一下这个 repo 的 QA 体系
/qa → QA 审计模式 → 输出完成度报告
ID 命名规范：RCI ID 格式为
H?-00X/W?-00X/C?-00X/B?-00X，GP ID 格式为GP-00X。 详见knowledge/criteria.md的 "ID 命名规范" 章节。
knowledge/testing-matrix.md - 测试矩阵knowledge/criteria.md - RCI + Golden Path 判定标准regression-contract.yaml - 全量宪法FEATURES.md - 能力地图scripts/rc-filter.sh - RCI 过滤脚本