关于 task
面向编码 Agent 的规划阶段技能，将需求整理为待审阅的任务文档和跟踪记录。它在实现前明确范围、任务协调、待决事项、操作步骤及可验证的验收标准。
主要功能
- 01按项目模板创建任务文档
- 02检查与其他任务的协调情况
- 03记录阻塞及非阻塞决策
- 04定义可验证的验收标准
- 05将任务加入 Planned
适用场景
- 01为实现阶段准备功能需求
- 02发现与进行中任务的冲突
- 03编码前明确检查项和操作步骤
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/task确认已加载。
附带文件templates/task-document.mdtemplates/tasks-tracking.md
详细介绍
task - 规划阶段
不变量
- 仅创建或更新任务文档。
- 不要实现代码。
- 规划阶段不要启动自动化。
- 更新
TASKS.md后即停止，并告知用户任务已准备好供其审阅。 - 将任务添加到
Planned后，重新读取TASKS.md，确认其中包含该条目后再交接。 - 绝不要更改已被认领或处于
In Progress状态的任务范围（例如存在工作分支、已打开 PR，或跟踪器显示该状态）。将新发现放入新任务并引用原任务，同时告知用户联系负责原任务的 Agent。编辑已被认领的文档，无法传达给已经读过该文档的 Agent。
运行时适配器可以将此阶段呈现为斜杠命令、菜单操作或自然语言技能调用。该阶段的通用名称是 task。
工作流
- 阅读
AGENTS.md。 - 如果
LEARNINGS.md存在，则阅读它。 - 仅在缺失信息会影响范围、风险或验收标准时，澄清请求。
- 针对与任务直接相关的文件，开展有针对性的代码库调查。
- 协调检查。 列出此任务将更改的文件，然后阅读其他
Planned和In Progress任务文档（以及项目使用的开放工作分支或 PR）。在Coordination中记录所有重叠，注明共享文件和其他任务；如果两个任务会编辑同一文件，则添加顺序规则（“在 {ID} 合并后再合并”）。 - 待决事项。 将只有用户才能决定的事项放入
Open Decisions，标记为BLOCKING（不得开始实现）或NON-BLOCKING（注明默认选项）。不要将决策隐藏在说明文字中。 - 运维步骤。 如果合并更改本身并不会应用更改（例如迁移、单独部署组件的部署、配置、数据回填），则在
Operator Steps中列出这些步骤。对于部署，列出所有受影响的可部署组件，包括仅 导入 已更改共享模块的组件，并说明如何确定这些组件。 - 选择建议的执行层级。
- 根据模板创建或更新
docs/task/{ID}-{task-name}.md（参见 Templates）。 - 在
TASKS.md的Planned下添加或更新任务。 - 停下来等待用户审阅和批准。
模板
如果项目中存在 docs/templates/task-document.md 和 docs/templates/tasks-tracking.md，则使用它们。否则，使用此技能附带的副本（位于本文件旁的 templates/ 目录中）。如果项目现有任务文档采用不同格式，则沿用该格式，但必须保留以下必需章节。
执行层级指南
在任务文档中使用 Recommended Tier：
| 层级 | 适用情况 |
|---|---|
fast | 规模小、风险低，且遵循现有模式的更改。 |
balanced | 常规功能开发、中等规模重构，或涉及多个文件的更改。 |
deep | 架构、安全、数据模型、迁移、高风险重构或需求含糊的工作。 |
该层级为下游 Agent 提供指导。运行时适配器决定层级如何（或是否）映射到模型或推理设置。
任务文档要求
任务文档必须包含：
- 清晰的概述和要求
- 明确的范围外事项或不得更改的边界
- 拟议的文件变更
- 实现阶段应阅读文件的精简代码上下文
- 实现步骤
- 验收标准
- 验证命令或方法
Coordination（重叠的任务和文件，或“未发现”）Open Decisions（每项标注为BLOCKING或NON-BLOCKING，或“无”）Operator Steps（或“无需操作：合并即可”）- 相关时，说明与打包、文档、适配器或安装界面的兼容性关联点
验收标准必须是检查项，而非描述性文字。 每项都要指出用于验证的命令、查询、API 调用或浏览器操作、预期结果，以及检查在合并前还是部署后运行。至少包含一项针对不得改变行为的无回归检查。没有可能失败的检查项，之后就不能声称满足了该标准；如果无法自动化，请标注为 manual，并说明原因。
如果任务来自正在进行的调查，请附上证据（查询、记录 ID、数量、file:line），以便实现 Agent 能够重新验证，而非仅凭描述采信。
在 Code Context 中嵌入简洁的代码摘录或说明；不要粘贴整份无关文件。
TASKS.md 更新
如果 TASKS.md 不存在，请根据跟踪模板创建（见 Templates）。
如果文件已存在，请沿用其中现有的章节和列，即使它们与模板不同。将任务添加到 Planned（或项目中的等效部分），例如：
| {ID} | {Task} | {Priority} | {Type} | docs/task/{ID}-{task-name}.md | {Date} |
如果任务存在 BLOCKING 的开放决策，请在该行注明（“⚠️ 实现前需要解决决策 D1”）。
交接
结尾使用：
Task planned: docs/task/{ID}-{task-name}.md
Status: awaiting user review
Blocking decisions: {list or "None"}
Coordinates with: {task IDs or "None"}
Next stage after approval: implement {ID}