w02-task-planning

📁 qiao-925/qiao-skills 📅 6 days ago
8
总安装量
7
周安装量
#35084
全站排名
安装命令
npx skills add https://github.com/qiao-925/qiao-skills --skill w02-task-planning

Agent 安装分布

trae 7
gemini-cli 7
claude-code 7
github-copilot 7
windsurf 7
codex 7

Skill 文档

任务规划规范

适用于长程任务的事前规划,通过 Plan + Checkpoint 机制确保执行可控、进度可追踪。


⚠️ 核心强制要求

触发条件

  • 用户明确要求”规划”、”计划”、”设计方案”等
  • Agent 评估任务需要 >= 3 个明确步骤
  • 涉及多文件改动或架构变更

复杂任务必须创建计划书

复杂度 特征 处理方式
简单 1-2 步,单文件 直接执行
中等 3-5 步,2-3 文件 建议创建计划书
复杂 >5 步,多文件/架构变更 必须创建计划书

长程任务必须启用 GitHub Issue 存档(W00)

  • 预计跨会话/跨天任务,或需要全局追踪进行中状态时,必须通过 w00-workflow-checkpoint 创建或绑定 Issue。
  • 计划书需记录:Issue #、当前 status、Next(下一步)。
  • 创建/绑定 Issue 由主流程完成;w00-workflow-checkpoint 仅负责后续存档与读档。

AI Agent 行为要求

主动提议

对于复杂任务,必须主动提议先创建计划书:

检测到任务涉及 [N] 个步骤,建议先创建计划书。是否执行 scripts/generate_task_plan.py?

状态更新

每完成一个 CP 后,提醒更新状态表:

CP1 已完成,建议更新计划书状态表:CP1: ⬜ → ✅ 已完成 | 2026-01-22

并同步更新对应 Issue 的 checkpoint(含 下一步)。

与 W00 协同(自动 + 手动)

  • 创建计划书并完成 Issue 绑定后可自动触发:w00-workflow-checkpoint checkpoint。
  • 也可手动触发:执行 /w00-workflow-checkpoint 进行 checkpoint 存档或读档上下文。
  • 若已存在 Issue:在计划书中补写 Issue # 并沿用状态流转。
  • 若未明确 Issue 且存在多个候选:先列候选 issue(3~5 条)并让用户选择,再执行存档/读档。

必须等待用户决策

  • 架构/技术选型
  • 性能与维护性取舍
  • 技术债务或临时方案

工具脚本

脚本:scripts/generate_task_plan.py

功能:规划 Checkpoint、生成符合规范的计划书


参考资料

  • references/planning-workflow.md – 规划工作流详细说明(CP划分、状态标记、文件管理、文件清单格式)
  • references/requirements-decisions.md – 需求决策流程详细说明(需求理解、方案设计、决策确认)
  • ../w00-workflow-checkpoint/SKILL.md – Workflow GitHub Issues 基础存档能力(自动 + 手动)
  • refactor-and-decompose/SKILL.md – 规划时文件清单与模块边界约束