将规格共享给团队或编码 Agent
将已发布的产品规格准确交付给团队成员与各类编码 Agent。
当规格编写完毕并完成发布后,所有依赖该规格开展研发的成员与工具必须对齐到同一个确定版本——而非依靠零散碎片化的聊天记录拼凑上下文。OriginAI 针对不同的使用对象提供了多种交付与共享方式。
选择合适的交付方式
面向支持直接访问网络 URL 的编码 Agent: 使用版本发布后生成的纯文本(Markdown)导出。无需身份认证即可访问;相较于单页预览,完整连续的文本对于 Agent 而言更具确定性与完整度。
面向已在本地代码仓库中关联 OriginAI 的编码 Agent: 提供针对性的实现提示词(Implement Prompt),或引导其通过 CLI 直接读取指定的 Release 快照。这是团队进行日常长效协作的推荐方式。
面向人类团队成员: 直接发送公开预览链接进行走查评审。若编码 Agent 亦需要全面理解上下文,可同时附上纯文本导出链接。
交付已发布的 Release 版本
- 打开目标项目的版本历史记录列表。
- 选择待分享的具体 Release 版本。
- 复制纯文本提示词、实现提示词或公开预览链接。
- 发送给协作者或粘贴至编码 Agent 的对话上下文。
当产品需求演进时,只需重新发布新版本并分享最新链接,切勿修改旧版本的交付上下文。如果编码 Agent 在实现过程中发现需要调整规格,其发起的修改会先暂存为变更请求(Change Request),经你在平台确认应用后,发布下一版本。
公开预览链接由用户名与项目 Slug 构成(spec.getoriginai.com/<username>/<slug> 始终解析至最新公开版本,附带 /<hash> 则精准固定至该历史快照)。包含项目 ID 的旧格式 URL 保持长久兼容。如需调整访问路径,可在项目设置中修改项目 Slug。
示例:交付给 Agent 的纯文本提示词
当将规格交付给具备 URL 抓取能力的 Agent 时,可使用以下提示模板:
Please read the published product specs (plain text; usually no login required):
Full text: https://spec.getoriginai.com/<username>/<project-slug>/<version-hash>/llm-full.txt
Index: https://spec.getoriginai.com/<username>/<project-slug>/<version-hash>/llm.txt
Latest: https://spec.getoriginai.com/<username>/<project-slug>
Read them fully before discussing implementation or review.
Do not infer product behavior from chat history alone.示例:仓库已完成绑定的实现提示词
当 Agent 已经在配置好项目绑定的本地代码仓库中工作时,可使用以下提示模板:
Please read the specified (or latest) published release for the OriginAI project
linked to this repo, implement or change the code to match the specs,
then update the sync pointer following our team's practices.面向 Agent 共享文档站内容
本官方文档站的每一篇文档,均对应提供了一份适合 Agent 解析的 Markdown 纯文本。无需手动复制网页文字——只需在 llms.mdx/docs/ 路径后附加 /content.md 即可获取。
例如对于当前页面:
https://getoriginai.com/docs/zh/guides/quickstart其对应的机器可读 Markdown 路径为:
https://getoriginai.com/docs/llms.mdx/docs/guides/quickstart/content.md若希望一次性获取整套完整文档,亦提供了两类全局索引文件:
| URL | 返回内容 |
|---|---|
https://getoriginai.com/docs/llms.txt | 全站所有文档页面的纯文本层级索引。 |
https://getoriginai.com/docs/llms-full.txt | 包含所有文档页面完整正文的拼接汇总。 |
上述两份文件专为编码 Agent 与 LLM 上下文注入设计——均为免登录纯文本格式,支持 Agent 随时直接抓取解析。
常见问题排查
| 现象 | 排查建议 |
|---|---|
| 纯文本导出链接无法访问 | 检查对应版本的后台导出渲染是否已经完成。 |
| Agent 提取到的内容显旧 | 确认提供的链接是否指向最新版本哈希,或重新抓取该版本数据。 |
| 视觉预览正常但 Agent 理解存在偏差 | 建议优先向 Agent 注入完整纯文本导出(llm-full.txt),避免仅依赖预览页摘要。 |
| 需要对规格做出调整 | 在工作台中进行修改(或应用变更请求),发布新的 Release 版本后再行共享。 |