把 AI 生成的代码变成可交付的产品
Agent-Dev 管理从需求到生产的完整生命周期。用户负责产品决策，Agent-Dev 负责把决定转化成可发布、可验证、可维护的工程系统。
Golden Path
从需求到交付报告的完整链路
- 需求
自然语言描述目标与范围
- 决策澄清
仅对真实不确定决策提问
- 规格
验收标准与实施任务
- Codex 实现
隔离 worktree 中执行
- 本地验证
lint / typecheck / unit / build
- PR
创建 PR 与质量门禁
- Vercel API Preview
API 先部署
- Cloudflare Pages Preview
前端获得 API URL 后部署
- 联合冒烟测试
CORS / Auth / 环境变量验证
- 人工验收
Preview Gate 通过
- 交付报告
证据链与残余风险
为什么是 Agent-Dev
不是更快的代码生成器，而是对完整交付负责
用户拥有
代码、仓库、数据、域名、云资源和 Blueprint 归用户所有。退出 Agent-Dev 后，产品仍可独立构建、部署和维护。
中立可迁移
模型和供应商均可替换。不绑定特定 Agent Runtime 或云平台，更换数据库或部署供应商是受控迁移而非设置修改。
真实 Gate
大模型可以提出方案，但不能通过 Prompt 获得生产权限。确定性 Policy、GitHub Rulesets、Environment Approval 是最终约束。
证据链交付
交付状态以 GitHub Checks、Deployment Records、Preview URL、数据库状态、冒烟测试和人工验收为准，而非 Agent 的自然语言总结。
与相邻产品对比
Agent-Dev 不与平台比谁生成页面更快
| 维度 | Agent-Dev | Replit Agent | Lovable | GitHub Spec Kit |
|---|---|---|---|---|
| 管理单位 | 产品生命周期 | 单次会话 | 单次生成 | 规格与任务 |
| 用户拥有资源 | 是，自有 GitHub/云 | 否，Replit 托管 | 部分 | 是 |
| Agent 可替换 | 是 | 否 | 否 | 部分 |
| Provider 可迁移 | 是，受控迁移 | 否 | 否 | 不涉及 |
| 生产权限 | Policy + 人工 Gate | 平台托管 | 平台托管 | 人工 Gate |
| 交付证据 | 外部事实链 | 平台日志 | Preview | 任务状态 |
| 长期维护 | 漂移检测 + 修复策略 | 有限 | 有限 | 不涉及 |
责任边界
透明划分用户与平台的职责，建立信任
用户负责
- →产品服务谁、解决什么问题
- →功能范围、体验、审美与业务优先级
- →成本、隐私、数据和外部影响决策
- →Preview 体验验收
- →生产发布与最终 Approval
Agent-Dev 负责
- →提供经过验证的产品 Blueprint 和默认规范
- →把需求转成规格、验收标准和实施任务
- →调用可替换的 Agent Runtime 实现、测试和修复代码
- →编排 GitHub、Supabase、Cloudflare、Vercel 等平台
- →执行确定性 Policy，限制 Agent 权限
- →聚合真实 CI、部署、测试和人工验收证据
- →识别漂移、过期配置和维护任务
- →给出明确的交付状态和残余风险
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 和供应商权限是最终约束。自治能力按项目和动作逐步提升，不存在一个不区分风险的全自动开关。
如何判断交付是否真的完成？
交付状态以 GitHub Checks、Deployment Records、Preview URL、数据库状态、冒烟测试和人工验收为准，而不是 Agent 的自然语言总结。未执行的验证不得标记为通过。
Agent-Dev 与 Replit Agent / Lovable 有什么区别？
Replit Agent 和 Lovable 侧重对话式生成与一键上线，资源由平台托管。Agent-Dev 管理的最小单位是产品生命周期，使用用户自有的 GitHub/云资源，Agent 和 Provider 可替换，并对完整交付和长期维护负责。
首版支持哪些技术栈？
首版固定 Web SaaS Golden Path：React + Vite + TypeScript 前端、Hono API、Supabase 数据库与认证、Cloudflare Pages 托管前端、Vercel Functions 托管 API、GitHub Actions 做 CI、本地 Codex 作为 Agent Runtime。