用途
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)。迭代流程同样遵循严格的逐步确认原则,每个受影响阶段的文档必须逐一经用户确认。
关于收费、价格、平台支持情况等具体信息暂未提供。