创建计划

技能文档

---
name: create-plan
title: 创建计划
category: 开发工具
description: 将需求文档转化为可执行的故事任务，包含任务依赖、执行顺序和技术指引，用于编码阶段的精准执行。当用户需要将需求文档、功能说明或产品简报转化为实施计划或故事 JSON 时触发。触发词：创建计划、实施计划、需求拆解、任务规划、故事拆分。
---

# 创建计划

将需求与代码仓库上下文转化为可执行的故事。默认仅返回 JSON，除非用户要求讨论。不主动写入文件，除非用户要求。

## 快速开始

1. 获取需求来源与仓库路径
2. 读取需求、上下文、ADR、仓库结构
3. 返回按阻塞关系排序的故事 JSON 对象

## 输入

- 用户提供的需求文档或对话中的需求描述
- 仓库路径（由用户提供）
- 如果缺少任一输入，先向用户确认后再开始规划

## 技能工作流

### 步骤1：加载需求

- 如果用户提供了需求文件，读取该文件
- 否则使用对话上下文中的需求描述，或请用户粘贴需求内容

### 步骤2：扫描代码库

- 如果存在 `<project-root>/.agent/CONTEXT.md`，读取该文件
- 如果存在 `<project-root>/.agent/adr/` 目录下的 ADR 文档，读取相关决策记录
- 简要扫描仓库结构，识别模块划分、编码约定与约束条件

### 步骤3：草拟故事

- 将每个用例或紧密关联的用例组映射为一个故事
- 优先使用迁移波故事，而非宽泛的横切关注点故事
- 每个故事限定为一个用户可见成果或一个有边界的实现关注点

### 步骤4：定义执行细节

- 添加有序的实施任务列表
- 添加故事间的依赖关系（`blockedBy`）
- 仅在架构、模式或先前决策确实需要时，添加简明的技术指引

### 步骤5：规范化故事粒度

- 每个故事必须可在一次编码会话中完成
- 以下情况需要拆分故事：
  - 涵盖多个独立成果
  - 跨越多个松散关联的领域或接口
  - 包含多个主要阶段
  - 缺少清晰的测试/演示边界
  - 任务数超过 5-7 个

### 步骤6：验证

- 每个用例和验收标准必须映射到至少一个故事任务
- 边界情况必须出现在故事任务中
- 最终输出中所有故事的 `executionFit` 必须为 `"fits-one-run"`

### 步骤7：呈现结果

- 返回单个 JSON 对象，使用下方 Schema
- 询问用户故事拆分、依赖关系和技术指引是否合理
- 如果用户要求保存计划，询问路径后写入
- 如果用户要求 Markdown 格式，默认保存到 `<project-root>/.agent/` 目录下

## 映射示例

需求用例："用户可以通过邮箱重置密码"

故事结构：
- title: `添加密码重置请求流程`
- covers: `[2]`
- tasks: 添加接口、生成令牌、发送邮件、添加测试
- demoBoundary: `用户可以成功请求重置邮件`

## JSON Schema

```json
{
  "feature": "[功能名称]",
  "source": ".agent/requirements.md",
  "codebase": "[仓库路径]",
  "stories": [
    {
      "id": "S1",
      "title": "[标题]",
      "covers": [1, 2],
      "tasks": ["任务1", "任务2"],
      "executionFit": "fits-one-run",
      "demoBoundary": "用户可以端到端完成 X 流程",
      "scopeNotes": "单一有界关注点，具备清晰的测试边界",
      "blockedBy": [],
      "techGuidance": null
    }
  ]
}
```

## 规则

- 每个故事必须追溯到需求用例
- 按阻塞关系排序，阻塞者优先
- `blockedBy` = 故事 ID 数组
- `techGuidance` = 字符串或 `null`
- 不要输出过大的故事，先拆分再输出

使用说明

# 创建计划

将需求文档转化为可执行的故事任务 JSON，包含任务依赖、执行顺序和技术指引，直接对接编码执行。

## 使用

在对话中提供需求描述和仓库路径：

```text
请根据以下需求创建实施计划：
- 需求：用户可以通过邮箱重置密码
- 仓库路径：/path/to/project
```

也可以提供需求文件：

```text
请根据 .agent/requirements.md 创建实施计划，仓库在 /path/to/project
```

## 工作原理

技能读取需求与代码仓库上下文，将每个用例映射为一个可在单次编码会话中完成的故事，自动处理任务排序、依赖关系和粒度控制，最终输出结构化的 JSON 计划。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。