SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场devdocs-dev-workflow

devdocs-dev-workflow

编程与开发

查看项目

更新于 10-15 08:13

技能介绍

用途

devdocs-dev-workflow 是一个开发任务执行工作流指导技能，用于在已有任务文档的基础上执行开发任务。它采用自顶向下（骨架优先）开发模式和分层 TDD，支持单任务与批量执行，并可与 devdocs 系列技能协作完成从任务到提交的完整闭环。

模式选择

入口处根据任务规模选择开发模式：

  • 轻量：适用于 Bug fix、小改动、配置变更，路由到 /devdocs-bugfix。
  • 标准：适用于新功能、需求变更，走完整 Requirements→Design→Tests→Tasks→Dev 流程。
  • 探索：适用于原型、技术调研，允许跳过部分验证，事后用 /devdocs-retrofit 补文档。

模式判断指引：任务来自 devdocs-dev-tasks（已有完整文档链）走标准模式；用户描述为 bug/hotfix/配置变更走轻量模式；描述为原型/调研/探索/spike 走探索模式。

触发条件

用户开始执行某个任务（如 T-01）、批量执行任务（如 T-01~T-05、F-001、--all）、需要继续开发（断点续做）、需要开发指导，或从 devdocs-dev-tasks 进入开发阶段。关键词包括“开发任务”“执行任务”“开始 T-XX”“批量开发”“继续开发”。

运行模式

  • 单任务：T-03，执行单个任务。
  • 范围：T-01~T-05，执行范围内所有任务。
  • 枚举：T-01,T-03,T-07，执行指定任务列表。
  • 功能点：F-001，通过关联需求字段反查所有关联任务。
  • 用户故事：US-001，同上。
  • 全部：--all，所有状态≠已完成的任务。
  • 无人值守：--headless，批量模式 + 全自动决策（fail-fast）。
  • 自动提交：--auto-commit，测试通过自动提交，仅 Blocker 时暂停（与 --headless 互斥）。

前置条件

任务文档 docs/devdocs/04-dev-tasks.md 已定义任务，并包含关联需求、验收标准、测试方法。

工作流程（标准模式）

  1. 读取任务定义：从 04-dev-tasks.md 获取任务详情，确认关联的 F-XXX、AC-XXX 及测试用例 UT/IT/E2E-XXX。
  2. 生成骨架代码（自顶向下）：接口骨架 + @requirement/@satisfies 标注；测试骨架 + @verifies/@testcase 标注。
  3. 执行开发：所有层级遵循统一 11 步流程，层级标记（🔴🟡🟢⚪）决定各步骤强制程度。
  4. 完成检查：基础检查（验收标准全部满足、测试通过、Review 要点自查）；前置验证（--review 触发时，对抗式验证之前，运行 /devdocs-verify --impl 与 /devdocs-verify --ui）；对抗式验证（🔴自动触发 / 其他层级 --review 手动触发），包含代码质量审查、测试完备性审查、综合审查报告。 4.5 更新自描述（/code-self-describe --update）。
  5. 提交代码（Commit 1: 代码，遵循 /commit-convention）。
  6. 更新追溯 + 文档提交（/devdocs-sync → Commit 2: 文档）。 6.5 更新 AGENTS.md“当前状态”（若存在）。
  7. [推荐] 知识沉淀（/devdocs-compound），批量模式完成后默认执行。

代码追溯标注

标注类型：@requirement F-XXX（关联功能点，接口/类/模块）、@satisfies AC-XXX（满足的验收标准，接口/方法）、@verifies AC-XXX（验证的验收标准，测试用例）、@testcase UT/IT/E2E-XXX（测试编号，测试用例）。公共接口与测试文件为必须标注，内部实现复杂逻辑可选。

自顶向下开发模式

先定义骨架，后填充细节：生成接口骨架（方法签名、追溯标注、未实现方法抛 Error）→ 生成测试骨架（测试结构、@verifies/@testcase 标注、skip/todo 标记）→ 实现接口细节 → 完善测试 → 运行 /devdocs-sync 更新追溯矩阵。

分层 TDD

所有层级遵循统一 11 步执行流程，层级标记仅决定强制程度：核心逻辑（🔴）全部 11 步强制；接口层（🟡）骨架/实现/绿/AC/自描述/提交强制；UI 层（🟢）骨架/实现/绿/AC/自描述/提交强制；基础设施（⚪）骨架/实现/绿/AC/自描述/提交强制。TDD 循环为红→绿→重构，红阶段断言必须来自 03-test-*.md 中对应 AC 的测试用例，禁止从实现代码反推测试。

编排与协作

dev-workflow 调用 /devdocs-verify --impl、/devdocs-verify --ui、/devdocs-sync、/devdocs-compound、/devdocs-test-run 时，必须通过 Task tool 启动子 Agent，遵循上下文隔离、摘要传递、异常回退、不自行排障原则。协作技能包括 /code-quality、/testing-guide、/ui-orchestrator、/code-self-describe、/git-safety、/commit-convention、/devdocs-dev-tasks、/devdocs-sync、/devdocs-compound、/devdocs-test-run。

约束要点

骨架生成、分层 TDD、完成检查、对抗式验证、依赖解析、原子提交、断点续做、--auto-commit、记忆文件同步、全量测试验证、无人值守等均有明确约束。例如：循环依赖必须报错终止；每个任务独立提交，代码与文档提交分离；--headless 下工作区必须洁净、绝不推送远程；批量模式完成后必须调用 /devdocs-test-run --trace。

提交信息格式

<type>(T-XX): <任务名称>，正文列出完成内容，并注明关联 F-XXX、AC-XXX 与测试 UT-XXX、IT-XXX 通过。type 类型：feat | fix | refactor | test | docs | chore。

子 Agent 摘要格式

返回结构化摘要，包含 skill、task、status、commits（code/docs）、test_summary（passed/failed/coverage）、blockers_resolved、suggestions_skipped、ac_verified、next_task。

参考资料

skeleton-examples.md、execution-flow.md、verification-flow.md、task-orchestration.md、auto-mode.md。

限制

本技能依赖 docs/devdocs/04-dev-tasks.md 等任务文档链；具体平台、收费、价格等信息暂未提供。