task-plan-generator_cn

SKILL.md

---
name: task-plan-generator
description: 为复杂任务生成多方案任务计划，并在执行过程中持续优化。适用于：1) 用户提出需要多步骤完成的任务；2) 需要协调多个工具或skill的复杂工作流；3) 需要评估不同执行策略的场景。此skill会在每次任务完成后生成简报归档，分析任务复杂度并提供效率/成功率/资源消耗等多种方案供选择。
---

# Task Plan Generator

这个skill帮助agent为复杂任务生成结构化的任务计划，并在执行过程中持续优化。

## 核心工作流程

1. **接收并分析任务** - 理解用户需求，评估任务复杂度
2. **读取历史资源** - 从plan_source.md获取可用的SKILLS/MCP/工具
3. **生成多方案** - 根据不同策略生成2-3个执行方案
4. **用户确认** - 与用户对话确认不明确的地方
5. **生成任务简报** - 归档执行结果，便于回溯

---

## 第一步：接收任务并分析复杂度

当用户提出任务时，首先进行初步分析：

### 任务复杂度判断标准

| 复杂度 | 判断条件 | 示例 |
|--------|----------|------|
| **短** | 1-2个步骤，单一工具即可完成 | 读取文件、简单转换 |
| **中** | 3-5个步骤，需要2-3个工具协调 | 数据处理+生成报告 |
| **长** | 5个以上步骤，多工具/多次交互 | 完整项目开发、多阶段数据处理 |

### 任务分析输出格式

```
任务复杂度评估：[短/中/长]
预估步骤数：X步
需要资源类型：[SKILLS/MCP/工具列表]
潜在风险点：[列出可能失败或需要确认的地方]
```

---

## 第二步：读取历史成功资源

### 读取 plan_source.md

在当前工作空间或指定路径查找 `plan_source.md` 文件：

```
查找路径优先级：
1. 当前工作空间根目录/plan_source.md
2. 上一级目录/plan_source.md
3. ~/.claude/resources/plan_source.md
```

### plan_source.md 格式规范

```markdown
# Plan Source Resources

## 可用SKILLS
- skill-name: 功能描述 | 上次成功调用时间
- document-skills:pdf: PDF处理 | 2024-01-15

## 可用MCP
- mcp-name: 功能描述 | 上次成功调用时间
- filesystem: 文件系统操作 | 2024-01-15

## 可用系统工具
- Read: 读取文件内容
- Write: 写入文件
- Edit: 编辑文件
- Bash: 执行shell命令

## 可用系统资源
- 当前工作目录路径
- 可访问的API端点
```

### 资源匹配策略

从plan_source.md中筛选与当前任务匹配的资源：
1. 按功能类型过滤（SKILLS/MCP/工具）
2. 按最近成功时间排序
3. 标记可能不可用的资源（超过30天未调用）

---

## 第三步：生成多方案执行计划

根据不同策略生成2-3个方案：

### 方案生成模板

```markdown
## 方案 X：[策略名称]

**策略描述**：XXX
**预估耗时**：X分钟
**成功率预估**：X%
**资源消耗**：低/中/高

### 执行步骤
1. [步骤描述] - 使用[资源]
2. [步骤描述] - 使用[资源]
...

### 风险评估
- [风险点1]：缓解措施
- [风险点2]：缓解措施
```

### 三种推荐策略

#### 策略1：效率优先
- 最小化步骤数量
- 使用最熟悉的工具组合
- 并行化可独立的步骤

#### 策略2：成功率优先
- 选择历史成功率高资源
- 增加验证步骤
- 预留回退方案

#### 策略3：资源消耗最小
- 减少API调用次数
- 使用本地工具替代远程服务
- 合并可合并的步骤

---

## 第四步：识别需要确认的地方

### 触发用户确认的条件

出现以下情况时，必须与用户对话确认：

| 条件 | 示例 | 优先级 |
|------|------|--------|
| 意图不明确 | "处理那个文件" - 哪个文件？ | 高 |
| 资源不可用 | 需要用的skill历史调用失败 | 高 |
| 成功率低于70% | 方案预估成功率为50% | 中 |
| 多种可行方案 | 两种方法都能完成 | 中 |
| 风险较高 | 涉及删除/覆盖操作 | 高 |

### 对话确认模板

```markdown
⚠️ 需要确认

[问题描述]
可能的选项：
1. [选项1]
2. [选项2]
3. [自定义]

请选择或补充说明。
```

### 确认后更新计划

用户确认后，将答案补充到task_plan中：

```markdown
## 确认记录
- Q: [问题]
- A: [用户回答]
- 更新内容: [计划调整]
```

---

## 第五步：生成任务简报

### 简报生成时机

- 任务完成后（无论成功/失败）
- 用户主动要求中断时
- 阶段性里程碑完成时

### 简报格式（低Token + 数据化成功率）

简报分为两个部分：
1. **数据块**（供agent快速读取，结构化便于程序解析）
2. **摘要**（人类可读，50字以内）

```markdown
# Task Report: [task_id]

## DATA
{"t":X,"s":"[success/failed/partial]","d":X,"tools":[
  {"n":"[工具名]","s":X,"h":X},  // 本次成功=1/失败=0，历史成功率%
  {"n":"Read","s":1,"h":98},
  {"n":"Write","s":1,"h":95},
  {"n":"xlsx","s":0,"h":72}
]}

## SUMMARY
[一句话总结，50字以内]
```

### 数据字段说明

| 字段 | 说明 | 示例 |
|------|------|------|
| `t` | 总步骤数 | 5 |
| `s` | 执行状态 | success/failed/partial |
| `d` | 执行耗时（分钟） | 3 |
| `tools[]` | 工具调用记录 | - |
| `n` | 工具名称 | Read, Write, xlsx |
| `s` | 本次成功标志 | 1=成功, 0=失败 |
| `h` | 历史成功率（%） | 98 |

### 历史成功率聚合规则

1. **首次调用**：历史成功率设为 50%（无历史数据）
2. **已有数据**：读取同一工作空间内所有历史简报，聚合计算
3. **聚合计算**：`(成功次数 / 总调用次数) * 100`

### 简报归档规则

1. **归档路径**：`{workspace}/task_reports/{YYYYMM}/{task_id}.md`
2. **命名规范**：`{YYYYMMDD}_{HHMMSS}_{task_name}.md`
3. **历史记录**：保留最近90天的简报，超期自动清理

### 快速读取历史成功率（Agent专用）

当需要获取历史成功率时，按顺序查找：

```bash
# 查找最近30天的所有简报，聚合tools数组
cat {workspace}/task_reports/*.md | grep -A100 "## DATA" | jq '.tools[].h'
```

简化读取示例（不解析全部内容）：
```
读取最近5个简报的DATA行 → 聚合 → 输出: {Read:95%, Write:88%, xlsx:72%}
```

---

## 执行示例

### 示例1：短任务（无需多方案）

**用户输入**："读取当前目录下的README.md文件"

**分析结果**：
```
任务复杂度：短
预估步骤：1步
需要资源：Read工具
```

**执行计划**：
```markdown
## 方案1：直接执行

1. 使用Read工具读取README.md
```

**简报**：
```markdown
# Task Report: read_readme_20240315_143022

## DATA
{"t":1,"s":"success","d":0,"tools":[
  {"n":"Read","s":1,"h":98}
]}

## SUMMARY
成功读取README.md文件
```

### 历史成功率读取示例

下次执行类似任务时，agent可快速获取：
```
从最近10个简报聚合 → Read工具: 98% (98/100)
```

---

### 示例2：中任务（需要多方案）

**用户输入**："分析销售数据并生成图表报告"

**分析结果**：
```
任务复杂度：中
预估步骤：4-5步
需要资源：Read/xlsx/Skills
```

**多方案生成**：
```markdown
## 方案1：效率优先
- 使用xlsx skill直接生成图表
- 预估耗时：5分钟，成功率90%

## 方案2：成功率优先
- 先读取数据验证格式
- 分步生成图表+报告
- 预估耗时：8分钟，成功率95%

## 方案3：资源消耗最小
- 使用本地Python脚本处理
- 预估耗时：10分钟，成功率85%
```

**用户确认**：
```
⚠️ 需要确认
您希望使用哪种格式的报告？
1. PDF文档
2. HTML页面
3. Markdown文件
```

---

### 示例3：长任务（需要详细规划）

**用户输入**："构建一个完整的Web应用"

**分析结果**：
```
任务复杂度：长
预估步骤：15+步
需要资源：多个SKILLS和工具
```

**生成计划**：
- 按阶段分解（需求→设计→开发→测试→部署）
- 每个阶段生成独立方案
- 识别关键依赖节点

**确认环节**：
- 技术栈选择
- 部署平台偏好
- 优先级排序

---

## 注意事项

1. **不要过度规划**：简单任务一步完成，不强制生成多方案
2. **尊重用户时间**：确认问题要简洁明了，避免重复询问
3. **记录历史**：每次执行结果都要归档，用于后续优化
4. **适应变化**：执行过程中发现新情况，及时调整计划
5. **保持简洁**：简报总token控制在300字以内，DATA区结构化，SUMMARY区人类可读

---

## 相关文件

- `plan_source.md` - 历史成功资源记录（需维护更新）
- `task_reports/` - 任务简报归档目录