关于 to-tasks
to-tasks 是用于根据已确定的变更集记录工作的开发技能。它为获授权的跟踪器准备任务并核验发布结果,同时将实现与任务记录分开。
主要功能
- 01选择已配置的跟踪器
- 02将工作拆分为适当任务
- 03跟踪任务依赖关系
- 04发布前暂存任务
- 05核验已发布的任务记录
适用场景
- 01将已批准的变更集转为任务
- 02把大型工作拆为可验证任务
- 03在任务跟踪器中记录依赖
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ venhdev/ skills --skill to-tasks安装后在 Claude Code 中输入/to-tasks确认已加载。
附带文件references/issue-tracker-local.mdreferences/task-template.md
详细介绍
to-tasks — 任务记录与条件拆分
操作不变量
- 记录范围:仅发布任务定义和跟踪元数据;不得改动生产代码,并保留提供的方向。
- 跟踪器选择:仅使用已配置的跟踪器;未配置时默认使用本地 Markdown,不得同时发布到多个跟踪器。
- 授权边界:在写入文件或远程问题前,先准备好具体任务和目标位置。遵守现有的发布授权;发布任务绝不代表获得实施授权。
领域准则
输入与任务规模
接收已确定的变更集、结果、验收标准、约束和佐证/参考资料。小型工作记录为一个任务。仅当可独立验证的切片、依赖关系或独立执行会话能让跟踪更有用时,才拆分中型或大型工作;任务数量不是目标。
每个拆分任务都应交付一项完整的纵向能力,并负责相应的变更集。确保依赖关系无环。仅在必要时进行前置重构;对于大范围迁移,应遵循扩展/迁移/收缩的顺序,而非任意划分横向层。
跟踪器与持久化
准备任务前,先阅读 .agents/task-tracker.md,以确定目标位置和其原生操作。若文件不存在,则将本地任务放在 .agents/tasks/<feature-slug>/ 下,并通过复制 references/issue-tracker-local.md 来创建 .agents/task-tracker.md;仅在获得发布授权后写入该配置。已有的远程配置优先于默认设置;无法访问远程服务属于阻塞事项,不代表可以在不说明的情况下切换跟踪器。
存储的任务中使用相对于仓库根目录的 POSIX 路径。本地任务按依赖顺序使用 <NN>-<slug>.md;远程任务使用原生依赖关系或明确的 Blocked by ID。完成前,重新读取已发布的任务,以核验内容、标识符和依赖关系。
状态与任务生命周期
STAGED:任务定义、数量、依赖关系和目标位置均可供审查;待发布。DONE:任务已发布,且已核验其存在及内容;实施仍待进行。UNRESOLVED:输入、跟踪器访问或发布方面存在阻碍,无法可靠地记录;报告任何部分发布的内容及其标识符。
已存储的实施任务保留 ready、in-progress 和 done 状态。只有状态为 ready 且所有前置任务均为 done 时,任务才符合执行条件;阻塞状态由此推导,不作为持久化的生命周期状态。即使本技能报告 DONE,已发布的任务仍保持 ready。
规范输出约定
# Task Recording: <Feature> · <STAGED | DONE | UNRESOLVED>
Tracker: <Configured destination or local default.>
| Task | Scope / Acceptance | Blocked by | Destination |
| :--- | :--- | :--- | :--- |
| <ID> | <Complete deliverable and criterion> | <IDs or None> | <Path or issue link> |
<Why splitting is useful; omit when one task suffices.>
Gap: <Blocker or partial publication; omit if none.>
准备任务正文时,请阅读 references/task-template.md;将每个任务的变更集嵌入其中,并保留证据/约束以供后续执行。
路由
- 输入的变更集存在尚未解决的要求 →(通过 /clarify)。
- 输入方向已过时或需要重新设计 →(通过 /architect-decision)。
- 调用方请求实施符合条件且获得单独授权的任务 →(通过 /forge)。
执行协议
- 将输入的变更集与当前上下文进行核对。如果方向已过时或尚未明确,报告差异,而不是凭空创建任务。
- 确定跟踪器,保留一个任务或拆分出有用的切片,并提交
STAGED。除非具体任务范围和目标位置已获授权,否则在发布前停止。 - 通过已配置的操作发布,核验存储的记录,并报告
DONE或UNRESOLVED。发布即完成记录请求;实施仍需单独授权。