Community生产力与协作github.com

aitormf/agent-skills

将一个已批准的技术方案拆分为依赖有序的小任务,标明影响文件、每项验证和并行分组。当有了方案并需要将其分解为任务或准备实施时使用。

agent-skills 是什么?

本技能(`agent-skills`)的核心功能是将一个已批准的技术方案或规范自动拆解为一组可执行的小任务,并以Markdown清单的形式组织,供实施代理按步骤执行并勾选完成。它特别适合在有明确方案(如`plan.md`和`spec.md`)且需将其转化为结构化任务列表时使用。该技能会检查方案状态是否为“已批准”,否则会提示先行审查或确认。它强制按依赖关系排序任务,用`[P]`标记可并行工作,并为每个任务列出影响的文件及验证方式(如特定测试或检查命令)。若项目采用TDD,则确保测试先于代码。此外,它要求包含一个“收尾”阶段以确保验收准则全部通过测试且验证命令绿灯。该技能适用于Claude Code、Cursor、Codex等支持Markdown任务列表的AI辅助开发环境,最终生成一个`docs/specs/<日期>-<类型>-<名称>/tasks.md`文件,建议实施时联动`implement`代理。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aitormf/agent-skills/tree/HEAD/skills/plan-to-tasks

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

从方案到任务

将方案转换为implement代理可以遵循并勾选的、可执行的任务列表。

  • 每个工作项位于 docs/specs/<YYYYMMDD>-<类型>-<名称>/。
  • tasks.md 没有状态:其进度由 [x] 复选框体现。

开始之前

  1. 确定工作项,并阅读 plan.md 和 spec.md。

  2. 门控: 如果方案不具有 status: approved,则停止并询问:

    方案的状态是 <status>。我是否继续,还是先用 review-spec 审查,或者您现在批准它?

    仅当得到明确回答后才继续。对于没有方案的小变更,门控适用于规范。

  3. 阅读 AGENTS.md 中“Commands”(西班牙语项目中为“Comandos”)部分的验证命令。如果没有,则询问它是什么,或者在收尾任务中留下警告。

如何拆分

  • 小任务:每个任务都是一次可审查的变更,且项目保持绿色状态。
  • 按依赖关系排序。用 [P] 标记那些可以与上一个任务并行完成的任务。
  • 每个任务列出其影响的文件(如果知道的话),以及如何验证:哪个测试,或哪个命令。
  • 如果项目采用 TDD(CONTRIBUTING.md 或 AGENTS.md 会说明),则测试应放在代码之前或同一任务中,绝不能放在末尾。
  • 必须至少用一个任务覆盖规范的每一个验收准则以及来自安全团队的每个负向测试。如果某个准则未被覆盖,请明确指出。
  • 收尾阶段是强制的:验收准则通过测试,并且验证命令绿灯。
  • 不要添加方案中没有的工作。如果方案中缺少某些内容,请作为问题提出。

结果

  1. 从 assets/tasks-template.md 草拟 tasks.md。
  2. 展示草稿,包括:
    • 任务;
    • 并行分组;
    • 验证点;
    • 任何遗留的问题。
  3. 只有获得批准后才写入文件。
  4. 建议的下一步:使用 implement 代理来实施。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能