上下文注入工作流

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

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

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

1. 这页讲的工作流

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

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。

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 的上下文约定，可以直接出对应格式：

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

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

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. 一个完整的研发链路

研发同学的实战流程：

1. 接到任务：业务方说"按 PRD 第 3.1 实现排队登记功能"
2. 拉上下文：在仓库根目录跑

   studio-cli generate-doc doc_prd_yyy --format cursor

3. 打开 Cursor：左侧 .cursor/rules/ 里能看到 PRD 全文 + 业务流程图 + 数据字典
4. 跟 AI 对话：

   "按 .cursor/rules/prd-vehicle-queue.md 第 3.1.1 实现排队登记接口，注意触发条件那段的 5 分钟超时"

5. AI 生成代码：直接基于 PRD 的字段定义、状态机、异常处理写代码——不再瞎猜
6. 业务方改了：跑一次 generate-doc 拉最新版，再让 AI 同步改代码

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

下一步

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