requirement-analysis

需求分析

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

核心原则

关键澄清没有回答前，只能澄清，不能估算，不能建议接纳。

需求分析只回答“需求是否清楚、是否值得接纳、接纳成本是否可信”。它可以产出待评审 PRD、满足度 / 工作量评估、需求尺寸和接纳建议，但不做需求设计、正式特性拆解、开发计划、测试计划、技术方案、源码修改或最终接纳裁决。

待评审 PRD 和 evaluation 草稿提交人工或 PMS 评审前，必须先按 requirement-analysis-review 的 subagentPreReview 调度独立 reviewer 子代理；未取得“材料可提交人工审查”预审结论时，不得请求人工评审通过。

什么时候使用

使用本 Skill：

• 判断一个需求是否清楚、是否值得接纳、接纳成本是否可信。
• 生成供产品经理或 PMS 评审的 docs/requirement/**/prd.md 和 evaluation.md 草稿。
• 在明确授权下把澄清、满足度、gap、满足路径、轻量实现口径、工作量、需求尺寸和接纳建议收口为需求分析证据。

不要使用本 Skill：

• 已接纳需求后的方案设计、产品子需求拆解或正式特性拆解。
• 特性设计、开发准备、测试生成、缺陷修复或交付收口。
• 普通 setup、普通开发或未授权场景写 docs/requirement/**。

Checklist

启动本 Skill 后，必须先为每一项创建宿主 todo/task，并按顺序逐项推进、逐项更新状态；Codex 使用计划 / 任务工具，Claude Code 使用 TodoWrite 或等价宿主 todo。.nucleus/runs/**、summary.md、result.json、候选文件和 review report 只能记录事实，不能替代宿主任务、人工回答、人工评审或 PMS 接纳事实。

1. 读取需求输入和 context 完成证据：input-evidence.json 或等价输入证据。 STOP：未读需求输入、.nucleus/context/<workflowRunId>.json 或 standalone problem statement 时，不得提问、估算或生成需求文档。

2. 读取产品上下文 完成证据：产品定位、docs/features/**、docs/architecture/**、安全实现线索或缺失证据。 STOP：未读产品与特性上下文时，不得把用户原话直接整理成 PRD。

3. 复述当前理解 完成证据：understanding.md，说明需求想解决什么、归属哪个产品能力、已有满足度初判和证据缺口。 STOP：复述中出现技术方案、接口设计、数据表、权限码或开发计划时，必须退回需求语言。

4. 识别并推动关键澄清 完成证据：clarification-questions.json、clarification-candidate.md、人工回答记录。 STOP：一次只能推动一个最影响接纳和成本的问题；没有明确回答前，不得生成 PRD、工作量或接纳建议。细节读取 references/clarification-method.md。

5. 调用 requirement-evaluation 做满足度和工作量评估 完成证据：analysis-package.json、workload-estimate.json、acceptance-recommendation.json 或等价结构化评估证据。 STOP：必须显式加载并执行 requirement-evaluation；形成满足度 gap、满足路径、轻量实现口径和工作量评估前，不得估人日、不得给接纳建议、不得写需求评估正文；不得直接从澄清答案跳到人日估算。

6. 调用 requirement-sizing 识别需求尺寸 完成证据：requirement-sizing.json，以及待写入 evaluation.md 的“需求尺寸”中文结论。 STOP：需求尺寸必须在满足度、gap、满足路径、轻量实现口径和工作量评估完成后识别；不得在需求澄清开始阶段、单凭原始需求标题或早期澄清问题猜测尺寸。