SuperAPI AI 工具集

devdocs-dev-tasks

编程与开发

查看项目

更新于 10-15 08:12

技能介绍

用途

devdocs-dev-tasks 用于把系统设计分解为可执行、可追踪的开发任务,适合在用户已完成系统设计与测试用例、需要拆分开发任务、进行迭代或 Sprint 规划,或从 /devdocs-feature、/devdocs-bugfix、/devdocs-insights 产生增量需求时使用。

主要能力

  • 读取前置阶段文档并识别组件,将系统模块映射为任务。
  • 对每个任务进行 TDD 分层:🔴 核心逻辑(强制 TDD,红→绿→重构)、🟡 接口层(推荐 TDD,红→绿)、🟢 UI 层(可选 TDD,实现→验证→补测试)、⚪ 基础设施(不适用 TDD,实现→集成测试验证)。
  • 定义任务依赖、评估任务粒度,并生成按层级分组(基础设施→核心逻辑→接口层→UI 层)的任务文档。
  • 每个任务遵循 TAR 原则:可测试(测试方法和预期结果)、可验收(具体可量化的完成标准)、可审查(Review 要点)。
  • 提供依赖关系图,支持任务编号(T-XX)与优先级(P0 阻塞、P1 重要、P2 次要)。
  • 支持增量任务管理:新增、插入、更新依赖与状态。
  • 文档拆分:任务超过 20 个、文档超过 300 行或涉及多个独立模块时,可拆分为 infra、core、api、test 等子文档;已完成任务归档到 04-dev-tasks-archive.md。
  • 上下文管理:按功能点(F-XXX)分批设计任务,以首个功能点任务列表为质量锚点,并进行一致性自检。

使用方式

  • 前置条件:需求文档 docs/devdocs/01-requirements.md、系统设计文档 docs/devdocs/02-system-design.md、测试用例文档 docs/devdocs/03-test-cases.md。
  • 运行模式:/devdocs-dev-tasks(标准模式,逐步确认);/devdocs-dev-tasks --fast(跳过逐步确认,直接生成,仅最终确认;使用合理默认值,默认行为不变,--fast 为 opt-in)。
  • 语言规则:支持中英文提问,统一中文回复,使用中文生成文档。
  • 输出主文件:docs/devdocs/04-dev-tasks.md。
  • 完成后可选将任务加载到 TodoWrite 追踪列表,并建议使用 /devdocs-dev-workflow 执行开发任务;文档变更较大时可运行 /agent-memory 同步记忆文件。
  • 协作技能:执行开发任务用 /devdocs-dev-workflow,同步文档状态用 /devdocs-sync,新增功能需求用 /devdocs-feature,修复 Bug 用 /devdocs-bugfix。

适用场景

  • 已完成系统设计与测试用例,需要把设计落地为具体开发任务。
  • 迭代或 Sprint 规划,需要明确任务依赖、优先级与粒度。
  • 增量功能、Bug 修复或改进建议的确认与任务追加。

限制

  • 本技能仅产出文档,严禁编写或生成任何实现代码、脚本或配置变更;Write 工具仅用于写入 docs/devdocs/ 下的 Markdown 文档,Bash 工具仅用于只读操作。
  • 编码实现由 /devdocs-dev-workflow 负责;直接写代码会缺少 @satisfies/@verifies 标注,导致 /devdocs-sync 无法自动追溯。
  • 单个任务必须在 4 小时内可完成,必须指定依赖并按依赖排序,不能有循环依赖,文件路径必须具体。
  • 每个任务必须关联功能点(F-XXX)、验收标准(AC-XXX)与测试用例(UT/IT/E2E-XXX),测试断言必须引用 AC,禁止从实现代码反推测试。
  • 参考资料:templates/task-template.md、templates/archive-rules.md。

该技能的收费、价格、平台等信息暂未提供。