快速开始

从一段产品需求描述出发，生成结构化 RPML 规格，发布首个 Release 版本并无缝接入编码 Agent。

本文将指引你完整走完 OriginAI 的核心研发闭环：构建产品上下文、在可视化工作台中调优、发布冻结版本，并指引外部编码 Agent 严格依据该版本实施代码。

准备工作

一个现代浏览器。
一个 OriginAI 账户——支持免费注册开启。
可选准备：一段简短的产品需求描述（Brief）或现有产品界面截图，用于快速起草初稿。

第一步：创建项目

根据你当前是否已登录，可以通过两种路径进入：

新用户 — 从官网首页切入：访问 getoriginai.com，在输入框中输入产品描述并点击生成。系统将引导你完成注册，你的需求描述将完整保留；登录后生成流程将自动继续。生成完毕后直接进入工作台查看文件树与画布原型。

老用户 — 在控制台直接创建：访问 getoriginai.com/app，点击 Generate 输入需求描述并启动生成（受当前套餐配额约束）。随后在工作台中审阅与调优——若对界面区域尚不熟悉，可参阅工作台地图。

生成流程分为两个有序阶段：优先起草产品 README（梳理产品全局大图景、信息架构与路由规划），确认无误后再依据 README 逐一生成各页面的原型屏幕。在进入具体页面前强烈建议先审视 README——顶层架构梳理清晰后，后续页面的生成质量将大幅提升。完整细节参见在 OriginAI 上创建项目。

第二步：发布首个 Release 版本

当规格完整反映了你的产品构想时，即可执行发布 Release。该操作会将当前工作区状态锁定为具有唯一内容哈希的不可变快照，作为后续交付给外部 Agent 实施开发的权威基准。

第三步：接入编码 Agent

让外部编码 Agent 对齐已发布的权威版本开展开发，核心操作极为简洁：

npx originai login
npx originai link --project <project-id> --skill
npx originai get-diff
# 编码 Agent 根据规格 Diff 编写与调整工程代码…
npx originai sync

针对不同 Agent 客户端的具体集成配置，参见连接编码 Agent。

流程跑通的核心衡量标准

项目中已生成规范的结构化 RPML 规格文件。
至少成功发布过一个 Release 版本快照。
外部编码 Agent 能通过 originai CLI 正确列举该版本下的所有文档。
清楚了解 Free 免费版的配额边界：3 个项目，每日 30 轮 Web 内置 AI 对话。

常见排查与处理建议

现象	排查与解决对策
注册完成后生成未自动开始	检查需求描述是否仍在输入区，在应用中再次点击 Generate 即可触发。
提示已达到项目数量上限	Free 方案支持创建 3 个项目——详情参见套餐与用量。
当日内置 AI 对话轮次耗尽	可等待每日 UTC 00:00 自动刷新重置，或升级至更高阶套餐。
编码 Agent 执行写入返回 `suggested: true`	此为发布后的安全机制——变更已暂存为变更请求，在 Web 端变更请求面板中审核应用后再行发布。