133 lines
3.4 KiB
Markdown
133 lines
3.4 KiB
Markdown
|
---
|
|||
|
|
name: dev-develop
|
|||
|
|
description: 开发流程 - 开发执行阶段，按步骤执行开发并逐条验证验收标准
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 开发执行
|
|||
|
|
|
|||
|
|
> 开发流程第四阶段：按步骤计划执行开发，每步完成后验证验收标准。
|
|||
|
|
|
|||
|
|
## 调用方式
|
|||
|
|
|
|||
|
|
`/dev-develop`，也可说"开始开发"。
|
|||
|
|
|
|||
|
|
支持指定步骤：`/dev-develop 步骤3` 或 `/dev-develop 3`
|
|||
|
|
|
|||
|
|
## 产出目录
|
|||
|
|
|
|||
|
|
`docs/dev-logs/`
|
|||
|
|
|
|||
|
|
## 执行流程
|
|||
|
|
|
|||
|
|
### Checklist
|
|||
|
|
|
|||
|
|
- [ ] 前置检查：读取步骤计划
|
|||
|
|
- [ ] 读取/创建开发日志
|
|||
|
|
- [ ] 步骤执行循环（对每个步骤）
|
|||
|
|
- [ ] 生成完整开发日志
|
|||
|
|
|
|||
|
|
### 1. 前置检查
|
|||
|
|
|
|||
|
|
- 读取 `docs/plans/` 目录下的步骤计划
|
|||
|
|
- 如果不存在，提示用户先运行 `/dev-plan`（用户可选择跳过，直接开始开发）
|
|||
|
|
- 展示步骤概览和进度
|
|||
|
|
|
|||
|
|
### 2. 读取/创建开发日志
|
|||
|
|
|
|||
|
|
- 检查 `docs/dev-logs/` 是否已有本次开发日志
|
|||
|
|
- 如果有：读取进度，从未完成的步骤继续
|
|||
|
|
- 如果没有：创建新的开发日志
|
|||
|
|
|
|||
|
|
开发日志格式：
|
|||
|
|
|
|||
|
|
```markdown
|
|||
|
|
# 开发日志：<项目名称>
|
|||
|
|
|
|||
|
|
> 创建日期：YYYY-MM-DD
|
|||
|
|
> 对应计划：docs/plans/YYYY-MM-DD-xxx.md
|
|||
|
|
> 状态：进行中
|
|||
|
|
|
|||
|
|
## 进度概览
|
|||
|
|
|
|||
|
|
| # | 步骤 | 状态 | 完成时间 |
|
|||
|
|
|---|------|------|---------|
|
|||
|
|
| 1 | xxx | ✅ 已完成 | HH:MM |
|
|||
|
|
| 2 | yyy | 🔄 进行中 | - |
|
|||
|
|
| 3 | zzz | ⏳ 待执行 | - |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 步骤 N：xxx
|
|||
|
|
|
|||
|
|
**开始时间**：HH:MM
|
|||
|
|
**完成时间**：HH:MM
|
|||
|
|
|
|||
|
|
**执行内容**：
|
|||
|
|
- 创建了 src/xxx.ts
|
|||
|
|
- 修改了 src/yyy.ts
|
|||
|
|
|
|||
|
|
**验收结果**：
|
|||
|
|
- [x] 标准 1：通过（附验证命令输出）
|
|||
|
|
- [x] 标准 2：通过
|
|||
|
|
|
|||
|
|
**备注**：
|
|||
|
|
[任何偏离计划的情况]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 步骤执行循环
|
|||
|
|
|
|||
|
|
对每个待执行的步骤：
|
|||
|
|
|
|||
|
|
**3a. 展示步骤详情**
|
|||
|
|
- 展示当前步骤的目标、具体任务和验收标准
|
|||
|
|
- 确认用户准备开始
|
|||
|
|
|
|||
|
|
**3b. 执行开发任务**
|
|||
|
|
- 按步骤计划中的任务项逐一执行
|
|||
|
|
- 编写/修改代码，保持简洁
|
|||
|
|
- 不添加计划之外的功能
|
|||
|
|
|
|||
|
|
**3c. 自动运行检查**
|
|||
|
|
- 检查是否有 lint 配置，有则运行
|
|||
|
|
- 检查是否有 type check 配置，有则运行
|
|||
|
|
- 检查是否有 build 命令，有则运行
|
|||
|
|
- 运行现有测试（如有）
|
|||
|
|
- 如果检查失败，修复后重新运行
|
|||
|
|
|
|||
|
|
**3d. 逐条验证验收标准**
|
|||
|
|
- 对照步骤计划中的每条验收标准
|
|||
|
|
- 展示每条标准的验证方式和结果
|
|||
|
|
- 对于命令行验证：展示命令输出
|
|||
|
|
- 对于文件检查：展示文件内容
|
|||
|
|
- 对于功能验证：描述验证过程
|
|||
|
|
|
|||
|
|
**3e. 用户确认**
|
|||
|
|
- 展示所有验收标准的验证结果
|
|||
|
|
- 询问用户是否确认通过
|
|||
|
|
- **通过**：标记步骤完成，更新开发日志，进入下一步
|
|||
|
|
- **未通过**：根据反馈修复，重新验证，回到 3d
|
|||
|
|
|
|||
|
|
### 4. 完成开发日志
|
|||
|
|
|
|||
|
|
所有步骤完成后：
|
|||
|
|
- 更新开发日志状态为"已完成"
|
|||
|
|
- 记录总体完成时间
|
|||
|
|
- 保存到 `docs/dev-logs/YYYY-MM-DD-<项目名>.md`
|
|||
|
|
- 提示下一步可调用 `/dev-test` 进行测试
|
|||
|
|
|
|||
|
|
## 断点续做
|
|||
|
|
|
|||
|
|
如果开发中途退出（会话结束），下次启动 `/dev-develop` 时：
|
|||
|
|
- 自动读取开发日志
|
|||
|
|
- 识别最后一个"进行中"的步骤
|
|||
|
|
- 询问用户是从该步骤重新开始，还是继续下一步
|
|||
|
|
- 支持用户指定任意步骤：`/dev-develop 3`
|
|||
|
|
|
|||
|
|
## 关键行为
|
|||
|
|
|
|||
|
|
- 每个步骤开始前明确展示目标，不盲目动手
|
|||
|
|
- 验收标准逐条核对，不自评"通过"
|
|||
|
|
- 用户确认后才进入下一步，不跳过
|
|||
|
|
- 遇到问题及时反馈，不强行继续
|
|||
|
|
- 代码修改保持简洁，不添加计划外的增强
|