SuperAPI AI 工具集

dev-workflow

编程与开发

查看项目

更新于 10-16 08:52

技能介绍

用途

dev-workflow 是一个严格按顺序执行的开发工作流技能,将需求逐步转化为可交付的代码。每个阶段必须完成并经用户确认后才能进入下一阶段。适用于启动新项目、构建功能、实现需求,或需要系统化开发流程的场景。

主要能力

工作流包含以下阶段:

  • 阶段 0:自检(每次调用必执行)——读取状态文件,确定当前阶段。
  • 阶段 1:初始化 & 捕获需求——创建状态文件和文档目录,提取或澄清需求,生成需求文档。
  • 阶段 2:设计稿——收集、生成或记录设计稿,可跳过。
  • 阶段 3:需求拆解文档——结合需求文档和设计稿进行功能拆解。
  • 阶段 4:生成技术方案——提供至少 2 个并列方案供用户选择。
  • 阶段 5:生成实现清单——将选定方案分解为有序任务。
  • 阶段 6:编码执行——在 06-code/ 目录下按顺序逐个执行任务。
  • 迭代机制——对已有代码的任何修改(包括 bug 修复、小幅调整、配置变更等)均须走迭代流程。

核心原则:任何阶段在上一个阶段经用户确认之前都不能开始。

使用方式

技能通过状态文件 .dwf/state.json 追踪工作流状态,每次调用时首先读取此文件以确定当前阶段。状态值包括:init、requirements、design、breakdown、plans、todos、code、done、iteration。

文档目录存储在工作区根目录下,包括:01-需求文档/、02-设计稿/、03-需求拆解文档/、04-技术方案/、05-实现清单/、06-code/、07-需求迭代/。

每个需要用户确认的步骤必须使用 question 工具进行交互,不得仅用纯文本询问。

适用场景

  • 启动新项目
  • 构建新功能
  • 实现具体需求
  • 需要系统化、分阶段推进的开发流程
  • 对已有项目进行功能增删改、bug 修复、重构、性能优化等迭代

限制与约束

  • 永不跳过阶段:用户要求"直接写代码"或"只是小 bug"不是跳过流程的理由。
  • 永不自动推进:每个阶段转换都必须经用户确认。
  • 永不直接修改代码:项目已有代码时,任何修改必须通过迭代流程。
  • 技术方案必须提供至少 2 个方案。
  • 启动新项目必须二次确认后才能删除任何文件。
  • 全程使用中文输出(代码、文件路径、技术术语除外)。

编程规范与模板

编码相关阶段必须读取并遵循 references/coding_standards.md。从零创建且技术方案选择 React 前端时,优先使用 assets/ 中的模板(react-pc/、react-mobile/、shared/)作为 06-code/ 的基础。

迭代机制

迭代目录命名为 {date}-{type}-{描述},type 采用 conventional-commit 风格前缀(feat、bugfix、refactor、perf、style、docs、chore)。迭代流程同样遵循严格的逐步确认原则,每个受影响阶段的文档必须逐一经用户确认。

关于收费、价格、平台支持情况等具体信息暂未提供。