Appearance
000 — 计划编制与执行指南
1. 计划文档的作用与职能
计划文档是项目开发过程中的核心驱动工具，其职能包括：
- 明确目标：定义当前阶段需要完成的开发任务和预期成果
- 指导执行：为执行者（AI Agent 或开发者）提供清晰的执行步骤和验收标准
- 跟踪进度：记录任务执行和验收的过程，确保每一步都有据可查
- 协调协作：当多个角色（开发员、验收员）参与时，明确各角色的职责和权限
2. 计划文档模版
每个计划文档必须包含以下章节：
markdown
# {编号} — {计划标题}
## 基本信息
| 字段 | 值 |
|------|-----|
| 计划编号 | {三位数字} |
| 创建时间 | {YYYY-MM-DD HH:mm} |
| 更新时间 | {YYYY-MM-DD HH:mm} |
| 执行状态 | 📋待执行 / 🔄执行中 / ✅已完成 / ❌已取消 / ⏸️暂停 |
| 关联设计文档 | {引用 design/ 中的相关文档} |
## 目标
{简述本计划要完成的目标}
## 执行内容
{详细描述需要执行的步骤和任务}
### 任务 1: {任务名称}
- **描述**：{任务的具体描述}
- **涉及文件**：{预计涉及哪些源文件}
- **依赖任务**：{依赖哪些其他任务}
- **预计工作量**：{预估工时}
### 任务 2: {任务名称}
...
## 执行验收标准
{明确定义计划完成的标准，每个标准必须可验证}
- [ ] 验收标准 1
- [ ] 验收标准 2
- ...
> **重要**：每个任务除了相应的代码和文档等已编写外，相关的单元测试也必须全部测试通过才能标记为已完成。测试文档对应本开发计划，由软件验收员编写和验证（详见 `tests/000-test-writing-guide.md`）。
## 涉及的相关变动
{说明本计划执行会影响到哪些其他模块、文档或计划}
## 进度跟踪
> **重要**：进度跟踪章节的更新要求严格限定只有具备对应角色的 Agent 才能更新特定内容。
### 第 1 轮
#### 任务完成情况（由软件开发员填写）
| 任务 | 状态 | 完成说明 | 更新角色 | 更新时间 |
|------|------|----------|----------|----------|
| 任务 1 | ✅已完成 / 🔄进行中 / ⏸️暂停 / ❌受阻 | {完成说明} | 开发员 | {时间} |
#### 任务验收情况（由软件验收员填写）
| 任务 | 验收结果 | 验收说明 | 更新角色 | 更新时间 |
|------|----------|----------|----------|----------|
| 任务 1 | ✅通过 / ❌未通过 / ⏳待验收 | {验收说明} | 验收员 | {时间} |
### 第 2 轮
...（后续轮次按相同格式追加）1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
3. 进度跟踪规则
3.1 角色与权限
| 角色 | 可更新的内容 | 不可更新的内容 |
|---|---|---|
| 软件开发员 | 任务完成情况（状态、完成说明） | 任务验收情况 |
| 软件验收员 | 任务验收情况（验收结果、验收说明） | 任务完成情况 |
| 设计师 | 计划基本信息、目标、执行内容、验收标准 | 进度跟踪中的完成情况和验收情况 |
3.2 更新规则
- 软件开发员仅可更新「任务完成情况」表格，记录任务执行进度
- 软件验收员仅可更新「任务验收情况」表格，记录验收结果
- 每次更新必须记录更新角色和更新时间
- 每轮进度跟踪由开发员先填写完成情况，再由验收员填写验收情况
- 验收员不可修改开发员填写的内容，开发员也不可修改验收员填写的内容
- 如果验收未通过，开发员在下一轮继续填写修正后的完成情况
3.3 轮次规则
- 每轮进度跟踪包含「任务完成情况」和「任务验收情况」两个部分
- 开发员提交完成情况后，验收员在同一轮中填写验收情况
- 如果验收未通过，开启新的一轮，开发员继续工作
- 所有任务验收通过后，该计划标记为「✅已完成」
4. 计划生命周期
创建 → 📋待执行 → 🔄执行中 → ✅已完成
↘ ❌已取消
↘ ⏸️暂停 → 🔄执行中（恢复）1
2
3
2
3
- 创建：设计师创建计划文档，填写基本信息、目标、执行内容、验收标准
- 待执行：计划已就绪，等待分配给开发员
- 执行中：开发员开始执行，进度跟踪章节开始记录
- 已完成：所有任务验收通过
- 已取消：计划因故取消，需在文档中说明取消原因
- 暂停：计划因故暂停，需说明暂停原因和恢复条件
5. 注意事项
- 计划文档始终实时根据情况整理以保持最新
- 无用和过时的计划需及时清理
- 计划的执行内容变更需更新「更新时间」字段
- 进度跟踪章节的历史轮次不可删除或修改（只追加原则）
- 关联的设计文档变更时，需同步更新计划中的引用