baa-conductor

commit

bfbbb41

parent

1a90d21

author

im_wower

date

2026-03-28 13:30:59 +0800 CST

docs: add baa quickstart for ai agents

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