[控场AI]
· 6 分钟阅读· 3,185 字

DevWorkflow 5.0:用AI五步法从想法到上线

DevWorkflow 5.0:用AI五步法从想法到上线

DevWorkflow 5.0 用五条命令和五步流程,把 AI 编程搭档的自作主张空间压缩到零。

DevWorkflow 是一个 Claude Code 插件,5.0 版本为全面重写,适用于任何语言与技术栈,支持 GitHub、Azure DevOps、GitLab 等主流代码平台,面向个人开发者和小团队。它的核心原则是:项目按 issue 逐个推进,每个 issue 走固定五步流程;每个决定都先询问用户,agent 只提方案,未经确认的内容不会写入任何文件。文章以理发店在线预约网站为例,依次演示 kickoff 初始化、change 拆解需求、issue next 走完 architect 与 scaffold 等步骤、release 与 deploy production 上线,强调其价值在于把 AI 的自作主张空间压缩到零。

为什么你需要一个「不擅自行动」的AI编程搭档

让AI写代码,最怕什么?它自作主张加了你从没说过的表和字段;文档写的是A,代码做的是B;测试没写就直接合并进了主分支。这些痛点,几乎每个尝试用AI辅助开发的程序员都遇到过。

DevWorkflow 是一个 Claude Code 插件,专门解决这些问题。5.0 版本是一次全面重写,适用于任何语言、任何技术栈,支持 GitHub、Azure DevOps、GitLab、Bitbucket、Gitea 和 Forgejo,面向个人开发者和小团队。

它的核心逻辑只有两条:

  1. 项目一个 issue 一个 issue 地做,每个 issue 都走同样的五步流程。
  2. 每个决定都先问你——agent 提方案,你来选;你没回答过的东西,一个字也不会写进文件。

安装与初始化:两条命令,把决定权握在手里

安装只需要两条命令。下面用一个完整的例子从头做一遍:为一家理发店搭建在线预约网站(Bucket),顾客在网页上选理发师和时间,店员在后台管理预约。

理发店在线预约网站示例

第一条命令是 kickoff,它会一轮一轮地问你:项目简介、目标是什么、用户是谁、范围多大、支持手机还是电脑、团队会哪些技术、有没有要参考的旧系统,以及代码注释、文档、界面文字和 issue 各用什么语言(每一样都可以不同)。

接着问代码平台、仓库公开还是私有。它还会查你的账号套餐,如果套餐不能强制分支规则,它会讲清楚这意味着什么,再让你决定升不升级。你答完,它建好本地和远程仓库,把项目简介和版本号作为第一次提交推上去,再在平台上建好整套标签(issue 类型、大小、风险等级)和人工审批规则。

这时候你说出第一个功能需求:change 会先指出项目还没搭建,第一个 issue 必须是搭建项目。等它做完,再回来说这个功能。

change会先指出项目还没搭建

Claude Code 插件指的是运行在 Anthropic 官方命令行编程助手 Claude Code 之上的扩展机制。Claude Code 本身提供对话式代码编辑、命令执行与工具调用能力,插件(plugin)则允许第三方把自定义的命令、工作流规则、子 agent 和审批拦截逻辑注册进去,从而改变 agent 的默认行为。DevWorkflow 正是借助这一机制,把「每个决定先问用户」的约束固化为插件层的流程控制,而不是依赖提示词约束——这也是它比纯提示词方案更可控的原因。

搭建项目:13个步骤,每步都是选择题

运行 issue next,它先问一个问题:这一次运行里需要人工审批的 PR 由谁来批?接着进入 architect 步骤,搭建项目要走完整的 13 步:指标、组件、技术选型、构建工具和任务运行器、代码结构、部署目标、数据迁移、每个组件怎么运行、静态检查、测试、AI 审查和风险规则、依赖更新,最后是平台设置和 secret。

每一步都是选择题,选项里写清代价。比如选任务运行器时,选项会告诉你 make 在 Windows 上要另外安装;新建数据库时,选项里写着区域、规格和大概的月费。打完以后,它自己检查整个架构有没有矛盾和漏洞,然后写出架构文档,每个决定一份决策记录——考虑过哪些方案、为什么这样选、代价是什么、什么时候该重新考虑。

决策记录:考虑过哪些方案

然后是 scaffold 步骤。它用每个组件的官方设置生成器(最新版本)生成项目,并把每个版本号写死;装好任务运行器、git hooks、每一项检查和测试的 CI 任务,以及到 staging 的自动部署。仓库外的事——比如分支规则、平台应用、云资源和 secret——它先列给你,你确认了才动手。花钱的东西,事先告诉你多少钱。

**决策记录(ADR,Architecture Decision Record)**是一种轻量文档实践:每做一个重要的技术决策就留一份短记录,写明背景、考虑过的备选方案、最终选择和理由、以及该决策在什么条件下应被重新审视。ADR 通常与代码一起提交进仓库,形成可追溯的决策历史。它的价值在于,几个月后无论是作者本人还是新加入的成员,都能知道「为什么当初这样选」而不只是「现在是什么样」,也便于在条件变化时定位需要推翻的旧决定。

拆解需求:把功能拆成可验收的 issue

项目搭好了,再说一次在线预约需求。change 把用户能感觉到的功能拆开,列成一张表:每个 issue 的类型、大小、依赖,以及预计从哪一步开始有改动。你可以合并、再拆,直到你确认。每个 issue 都有目标、范围内、范围外和验收标准——验收标准写清楚怎样算做完,后面的测试就找它写,再运行 issue next。

ticoff留一条本步骤无改动的评论

五步依次走完。项目简介没变,ticoff 留一条「本步骤无改动」的评论;架构也没变,同样留言记录。下一步 design 步骤先问内容:哪些字段必填、怎么校验、出错提示是什么,然后把每个屏幕画成圆形渲染成图片,你一张一张确认。implement 步骤由主 agent 先把计划写在 issue 评论里,再由新的开发子 agent 一个工作单元一个工作单元地做。每条验收标准都有一个测试,开 PR 之前跑简化代码审查和安全审查。PR 打开后,每条 AI 审查意见都要处理,这是重风险;你审批以后它才合并。合并还不算完——部署到 staging、迁移跑完、冒烟测试通过,这个 issue 才算完成。

**验收标准(Acceptance Criteria)**是判断一个 issue 是否完成的客观依据,通常写成可逐条勾选的明确条件,例如「顾客可选择理发师后看到其可用时段」「未选时间时提交按钮不可用并给出提示」。它把模糊的需求转成可验证的断言,因此测试可以直接依据它来编写,评审时也能对照它判断是否真的做完。与验收标准配套的「范围内/范围外」则明确划定了本次改动的边界,防止需求蔓延。

发布上线:版本号从合并的PR标题里算出来

想发布了,运行 release。它从合并过的 PR 标题算出下一个版本(例子中是 0.1.0),通过一个发布 PR 打标签,再运行 deploy production,确认后上线。

一个想法,五条命令,从立项到上线,每个决定都是你做的。这套流程的价值不在于让 AI 替你写多少行代码,而在于把「自作主张」的空间压缩到零——agent 只在你划定的轨道上运行,所有岔路口都停下来等你选。对于个人开发者和小团队来说,这或许是目前让 AI 参与完整项目最可控的方式。下一集,需求开始变了——而这才是真实项目的常态。

**语义化版本(SemVer)**约定版本号形如 主版本.次版本.补丁版本:不兼容的破坏性改动升主版本,向下兼容的新功能升次版本,向下兼容的缺陷修复升补丁版本。当团队采用「约定式提交」规范时,PR 标题会带 feat:、fix:、feat!: 之类前缀,工具即可据此自动推算下一个版本号,避免人工判断出错。发布 PR 的作用是把版本号变更、变更日志等发布物料集中在一处评审合并,保证打标签时主分支状态与发布内容完全一致。

#DevWorkflow#Claude Code 插件#AI编程#AI辅助开发#开发工作流#issue驱动开发#自动化部署
分享:

相关推荐