上下文注入与研发闭环

让 AI IDE 写代码前先读 Studio 文档，并把开发结果沉淀回知识库

AI IDE（Cursor / Claude Code / Codex）写代码很强，但它不知道你的项目——它不知道你正在做的是车辆排队系统、不知道这个项目的「优先级」分了 P0/P1/P2、不知道 BRD 第 4.5 节插队审批的具体规则。

每次对它说"按 PRD 实现一下排队登记"前，你要么手动复制粘贴一大段需求，要么让它瞎猜。

studio-cli 让 AI IDE 自动从 Aiko Studio 拉取项目文档作为上下文——你只需要在仓库里跑一次命令，对应的 BRD / PRD / 技术方案就被注入到 IDE 的"它能看到的文件"里。然后 AI 写出来的代码就跟你的需求对得上。

如果你用的是 Aiko Studio IDE，这件事会更进一步：Workbench / SDD 面板可以直接选择 Studio 里的需求文档版本，按新功能、hotfix、日志与小调整、full 完整流程生成开发任务、设计与测试材料；开发完成后再把 specs、测试证据和关键决策归档到知识库，下一轮 Studio 生成 PRD 时继续调用。

1. 这页讲的工作流

前提：你已经装好 studio-cli 并配好认证。

Aiko Studio IDE 用户

如果你已经在用 Aiko Studio IDE，优先走 Workbench / SDD 面板的「从 Studio 导入」：它会保留文档版本、章节血缘和资源引用，并按变更类型生成开发任务、设计与测试证据材料。CLI 仍适合 Cursor / Claude Code / Codex 等通用 IDE。

2. 列项目和文档

先看你能访问哪些项目：

列项目

studio-cli project list

输出：

ID                       NAME                    TYPE
proj_01h...              车辆排队系统             基本标准
proj_02k...              内部 CRM 改造            内部工具

挑一个项目，列它下面有哪些文档：

列项目下的文档

studio-cli project docs proj_01h...

输出：

ID            TYPE   TITLE                  UPDATED
doc_brd_xxx   BRD    车辆管理业务需求       2026-04-22
doc_prd_yyy   PRD    车辆管理产品需求       2026-05-08
doc_arch_zzz  TECH   排队系统架构方案       2026-05-06

3. 拉取单份文档作为上下文

最常用的命令是 generate-doc：把一份文档导出为本地 context bundle。

导出 PRD 作为上下文

studio-cli generate-doc doc_prd_yyy

默认输出到 .aiko-studio/ 目录，文件结构：

目录结构

.aiko-studio/
├── docs/
│   └── prd-vehicle-queue.md          # 渲染好的 Markdown，AI 友好
├── resources/
│   ├── 业务流程图.png                  # 文档里的图、表都一并导出
│   └── 字段映射.xlsx
└── manifest.json                      # 元信息：文档版本、更新时间

4. 为不同 IDE 输出不同格式

studio-cli 知道几种 IDE 的上下文约定，可以直接出对应格式：

给 Cursor 用

studio-cli generate-doc doc_prd_yyy --format cursor
# → 写入 .cursor/rules/ 下，Cursor 自动加载

给 Claude Code 用

studio-cli generate-doc doc_prd_yyy --format claude
# → 写入 .claude/context/ 下，Claude Code 启动时自动读

给任意通用 LLM 用（默认）

studio-cli generate-doc doc_prd_yyy
# → 写入 .aiko-studio/，最大兼容

具体每种格式的目录约定见集成示例（Cursor / Claude Code）。

5. 增量更新

业务方在 Studio 里改了 BRD，你怎么让本地的上下文跟着更新？

方式 A：每次重跑（最简单）

studio-cli generate-doc doc_prd_yyy --format cursor

CLI 会检查远端 Studio 上文档的 updated_at，跟本地的版本对比，只有变化时才重写文件。没变就直接退出，秒级响应。

方式 B：watch 模式（持续同步）

studio-cli generate-doc doc_prd_yyy --format cursor --watch

进程常驻，每 60 秒检查一次远端是否有更新，有就自动重写本地文件——业务方刚改完 BRD，你的 Cursor 立刻能看到最新内容。

方式 C：CI 里跑

把这条命令加进 CI 的 pre-build 阶段，每次构建前从 Studio 拉最新文档——保证 AI 生成的代码永远基于最新需求。

6. 一个完整的研发链路

研发同学的实战流程：

接到任务：业务方说"按 PRD 第 3.1 实现排队登记功能"
拉上下文或选文档：通用 IDE 在仓库根目录跑
```
studio-cli generate-doc doc_prd_yyy --format cursor
```
Aiko Studio IDE 则在 Workbench / SDD 面板里选择同一份 PRD 版本，直接生成 SDD 任务与证据材料。
打开 IDE：Cursor 左侧 .cursor/rules/ 里能看到 PRD 全文 + 业务流程图 + 数据字典；Aiko Studio IDE 的 SDD 面板里能看到变更类型、开发任务、设计 / 测试材料和归档证据
跟 AI 对话：

"按 .cursor/rules/prd-vehicle-queue.md 第 3.1.1 实现排队登记接口，注意触发条件那段的 5 分钟超时"
AI 生成代码：直接基于 PRD 的字段定义、状态机、异常处理写代码——不再瞎猜
测试与归档：Aiko Studio IDE 按 pipeline 回填 evidence；通用 IDE 至少把实现说明、测试结果和关键决策整理成可归档材料
知识库回流：归档后的 specs / evidence / 设计决策进入知识库，下一轮 Studio Copilot 写 PRD 时可以检索复用

7. 这能帮你团队对齐什么

场景	没 studio-cli	有 studio-cli
AI 写出来的代码字段名错了	靠 reviewer 抓出来	AI 直接读 PRD 数据字典，字段名就对了
改一行需求要通知所有研发	群里 @、邮件、口头交代	研发拉一下 CLI，本地上下文自动更新
新人入职理解项目	读 BRD/PRD/架构 3 天	`studio-cli generate-doc` 一份打包给 AI，问 AI 就行
跨团队协作	文档同步靠粘贴	双方都从 Studio 拉同一份事实源
下一版 PRD 重新从零写	靠产品经理记得上次开发细节	知识库带回 specs / evidence / 决策记录，Studio Copilot 可复用

下一步

集成示例（Cursor / Claude Code） —— 不同 IDE 的具体配置
studio-cli 命令表 —— 全部命令参考
安装与认证 —— 还没装的话从这里开始

上下文注入与研发闭环

On this page