name: task-planning
description: |
Feature development workflow orchestrator — from requirement analysis to step-by-step execution with todolist tracking. Use this skill whenever the user wants to: plan a new feature or system, break down work into steps, create or update a todolist.md, or asks about "how to organize this work". Also use it proactively when starting any non-trivial multi-step implementation that would benefit from structured planning before coding. If the user says "分析需求", "拆分任务", "创建todolist", or references a todolist.md file, this skill applies.

Task Planning — 功能开发工作流编排

本 skill 管理从需求分析到分步执行的完整工作流。适用于任何需要多步实现的功能开发。

工作流总览

需求分析 → 创建/更新 todolist.md → 分步执行 → 维护标记

阶段 1：需求分析

与用户对齐需求，明确以下内容：

1. 功能目标：要实现什么，解决什么问题
2. 依赖现状：当前代码库中已有哪些相关实现（用 Explore agent 调研）
3. 边界：哪些在本次范围内，哪些是"后续"
4. 技术路线：复用已有系统（如 SubData、AI 状态机）还是新建

分析完成后，向用户简要汇报发现，确认理解一致后进入阶段 2。

阶段 2：创建 / 更新 Todolist

文件位置

放在对应模块目录下，命名为 todolist.md。例如：
- GamePlay/Map/Entity/AI/todolist.md（实体 AI 相关）
- GamePlay/Pasture/todolist.md（牧场系统相关）

如果同一目录已有 todolist.md 且包含相关章节，更新而非新建。

模板结构

# [系统名称] — 开发 TodoList

> 协作建议：本文件用于长期任务跟踪；单轮交接请配合 `Tasks/Agents/codex_task.md` 使用。

> **维护规则见 `.claude/skills/task-planning/` 阶段 3。**

---

## 一、[第一个子系统/阶段]

### 步骤 N：[步骤标题]
- [ ] 具体任务描述 1
- [ ] 具体任务描述 2

> 修改文件：file1.cs（新建）、file2.cs（共 N 个）
> 验证：[编译通过 / 运行验证 / 具体检查点]

---

## 二、[第二个子系统/阶段]（后续）

- [ ] 粗粒度任务条目（待展开）

拆分原则

每个步骤是一个可独立验证的逻辑单元：

• 步骤完成后能编译通过，不引入编译错误
• 步骤的改动可以作为一个整体被审查
• 建议每步涉及 3-5 个文件（含新建），视逻辑完整性灵活调整
• 不要为了凑数字硬拆：1 个文件能完成的不拆，天然需要 6 个文件的不强行压缩

拆分时的优先级：逻辑完整性 > 文件数量限制

步骤标注要求

每个步骤下方用引用块标注：
- > 修改文件： 列出将改动/新建的文件名及数量
- > 验证： 说明完成后如何验证（编译、运行测试、手动检查等）

"后续"章节

对当前阶段之外的工作，用粗粒度条目占位。不需要拆步骤，等到实际开始时再展开。

阶段 3：分步执行

按 todolist 中的步骤顺序执行，遵循以下维护规则。

维护规则

1. 完成标记：每完成一个子项，将 - [ ] 改为 - [x] 并在末尾用 — 追加完成备注（修改了哪些文件、关键决策）。不加 emoji，[x] 本身已表示完成
2. 方案变更：实现过程中需要调整方案、拆分步骤、或新增任务时，先与用户对齐确认，得到同意后再修改 todolist
3. 前置检查：每个步骤开始前，先读取 todolist 确认前置步骤已完成
4. 问题标注：遇到计划外的问题或依赖，在对应步骤下用 > ⚠️ 标注说明
5. 用户手动操作（如编辑 Excel、Unity Inspector），明确列出操作步骤后暂停等待

完成备注格式

- [x] 任务描述 — 修改 FileA.cs、新建 FileB.cs；决策：选择方案 A 因为 XXX

备注应包含：实际修改了哪些文件、关键决策及原因（如有）。

阶段 4：阶段收尾

当一个章节（如"一、基础 AI"）的所有步骤完成后：

1. 确认该章节所有 - [ ] 已变为 - [x]
2. 如果下一章节需要展开，与用户确认后将粗粒度条目拆分为详细步骤
3. 如需持久化经验（如发现的坑、架构决策），存入 memory 而非 todolist