requirement-analysislisted

# 需求分析 > 本技能是 SDLC 的入口。任何编码动作 MUST 先经本技能产出变更提案。 ## 双流程区分（MUST 先判断项目类型）⭐ ### 新项目流程 ``` 需求分析（本技能） ↓ 概要设计（high-level-design） ↓ 详细设计（detailed-design） ↓ 编码（coding） ``` **适用**：从零开始的新项目 / 大版本重构 / 架构演进 **MUST 完成 HLD + LLD 才能进入编码**。 ### 历史项目流程 ``` 需求分析（本技能） ↓ （可选）详细设计（detailed-design，仅 major 变更） ↓ 编码（coding） ``` **适用**：已有项目的功能更新 / 简单修复 **判断标准**： - major 变更（新功能 / 架构调整）→ 走详细设计 - minor / trivial / hotfix → 跳过详细设计，直接 coding ### 如何判断是新项目还是历史项目 ```bash # 检查项目是否有源代码 ls src/ 2>/dev/null ls */src/ 2>/dev/null ls pom.xml package.json go.mod 2>/dev/null ``` - 无源代码或仅脚手架 → **新项目** - 有完整源代码 + git 历史 → **历史项目** 不确定时 MUST 问用户。 ## 前置条件（MUST 全部通过） - `changes/` 目录已初始化（由安装器完成） - 无（本技能是 SDLC 起点） ## 变更级别识别（MUST 先判断） | 级别 | 触发场景 | 模板 | |---|---|---| | **trivial** | typo、文档、格式、注释 | 仅 changelog，跳过本技能 | | **minor** | 小功能调整、简单 bug | `templates/proposal-simple.md` | | **major** | 新功能、架构调整 | `templates/proposal-full.md` + `design.md` | | **hotfix** | 生产紧急修复 | `templates/proposal-hotfix.md`（走快速通道） | | **migration** | 老项目改造 | `templates/proposal-migration.md` | 不确定级别时 MUST 询问用户。 ## 执行步骤 ### 第 1 步：澄清需求（TODO 阶段 3 填充细节） ### 第 2 步：影响分析（TODO 阶段 3 填充细节） ### 第 3 步：技术方案（TODO 阶段 3 填充细节） ### 第 4 步：生成提案 ID 格式：`YYYYMMDD-<kebab-case-name>`，示例：`2026-08-15-add-user-login` ### 第 5 步：产出变更提案目录 ```bash mkdir -p changes/proposals/<id> cp changes/templates/proposal-<level>.md changes/proposals/<id>/proposal.md cp changes/templates/tasks.md changes/proposals/<id>/ # 复杂需求： cp changes/templates/de