把 AI 生成的代码变成已上线的产品
Agent-Dev 管理从需求到生产的完整生命周期。四个真实项目已通过真实云端全链路交付上线，代码、云资源和域名全部归你所有。
Golden Path
从需求到交付报告的完整链路
- 需求
自然语言描述目标与范围
- 决策澄清
仅对真实不确定决策提问
- Blueprint
生成结构化产品规格与验收标准
- 资源归属
确认 GitHub/云平台归属，具名审批
- Local Apply
隔离工作区生成工程基线与 Git 初始化
- 质量门禁
lint / typecheck / unit / build 真实执行
- Feature Task
定义功能目标与边界，人工批准后执行
- Agent 实现
可替换 Runtime（Codex/OpenCode）在沙箱中编码
- PR + CI
平台推送并开 PR，GitHub Actions 质量门禁
- Dual Preview
Vercel API + Cloudflare Pages 联合部署
- 生产发布
从生产分支 checkout，两道人工闸门后发布
- 交付报告
证据链、观测值与残余风险汇总
为什么是 Agent-Dev
不是更快的代码生成器，而是对完整交付负责
用户拥有
代码、仓库、数据、域名、云资源和 Blueprint 归用户所有。四个真实项目已验证：退出 Agent-Dev 后产品仍可独立构建、部署和维护。
六类产品模板
Web SaaS、落地页、浏览器插件（MV3）、桌面端（Tauri/Electron）、移动端（Expo）和 MCP Server，每类生成物都通过本地与真实 GitHub Actions 质量门禁。
真实 Gate
大模型可以提出方案，但不能通过 Prompt 获得生产权限。生产发布为两道人工闸门（请求 + 具名批准），从生产分支 checkout 后发布。
证据链交付
交付状态以 GitHub Checks、Deployment Records、Preview URL、冒烟测试和真实观测值为准，而非 Agent 的自然语言总结。未执行的验证不得标记通过。
与相邻产品对比
Agent-Dev 不与平台比谁生成页面更快
| 维度 | Agent-Dev | Replit Agent | Lovable | GitHub Spec Kit |
|---|---|---|---|---|
| 管理单位 | 产品生命周期 | 单次会话 | 单次生成 | 规格与任务 |
| 用户拥有资源 | 是，自有 GitHub/云 | 否，Replit 托管 | 部分 | 是 |
| Agent 可替换 | 是，6 种 Runtime | 否 | 否 | 部分 |
| 产品类型 | 六类真实模板 | Web 应用 | Web 应用 | 不涉及 |
| Provider 可迁移 | 是，受控迁移 | 否 | 否 | 不涉及 |
| 生产权限 | Policy + 两道人工 Gate | 平台托管 | 平台托管 | 人工 Gate |
| 交付证据 | 外部事实链 + 观测值 | 平台日志 | Preview | 任务状态 |
| 长期维护 | 证据留存 + 产物漂移校验 | 有限 | 有限 | 不涉及 |
责任边界
透明划分用户与平台的职责，建立信任
用户负责
- →产品服务谁、解决什么问题
- →功能范围、体验、审美与业务优先级
- →成本、隐私、数据和外部影响决策
- →Preview 体验验收
- →生产发布与最终 Approval
Agent-Dev 负责
- →提供六类经过验证的产品 Blueprint 和默认规范
- →把需求转成结构化 Blueprint、验收标准和 Feature Task
- →调用可替换的 Agent Runtime（Codex/OpenCode/Claude 等）实现、测试和修复代码
- →编排 GitHub、Vercel、Cloudflare 真实 Provider，Supabase 走引导式手动接入
- →管理凭证与环境变量，Secret 不返回 API、不写入数据库
- →执行确定性 Policy，限制 Agent 权限与生产访问
- →编排 Dual Preview 部署与联合冒烟测试
- →聚合真实 CI、部署、测试和人工验收证据，记录观测值
- →校验 workspace 产物漂移，识别过期配置和维护任务
- →给出明确的交付状态和残余风险
Agent-Dev 可以保证流程和证据完整，不能保证产品获得市场成功。
产品宪法摘录
约束平台行为的核心原则
默认优于选择
新手模式替用户决定约 90% 的工程问题，只询问会改变产品、成本、隐私或风险的事项。候选项是逃生口，不是默认体验。
AI 推理，Policy 授权
大模型可以提出方案，但不能通过 Prompt 获得生产权限。确定性 Policy 与供应商权限是最终约束。
外部事实高于 Agent 自述
交付状态以 GitHub Checks、Deployment Records、Preview URL 和冒烟测试为准，而非 Agent 的自然语言总结。
用户拥有产品
代码、仓库、数据、域名、云资源和 Blueprint 归用户所有。模型和供应商均可替换。
常见问题
关于所有权、安全与自动化的关键问题
Agent-Dev 是什么？
Agent-Dev 是 Agentic Product Delivery Platform（AI Agent 驱动的产品工程与交付控制平台）。它不是 Codex 或 Claude Code 的替代品，也不是仅生成源码的应用构建器，而是管理从需求到生产的完整产品生命周期。
我的代码和云资源归谁所有？
代码、仓库、数据、域名、云资源和 Blueprint 全部归用户所有。退出 Agent-Dev 后，产品仍可独立构建、部署和维护。模型和供应商均可替换。
Agent-Dev 如何控制 AI 的生产权限？
大模型可以提出方案，但不能通过 Prompt 获得生产权限。确定性 Policy、GitHub Rulesets、Environment Approval 和供应商权限是最终约束。生产发布为两道人工闸门（请求 + 具名批准），从记录仓库的生产分支 checkout 后发布。自治能力按项目和动作逐步提升，不存在一个不区分风险的全自动开关。
如何判断交付是否真的完成？
交付状态以 GitHub Checks、Deployment Records、Preview URL、数据库状态、冒烟测试和人工验收为准，而不是 Agent 的自然语言总结。Evidence 记录的是真实观测值（HTTP 状态、content-type、实测 CORS 响应头），而非 passed 这类判定常量。未执行的验证不得标记为通过。
Agent-Dev 与 Replit Agent / Lovable 有什么区别？
Replit Agent 和 Lovable 侧重对话式生成与一键上线，资源由平台托管。Agent-Dev 管理的最小单位是产品生命周期，使用用户自有的 GitHub/云资源，Agent 和 Provider 可替换，并对完整交付和长期维护负责。
首版支持哪些技术栈？
Web SaaS Golden Path 固定为：React + Vite + TypeScript 前端、Hono API、Cloudflare Pages 托管前端、Vercel Functions 托管 API、GitHub Actions 做 CI；数据库与认证使用 Supabase，走引导式手动接入。Agent Runtime 运行在你自己的电脑上，可在 Codex、OpenCode、Claude Code、Aider 等已安装的 coding agent 中选择。
支持哪些产品形态？
六种产品类型均已生成真实可构建的工程模板：Web SaaS、落地页、浏览器插件（MV3）、桌面端（Tauri v2 / Electron 双 shell）、移动端（Expo SDK 52）和 MCP Server。每类生成物都通过本地质量门禁，且生成的 GitHub Actions 工作流已在真实 CI 上验证全绿。Web SaaS 走完整云端交付链路；其余类型按设计交付本地可构建产物，签名、公证与商店提交为人工步骤。
有真实交付案例吗？
四个真实项目已通过完整云端链路交付上线：Receipt Test（收据管理页面）、Workspace Verify Fresh（API 版本端点）、Link Vault（链接保存 API + 页面）、MCP Word Tools（MCP 服务器，首个非 web-saas 类型交付）。每个项目都走完 Blueprint → Preview → Production 全周期，PR 经 GitHub Actions 质量门禁后合并，生产 API 与页面均对外可访问，并在平台报告之外独立复验。四轮真实验证共修掉 29 个真实缺陷。
Agent-Dev 现在可以怎么运行？
v0.2 是 local-first 的本地应用，不是托管 SaaS：控制面跑在你自己的电脑上，直接复用你已登录的 GitHub、Vercel、Cloudflare CLI 和本机 coding agent。当前仍处于 v0.2 实验阶段，核心交付链路已在真实云端验证通过，但尚未作为可用于生产的稳定版本发布。