Menu
跨仓库 QA 总控。统一管理测试决策、回归契约、Golden Paths 和 Feature 归类。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| 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 过滤脚本统一开发点火入口。查 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、合并前检查、代码门禁。