---
name: requirement-analysis
description: 把零散想法、口头需求、工单、告警浮出的问题整理成可执行的需求说明（intent）；当用户提到需求分析、梳理需求、写需求文档、补全场景、功能规划，或要求开始一个新功能时使用。仅适用于新功能/大需求（跨模块、新契约、需拍板）；BUG 修复与小调整不走此链，直接改+跑测试。
---

# Requirement Analysis（intent 阶段）

## 适用分级（先自检，勿为小修拖时间）

按 AGENTS.md「需求分级」：小修/BUG 修复（≤3 文件、无新契约、无需拍板）直接改 + 跑该域测试，**不建 intent**；中等需求只出 plan；只有新功能/大需求/跨模块才从本 skill 起步走完整链。

## 目标

把零散需求整理成可以继续评审、开发和测试的需求说明（SDLC 循环的 **Plan 阶段工件 intent**）。重点不是把话写漂亮，而是暴露缺口、明确边界、沉淀 TODO。

## 工作方式

1. 先收集上下文：原始需求、历史文档、相似功能、接口说明、权限规则、已有实现。
2. 按结构整理需求：背景、目标、角色、流程、字段、状态、异常场景。
3. 不确定内容必须标记 TODO，不要替产品或负责人拍板。
4. 需求过大先拆：一期必做 / 后续增强 / 明确不做。
5. 输出可执行需求说明，而不是长篇 PRD。
6. **落盘位置**：`plans/YYYYMMDD-<slug>-intent.md`（从 `templates/intent.md` 起步）。

## 输出结构

```md
# 需求说明：功能名称

## 背景和目标

## 用户角色

## 功能范围（本期做 / 本期不做）

## 核心流程

## 字段和状态

## 权限规则

## 异常场景

## TODO / 待确认问题
```

## 下一步（链条衔接）

intent 确认后 → grill-with-docs 拷问细化 → `specs/<slug>.md` → Plan mode 出 `plans/YYYYMMDD-<slug>-plan.md` 才动 src。模板在 `templates/`。

## 参考资料

- `references/output-templates.md` / `references/question-checklist.md` / `references/example-crud.md`