Files
tools-show/.agents/skills/writing-plan/references/plan-template.md
2026-04-11 20:46:55 +08:00

108 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 实施计划模板
本文档提供实施计划的标准结构。
---
## 文档路径
```
design/plans/YYYY-MM-DD-<feature>.md
```
---
## 单一子系统计划模板
```markdown
# [功能名称] 实施计划
**目标**[一句话描述此功能构建什么]
**架构**[2-3 句关于方法]
**技术栈**[关键技术/库]
---
## 文件结构
### 新建文件
- `path/to/new/file.ts` - 职责描述
### 修改文件
- `path/to/existing/file.ts` - 修改内容描述
### 测试文件
- `tests/path/to/test.ts` - 测试职责
---
## 任务列表
### 任务 1[任务名称]
**文件**
- 创建:`path/to/file.ts`
- 测试:`tests/path/to/test.ts`
- [ ] **步骤 1**:编写失败测试
- [ ] **步骤 2**:运行测试验证失败
- [ ] **步骤 3**:编写最小实现
- [ ] **步骤 4**:运行测试验证通过
### 任务 2[任务名称]
[继续按相同模式...]
```
---
## 多子系统纲领文件模板
```markdown
# [项目名称] 实施计划纲领
## 子系统划分
| 子系统 | 范围 | 依赖 | 状态 |
|--------|------|------|------|
| 子系统A | [范围] | 无 | 待编写 |
| 子系统B | [范围] | A | 待编写 |
## 执行顺序
1. 子系统A无依赖
2. 子系统B依赖A
## 共享组件
| 组件 | 使用子系统 | 定义位置 |
|------|------------|----------|
| [组件名] | A, B | 子系统A计划中 |
```
---
## 分块指南
| 指标 | 标准 | 原因 |
|------|------|------|
| 行数 | 300-500 行 | 适配上下文窗口 |
| 任务数 | 5-10 个 | 保持逻辑完整性 |
**分块边界**
- 按功能模块分块
- 按实施阶段分块(基础设施、核心功能、集成测试)
- 按子系统分块
---
## 任务要求
- 精确文件路径,无模糊引用
- 计划中包含完整代码,非占位符
- 精确命令及预期输出
- 测试优先方法TDD
- 每个步骤 2-5 分钟可完成