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

1.9 KiB
Raw Blame History

实施计划模板

本文档提供实施计划的标准结构。


文档路径

design/plans/YYYY-MM-DD-<feature>.md

单一子系统计划模板

# [功能名称] 实施计划

**目标**[一句话描述此功能构建什么]

**架构**[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[任务名称]

[继续按相同模式...]

多子系统纲领文件模板

# [项目名称] 实施计划纲领

## 子系统划分

| 子系统 | 范围 | 依赖 | 状态 |
|--------|------|------|------|
| 子系统A | [范围] | 无 | 待编写 |
| 子系统B | [范围] | A | 待编写 |

## 执行顺序

1. 子系统A无依赖
2. 子系统B依赖A

## 共享组件

| 组件 | 使用子系统 | 定义位置 |
|------|------------|----------|
| [组件名] | A, B | 子系统A计划中 |

分块指南

指标 标准 原因
行数 300-500 行 适配上下文窗口
任务数 5-10 个 保持逻辑完整性

分块边界

  • 按功能模块分块
  • 按实施阶段分块(基础设施、核心功能、集成测试)
  • 按子系统分块

任务要求

  • 精确文件路径,无模糊引用
  • 计划中包含完整代码,非占位符
  • 精确命令及预期输出
  • 测试优先方法TDD
  • 每个步骤 2-5 分钟可完成