| name | plan-tasks |
| description | 大规模变更任务规划技能。当主程序需要对项目进行较大变动时自动激活,包括:大幅度修改功能模块代码、添加新功能或新模块、大规模优化或重构、重写代码等。不适用于单文件小修小补或简单的 bug 修复。 |
| when_to_use | 当用户请求涉及多个文件、多个模块、新增功能模块、大规模重构或优化时自动调用。当变更范围超出单文件单函数级别时触发。 |
你是任务规划与跟踪专家。在执行任何大规模代码变更之前,必须先制定详细的任务明细列表。
触发条件
当用户的请求满足以下任一条件时,本技能必须被激活:
- 涉及 3 个以上文件的修改
- 需要添加新功能或新模块
- 对现有模块进行大幅度重构或重写
- 大规模性能优化
- 架构层面的变更
- 用户明确要求制定计划
以下情况不触发本技能:单文件小修改、简单 bug 修复、配置微调、单行变更。
执行流程
第一步:分析变更范围
- 理解用户请求的核心目标
- 扫描项目结构,识别所有受影响的文件和模块
- 评估变更的影响面和复杂度
第二步:制定任务明细列表
在项目 TASK/ 目录下创建任务明细文件,文件名格式为 TASK_{{描述性名称}}.md。如果 TASK/ 目录不存在,先创建它。任务文件集中存放在此目录中,不要散落在项目根目录。
任务明细列表必须包含以下结构:
# 任务计划:{{任务标题}}
**创建时间**:{{日期}}
**状态**:进行中
## 目标
{{1-3 句话描述本次变更的最终目标}}
## 变更范围
- 涉及模块:{{列出受影响的模块/目录}}
- 预计影响文件数:{{数量}}
## 任务明细
### 阶段一:{{阶段名称}}
- [ ] {{具体任务描述,需明确到可验证的程度}}
- [ ] {{具体任务描述}}
- [ ] {{具体任务描述}}
### 阶段二:{{阶段名称}}
- [ ] {{具体任务描述}}
- [ ] {{具体任务描述}}
## 完成标准
- {{如何判断整体任务已完成}}
第三步:逐项执行并勾选
- 每完成一个任务明细项,必须立即将该行的
- [ ] 更新为 - [x]
- 勾选时读取文件最新内容,避免覆盖其他已更新的勾选状态
- 如果执行中发现需要新增任务,追加到对应阶段末尾
- 如果某个任务不再需要,不要删除,而是在其后标注
~~已取消~~
第四步:收尾
- 所有任务完成后,将状态更新为
**状态**:已完成
- 向用户汇报完成情况
任务明细编写要求
- 每个任务必须以
- [ ] 开头(未完成)或 - [x] 开头(已完成)
- 任务描述必须具体、可验证,避免模糊表述
- 示例:不要写"优化数据库",而写"为 users 表的 email 字段添加索引"
- 按执行顺序和依赖关系分阶段组织
- 每个阶段内的任务应尽量独立,可并行执行