# Proj Change

> Proj Change

- Skill: `zhangloveyan/proj-change` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zhangloveyan/proj-change`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhangloveyan/proj-change/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zhangloveyan (https://skillmd.com/u/zhangloveyan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhangloveyan/proj-change

---


# 需求变更

## 触发词

- "需求变了"
- "再加个字段"
- "这个不要了"
- "改一下"

---

## 执行流程

```
Step 0: 校验任务文档 → Step 1: 记录变更 → Step 2: 评估影响 → Step 3: 确认变更 → Step 4: 更新文档 → Step 5: 继续开发
```

---

## Step 0: 校验任务文档

- 确认全流程任务文档存在
- 若缺失，先创建任务文档骨架并补齐流程状态与上下文快照

---

## Step 1: 记录变更

```markdown
## 变更记录

**变更类型：** 新增 / 修改 / 删除
**变更描述：** {具体描述}
**变更原因：** {为什么要改}
```

---

## Step 2: 评估影响

```markdown
## 影响分析

**影响范围：**
- [ ] 数据库表结构
- [ ] Entity 实体类
- [ ] Mapper
- [ ] Service
- [ ] DTO
- [ ] Controller

**影响文件：**
- 需修改：{文件列表}
- 需新增：{文件列表}
- 需删除：{文件列表}

**风险评估：**
- 是否影响已有数据：是/否
- 是否影响其他功能：是/否
```

---

## Step 3: 确认变更

向用户确认：
- 变更内容
- 影响范围
- 注意事项

---

## Step 4: 更新文档

### 更新方案文档（如有）

```markdown
## 变更记录

| 日期 | 变更内容 | 原因 |
|------|----------|------|
| 2025-01-15 | 新增 phone 字段 | 需要记录手机号 |
```

### 更新任务文档

```markdown
仅记录变更状态、产物路径与下一步指令，不写实现细节
```

同步更新：
- 流程状态总览中标记“业务开发/任务拆分”为进行中
- 产物清单记录需求/方案文档更新路径
- 上下文快照记录“变更中”与风险/阻塞
- 下一步指令指向具体变更开发任务

---

## 常见变更影响

| 变更类型 | 影响范围 |
|----------|----------|
| 加字段 | 表结构、Entity、DTO |
| 改字段类型 | 表结构、Entity、DTO、Service |
| 加接口 | Service、Controller、可能需要新 DTO |
| 删功能 | 可能涉及多层代码删除 |

---

## 注意事项

1. **先评估后执行** - 不要直接改代码
2. **记录变更历史** - 在方案文档中记录
3. **更新任务列表** - 变更产生的任务要加入列表（仅记录状态与简述）
4. **标记变更任务** - 用 `[变更]` 前缀标识
5. **注意数据兼容** - 涉及数据库的变更要考虑已有数据
6. **任务文档同步** - 全程维护流程状态、产物清单、上下文快照、下一步指令