planning-and-task-breakdown

技能简介

该技能用于将复杂或模糊的工作拆分成有序、可验证的小任务。它通过制定计划文档和任务列表，帮助 Agent 或人类明确实现顺序、验收标准与依赖关系，避免因任务过大而难以着手或产生混乱。

使用场景

• 有规格或明确需求，需要拆分为可实现任务时
• 任务太大或太模糊，无法直接开始
• 需要将工作并行分配给多个 Agent 或会话
• 需要向人类清晰传达工作范围和实施顺序
• 实现顺序不明确，需要梳理依赖关系时

使用方法

该技能作为 Agent 技能使用，通常由 /build 等命令触发。核心流程如下：

1. 进入计划模式：只读分析规格和相关代码，识别现有模式、组件依赖、风险与未知项，不写代码。
2. 绘制依赖图：确定组件之间的依赖关系，按“先基础后上层”的顺序实现。
3. 垂直切片：按完整功能路径拆分，而不是先做全部数据库、再全部 API、再全部 UI。每个任务都应交付可测试的功能。
4. 编写任务：每个任务包含描述、验收标准、验证方式、依赖、涉及文件和规模估算。
5. 排序与检查点：确保依赖满足，系统始终处于可工作状态，每 2-3 个任务设置验证检查点，高风险任务提前处理。

输出文件：计划文档保存到 tasks/plan.md，任务列表保存到 tasks/todo.md（除非项目指定使用外部跟踪器，如 GitHub Issues、Jira、Linear）。

注意事项

• 单文件改动、范围明确、或规格中已包含成熟任务定义时，不要使用本技能。
• 任务规模建议为 S（1-2 个文件）或 M（3-5 个文件）；L（5-8 个文件）及以上必须继续拆分。
• 规划期间只输出计划，不进行任何代码实现。