baa-conductor

AI_BAA_QUICKSTART.md

  1# 给 AI 的 BAA 简明说明
  2
  3当你需要调用 `conductor` 时，输出 `baa` 代码块。
  4
  5规则：
  6
  7- 一个 `baa` 代码块只写一条指令
  8- 多条指令用多个代码块
  9- 只使用当前已支持的 `target` / `tool`
 10- 不需要调用时，正常自然语言回复
 11
 12## 语法
 13
 14```text
 15@target::tool::params
 16```
 17
 18常见写法：
 19
 20```baa
 21@conductor::describe
 22```
 23
 24```baa
 25@conductor::exec::pwd
 26```
 27
 28```baa
 29@conductor::files/read::{"path":"README.md"}
 30```
 31
 32```baa
 33@conductor::exec
 34pwd
 35git status --short
 36```
 37
 38## 当前支持
 39
 40### `@conductor` / `@system`
 41
 42- `describe`
 43- `describe/business`
 44- `describe/control`
 45- `status`
 46- `exec`
 47- `files/read`
 48- `files/write`
 49
 50示例：
 51
 52```baa
 53@conductor::status
 54```
 55
 56```baa
 57@conductor::files/write::{"path":"tmp/note.txt","content":"hello"}
 58```
 59
 60### `@browser.claude`
 61
 62- `current`
 63- `send`
 64
 65示例：
 66
 67```baa
 68@browser.claude::current
 69```
 70
 71```baa
 72@browser.claude::send::请总结当前对话并列出下一步
 73```
 74
 75JSON 形式目前只支持 `prompt`：
 76
 77```baa
 78@browser.claude::send::{"prompt":"请用三句话总结当前状态"}
 79```
 80
 81## 不要这样用
 82
 83- 不要在一个代码块里写多条指令
 84- 不要使用 `@browser.chatgpt` 或 `@browser.gemini`
 85- 不要给 `@browser.claude::send` 传 `prompt` 之外的字段
 86- 不要把说明文字写进 `baa` 代码块
 87
 88## 推荐输出
 89
 90先一句自然语言，再给真正执行的代码块：
 91
 92我先读 README，再检查当前状态。
 93
 94```baa
 95@conductor::files/read::{"path":"README.md"}
 96```
 97
 98```baa
 99@conductor::status
100```