Skill: louisding9527/task-plan-generator (version 1.0.1)

--- 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/` - 任务简报归档目录


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)