实施计划创建Skill create-plan

---

name: create-plan description: 根据问题分析或功能概念创建实施计划 allowed-tools: Read, Grep, Glob, Write

创建实施计划

基于现有分析或概念文档生成详细的实施计划。

指令

1. 检测当前上下文

   • 检查当前git分支以确定工作流文件夹
   • 分支 feature/42-something → 查找 .ai/issue-42-*/
   • 分支 feature/my-feature → 查找 .ai/feature-my-feature/

2. 查找源文档

   • 查找 analysis.md（来自 /analyze-issue）或 concept.md（对于功能）
   • 如果未找到，请用户先运行 /analyze-issue 或提供上下文

3. 阅读项目指南

   • 查看 CODING_GUIDELINES.md 获取实施标准
   • 查看 TESTING_GUIDELINES.md 获取测试要求
   • 查看 COMMIT_GUIDELINES.md 获取提交结构

4. 创建实施计划

   • 在相同工作流文件夹中编写 plan.md
   • 分解为具体的、可操作的任务
   • 包括文件路径和具体更改
   • 基于 TESTING_GUIDELINES.md 添加测试计划

计划模板

写入 .ai/<folder>/plan.md:

# 实施计划: <分支名称>

## 源
- 问题: #<number> (<链接>)
- 分析: `.ai/<folder>/analysis.md`

## 概述
<简要总结将要实施的内容>

## 先决条件
- [ ] 功能分支已创建: `feature/<名称>`
- [ ] 分析已审查和理解
- [ ] 没有阻塞性问题

## 实施任务

### 任务 1: <名称>
**文件**: `path/to/file.go`

**更改**:
- [ ] <具体更改 1>
- [ ] <具体更改 2>

**详细信息**:
<任何额外上下文或代码片段>

### 任务 2: <名称>
**文件**: `path/to/file1.go`, `path/to/file2.go`

**更改**:
- [ ] <具体更改>

**依赖于**: 任务 1

### 任务 3: 添加测试
**文件**: `test/cmd/<file>_test.go`

**更改**:
- [ ] 添加 `Test<函数名称>` - <测试内容>
- [ ] 添加 `Test<函数名称>WithError` - <错误情况>

**测试要求**: 遵循 TESTING_GUIDELINES.md

## 测试计划

### 单元测试
| 测试名称 | 目的 | 文件 |
|-----------|---------|------|
| `TestXxx` | <目的> | `test/...` |

### 集成测试
| 测试名称 | 场景 | 文件 |
|-----------|----------|------|
| `TestXxxCommand` | <场景> | `test/cmd/...` |

## 文档更新
- [ ] `docs/<命令>.1.md` - <需要更改>
- [ ] `docs/gitflow-config.5.md` - <如果配置更改>
- [ ] 命令帮助文本更新

## 检查点

每个检查点后，验证：
1. `go build ./...` 成功
2. `go test ./...` 通过
3. 更改按预期工作

| 检查点 | 任务后 | 验证 |
|------------|------------|--------------|
| 1 | 任务 1 | <应该工作的内容> |
| 2 | 任务 2 | <应该工作的内容> |
| 3 | 任务 3 | 所有测试通过 |

## 提交策略

遵循 COMMIT_GUIDELINES.md 计划提交。

## 预计范围
- 要修改的文件: <数量>
- 新文件: <数量>
- 要添加的测试: <数量>

5. 验证计划

   • 确保分析中所有受影响文件都涵盖
   • 验证测试计划与 TESTING_GUIDELINES.md 对齐
   • 检查文档要求

6. 报告完成

   • 显示创建计划的路径
   • 建议下一步: /validate-tests 验证测试方法，然后开始实施