defect-intake-rca

Defect Intake RCA

前置：使用本 Skill 前，先按 using-nucleus 完成 Nucleus 入口识别（Claude Code 会话由插件 SessionStart hook 自动注入该纪律）。

用于 Nucleus V2 缺陷受理 workflow 基线：在 Claude Code / Codex 内做缺陷受理质量评估和 RCA 候选证据生成。这是 coding-agent 插件运行时，不是 PMS 后端 workflow。

核心原则

缺陷受理和 RCA 只能生成可审查的质量评估与根因候选证据；它不能确认根因、修复代码、验证回归、关闭缺陷、创建 PR/MR 或推进 PMS 状态。

缺少 defectId、stage、结构化复现、log / failing test / failed test report、primary feature 或 feature doc 时，不得生成 RCA candidate，必须先补齐缺陷上下文。

RCA candidate、review checklist、summary 或 result 不能替代人工 RCA review、根因确认、修复完成、测试通过或缺陷关闭事实。

到达 rca-review 人审点时，按 _shared/references/subagent-precheck-protocol.md 执行 subagentPreReview 子代理预审；未取得“材料可提交人工审查”结论前，不得请求人工 RCA review。

Checklist

启动本 Skill 后，必须先为以下每一项创建宿主 todo/task，并按顺序执行；Codex 使用计划 / 任务工具，Claude Code 使用 TodoWrite 或等价宿主 todo。每完成、阻塞、等待人工补齐或等待 review 一项，都必须逐项更新状态；若等待项触达人审点，先完成 subagentPreReview 并确认材料可提交人工审查。

1. 读取缺陷上下文：读取 .nucleus/context/<workflowRunId>.json、defect context artifacts 和 primary feature doc；缺关键输入时 ALERT_AND_BLOCK。
2. 创建宿主任务包：把本 checklist 同步成当前会话的宿主 todo/task；未同步前不得生成 intake quality 或 RCA candidate。
3. 校验受理质量：检查 defectId、stage、复现、日志或失败测试、session binding 和写入边界。
4. 补齐缺陷信息：缺少关键上下文时，只呈现缺口并提出当前最关键补齐问题，按 references/defect-info-request-format.md 组织提问；没有明确补齐事实时 STOP。
5. 生成 intake quality 证据：只写 .nucleus/runs/<workflowRunId>/defects/intake-quality.*，不得写源码、测试、PR/MR 或缺陷状态。
6. 生成 RCA candidate：基于已验证上下文生成根因候选和 review checklist；candidate 仍是待审证据。
7. 等待 RCA review：向用户或 PMS 呈现候选、非事实和待确认项；缺人工 review 时 STOP。
8. 写入结果证据：构建 result package；NEEDS_HUMAN_REVIEW 不代表根因确认、修复完成、测试通过或缺陷可关闭。

Runtime

python3 skills/defect-intake-rca/scripts/defect_intake_rca.py analyze \
  --repo-root <target-repo> \
  --context <target-repo>/.nucleus/context/<workflowRunId>.json

仅校验器使用的可选参数：

--candidate-output <target-repo>/.nucleus/runs/<workflowRunId>/defects/rca-candidate.json

必需输入