con un clic
qa
跨仓库 QA 总控。统一管理测试决策、回归契约、Golden Paths 和 Feature 归类。
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.
Menú
跨仓库 QA 总控。统一管理测试决策、回归契约、Golden Paths 和 Feature 归类。
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
统一开发点火入口。查 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 过滤脚本