计划工坊
> 复杂任务 → 交互拆解 → 验证闭环 → 可执行计划。不替你执行,但保证你想周全。
Purpose
当用户面对复杂任务——Vue升级、需求上线、系统迁移——单一对话无法表达全部约束时,计划工坊通过两级拆解(阶段→步骤)+ 六步验证工作流,将模糊需求转化为可执行的多文件计划目录。它不替你做事,只保证你想周全。
Context
本 Skill 适用场景:任务复杂度超出单轮对话能覆盖的范围,拆解过程中会多次出现决策点需要用户拍板。不适用:简单任务("帮我建个文件夹")、已明确知道所有步骤的线性任务。
依赖:用户交互驱动核心流程,WebSearch(可选)做技术调研补充。输出目录写入当前工作目录。
Instructions
路由表
| 用户输入 | 场景 | 工作流 |
|---|---|---|
| "帮我规划"、"拆解"、"生成计划" 等新任务描述 | 🏗️ 创建新计划 | W1: 创建新计划 |
| "加载计划"、"继续计划"、"恢复计划" + 目录路径 | 🔍 加载已有计划 | W2: 加载已有计划 |
路由规则:用户输入含已有计划目录名时 → 提示选择 W2;否则按 W1 处理。
核心原则
🔒 交互式拆解:不一次性出完整计划。每轮拆解 → 列出决策点 → 用户确认 → 继续下一轮,直到全部覆盖。
🔒 验证闭环:六步验证不可跳过。拆解循环结束 → 多维验证(技术/资源/时间/成本/风险/执行顺序)→ 不满足条件则沟通调整。
🔒 状态可追溯:每一步的状态、决策记录、遗留问题均写入独立文件。中断后可恢复上下文。
🔒 人审终审:计划生成的每一步——拆解方向、决策选择、验证结果——最终确认权在用户。
输出文件约定
Output
最终交付物:计划目录
每次交互的输出内容由对应工作流定义(见 references/),最终交付物为完整的计划目录。
任务名称从用户输入自动提取。输出目录结构:
{任务名称}/
├── README.md # 总入口:任务概述、目录索引、当前状态摘要
├── plan.md # 执行计划:阶段+步骤两级结构,每步含目标/依赖/预估耗时/验证标准
├── decisions.md # 决策点:待用户确认的选项清单
├── decision-log.md # 用户决策记录:已拍板的历史决策及依据
├── status.md # 状态追踪:当前步骤、已完成、待处理、阻塞项
├── issues.md # 遗留问题:前序步骤未解决事项,含优先级和责任人
└── logs/ # 执行日志目录:每步完成后写入对应报告
├── stage-01-step-01.md
└── ...
- 输出目录:当前工作目录下创建以任务名称命名的子目录
- 文件命名:固定名称(README.md / plan.md / decisions.md / decision-log.md / status.md / issues.md)+ logs/ 目录
- 文件格式:全部 Markdown (.md)
- 目录创建:若输出目录不存在,自动创建
- 覆盖策略:同名目录已存在时追加更新,不覆盖已有内容
加载策略
- L1 body(本文):始终加载。含路由表、核心原则、输出约定。
- W1 references/workflow-create.md:创建新计划时加载(主工作流)。
- W2 references/workflow-load.md:加载已有计划时加载。
- references/plan-template.md:按需加载(生成计划文件时参考)。
Notes
错误处理
- 用户输入过于模糊无法拆解 → 追问澄清,不猜测
- 外部搜索失败 → 标注「信息待补充」,不阻塞流程
- 文件写入失败 → 对话中报错,提示检查磁盘空间
- 加载已有计划时目录不存在 → 提示用户并提供创建新计划的选项
职责边界
本 Skill 为纯 LLM 驱动的交互式规划工具,不包含执行脚本。所有任务拆解、决策提取、多维验证均由 LLM 在对话中完成。文件写入通过 Write 工具执行。scripts/ 目录预留,仅用于未来可能的模板生成脚本。
Further Reading
- references/workflow-create.md — W1 六步验证工作流
- references/workflow-load.md — W2 加载已有计划
- references/plan-template.md — 输出文件模板
- DESIGN.md — 需求规格与架构决策
文件结构
| 文件 | 说明 |
|---|---|
SKILL.md |
L1 路由+核心原则+输出约定 |
DESIGN.md |
需求规格+架构决策 |
README.md |
用户入门文档 |
CHANGELOG.md |
版本变更记录 |
.consistency.yml |
一致性配置 |
references/workflow-create.md |
W1 创建新计划 |
references/workflow-load.md |
W2 加载已有计划 |
references/plan-template.md |
计划输出格式参考 |