项目 / 2026/05/11

查看公开仓库

Dev_Agent_OPC

面向 AI Coding Agent 的本地可验证交付工作流,把产品定义、设计资产、实现、测试、审查、PDCA 和发布门禁收敛到同一个可恢复的流程里。

Dev_Agent_OPC 项目截图

Dev_Agent_OPC 是我为 AI Coding Agent 工作方式整理的一套本地交付流程框架。它不是单纯的提示词集合,而是一个能落到本地项目里的交付控制层:让 Agent 按阶段推进、按产物交接、按证据验收。

它把产品定义、Agent 流程设计、技术规格、UI 设计、实现、测试、审查和发布收敛到同一个可恢复、可验证、可交接的工作流中。这样 Agent 不只是写代码,而是围绕明确产物和质量门禁持续推进。

项目定位

我在使用 Coding Agent 的过程中越来越明显地感受到:真正困难的不是让模型生成代码,而是让任务能被恢复、被验证、被交接。

Dev_Agent_OPC 的核心做法是把运行项目放在 work/<project-name>/ 下,根目录保持干净;可复用工作流放在 agent-skills/bin/dev-flow 负责项目状态、阶段检查、UI 质量门禁、PDCA 交接和适配器打包。

对于需要精美界面或完整交付物的任务,流程会要求先完成参考、设计图、视觉规范和正式设计资产,再进入开发和验证。

交付流程

当前 README 中的主流程覆盖:

  • idea:聚焦想法和目标。
  • pm:整理 PRD、用户故事、指标和验收标准。
  • agent:定义工具、权限、提示词、恢复机制和评估方式。
  • spec:沉淀可构建的产品和技术规格。
  • design / figma-design:形成视觉系统、屏幕验收标准和正式设计资产。
  • plan:拆成小粒度、可验证的实现任务。
  • build:实现并保留证据。
  • test:记录测试、回归和验证结果。
  • review:做结构化质量审查。
  • ship:输出发布说明、go/no-go 和回滚计划。

UI 与质量门禁

这个项目对 UI 任务的要求比较重:面向用户的界面不能直接从运行态截图或临时 HTML 开始实现,而需要先有 approved design assets。正式设计资产可以来自 imagegen / GPT Image 的 raster 或 PDF 输出、Figma、设计师上传文件,或带来源证据的外部设计工具。

如果使用 imagegen / GPT Image 做正式设计图,还需要同步生成 HTML 语义描述,帮助后续 Figma 或开发理解布局、组件、状态和视觉规则。实现前还需要把界面、设计来源、切图资产和测试证据写进实现追踪记录。

适配方式

仓库支持把流程适配到 codexclaude-codegeminiopenclawopencode 等 Agent 环境。可以临时让模型读取 AGENTS.mdDEV_FLOW.md 和相关 agent-skills/ 文件,也可以通过 bin/dev-flow install <host> --scope user 安装成可复用工作流。

适用场景

  • 用 AI Coding Agent 完成可交付项目,而不只是生成代码片段。
  • 需要保留需求、计划、设计、实现、测试、审查和发布证据。
  • 需要让多个阶段或多个角色的产物有稳定边界。
  • 需要把一次性的 prompt 变成可以复用、迁移和审查的工作流。
  • 需要对 UI 质量、PDCA、回滚和发布门禁有明确要求。

公开仓库:https://github.com/KevinKE93/Dev_Agent_OPC