SKILL.md

---
name: "requirement-processor"
description: "结构化处理用户需求：分析、文档、阶段规划、迭代闭环"
---

# 需求处理器 (Requirement Processor)

当用户提出新功能/变更需求时，使用此 Skill 标准化处理流程。

## 核心理念

1. **先理解再动手** — 需求未澄清前不写代码
2. **文档先行** — 所有需求必须有结构化文档
3. **分阶段实施** — 按 P0/P1/P2 优先级拆解
4. **闭环迭代** — 实施后更新文档，复盘经验

## Workflow

### Step 1: 需求澄清 (Clarify)

收到需求后，首先要确认以下信息。如果用户未明确说明，主动询问：

- **背景与现状：** 当前系统或项目是什么状态？
- **核心目标：** 用户真正想解决什么问题？
- **边界约束：** 有无技术限制（架构、语言、部署方式）？
- **优先级：** 哪些功能是必须的（P0），哪些可以后做（P1-P2）？
- **用户画像：** 谁会用这个功能？单用户还是多用户？

> 📌 不需要一次性全问完 — 根据需求复杂度判断，简单需求 1-2 个问题即可。

### Step 2: 现状调研 (Survey)

在写文档前，先确认：

- 项目当前已有的功能、数据模型、API
- 当前架构和部署方式（纯前端/全栈/微服务等）
- 有哪些相关代码文件需要阅读
- 用户是否已有相关配置或基础设施（域名、数据库、认证方案等）

阅读关键文件（如路由、组件、数据层、配置文件），记录现有设计决策。

### Step 3: 需求文档输出 (Document)

使用以下模板结构输出 `requirements.md`：

```markdown
# 项目 — 需求文档

> **日期：** YYYY-MM-DD
> **版本：** v1 草案

## 1. 背景与现状

### 1.1 当前状态
（架构、技术栈、部署方式、已有功能）

### 1.2 痛点
| 问题 | 说明 |
|------|------|

### 1.3 目标
（一句话概括要做什么）

## 2. 整体架构

### 2.1 架构图（文本 + 推荐架构）

### 2.2 关键决策
| 决策点 | 选项 | 推荐 | 理由 |
|--------|------|------|------|

## 3. 功能需求

按模块分类，每个功能有：ID、功能描述、优先级（P0/P1/P2）

## 4. 数据模型

### ER 图（文本格式）

### DDL / 类型定义

## 5. API 设计

| 方法 | 路径 | 说明 | 认证 | 权限 |

## 6. 前端变更概览

- 新增页面/组件清单
- 路由设计
- 状态管理变更
- 关键类型定义

## 7. 安全考虑

（认证方式、密码策略、权限校验、防护措施）

## 8. 实施阶段

### Phase 1 — 基础（P0）
### Phase 2 — 增强（P0-P1）
### Phase 3 — 优化（P1-P2）

## 9. 部署方案

（Docker 编排、环境变量、Nginx 配置等）

## 10. 未解决问题 / 待决策事项
```

### Step 4: 用户确认 (Validate)

将需求文档发送给用户并提问：

- 整体方向是否符合预期？
- 优先级排序是否合理？
- 有无遗漏或误解的功能？
- 分阶段方案能否接受？

记录用户反馈，更新文档。

### Step 5: 实施规划 (Plan)

根据确认后的需求文档：

- 以实际文件为单位制定实施步骤
- 评估工作量（文件数、估算行数、预期工时）
- 确定当前会话的实施范围（全部或仅 Phase 1）
- 开始编码实现

### Step 6: 复盘迭代 (Iterate)

实施完成后：

- 记录实施过程中的经验教训
- 更新需求文档（标记已实现的功能、更新架构信息）
- 向用户汇报完成情况和剩余待办
- 更新此 SKILL 的 `references/` 目录中的经验笔记
- 向用户提出改进此 Skill 的建议

## 输出物规范

1. 需求文档保存为 `项目名-requirements.md`（如 `worktime-auth-requirements.md`）
2. 文档附在回复中供用户查看
3. 实施后文档保留在项目目录，作为后续开发参考

## 参考资料（可选扩展）

- `references/requirement-templates/` — 各类型需求的文档模板
- `references/experience-notes/` — 每次实施后的经验总结
- `references/decision-log/` — 架构决策记录（ADR 格式）

## ⚖️ 权限声明

| 权限 | 范围 | 用途 | 说明 |
|------|------|------|------|
| 文件系统 | 写入 | 工作目录 | 生成需求文档 (.md) |
| 文件系统 | 读取 | 项目目录 | 调研现有代码和配置 |
| 网络 | 无 | N/A | 纯本地离线技能 |
| 执行 | 无 | N/A | 不执行任何系统命令 |

> 此技能为纯文档/流程技能，不修改系统配置或执行外部命令。