|
1 | 1 | # Bubseek Agent Instructions |
2 | 2 |
|
3 | | -## DingTalk Channel ($dingtalk) |
| 3 | +## Chat channels (`$dingtalk`, `$wechat`, `$feishu`, …) |
4 | 4 |
|
5 | | -When the message context shows `$dingtalk` and `chat_id`, you are in a DingTalk conversation. |
| 5 | +When the message context includes a **channel tag** (e.g. `$dingtalk`, `$wechat`, `$feishu`) and session/chat metadata, you are on an inbound chat channel. |
6 | 6 |
|
7 | | -**To reply: return your response as plain text.** The framework will deliver it to the user. Do not call any script; just write your answer and finish the turn. |
| 7 | +- **Reply with plain text.** The framework delivers it to the user. Do not run shell commands or scripts just to answer the user. |
| 8 | +- **Channel-specific send tools** (names vary by plugin: e.g. `dingtalk_send`, `wechat`, Feishu/Telegram helpers): use them only when you must send a message **from inside another tool** (e.g. progress during a long task), not for normal turn replies. |
8 | 9 |
|
9 | | -Only use `dingtalk_send` when you need to send a message from within a tool (e.g. progress update during a long task). |
| 10 | +## Marimo (`$marimo`) |
10 | 11 |
|
11 | | -## WeChat Channel ($wechat) |
| 12 | +Same rule: **plain text** replies go to the gateway UI. |
12 | 13 |
|
13 | | -When the message context shows `$wechat` and a WeChat-oriented `session_id` / `chat_id`, you are in a WeChat conversation. |
14 | | - |
15 | | -**To reply: return your response as plain text.** The framework will deliver it to the user. |
16 | | - |
17 | | -Only use the `wechat` tool when you need to send from within another tool (e.g. progress update). See [bub-wechat](https://github.com/bubbuild/bub-contrib/tree/main/packages/bub-wechat). |
18 | | - |
19 | | -## Marimo Channel ($marimo) |
20 | | - |
21 | | -When the message context shows `$marimo` and `chat_id`, you are in a Marimo gateway chat. |
22 | | - |
23 | | -**To reply: return your response as plain text.** The framework delivers it to the gateway UI. |
24 | | - |
25 | | -**For data insights and charts:** output marimo `.py` notebooks to `{workspace}/insights/`. Use `@app.cell`, PEP 723, and **marimo-notebook** conventions. **Combine with other marimo skills** when appropriate: **anywidget** for custom widgets, **add-molab-badge** for deployment, **implement-paper** for paper-based viz, **marimo-batch** for batch jobs, **wasm-compatibility** for browser/WASM. The index auto-reloads when you respond. |
| 14 | +**Data insights and charts:** write marimo `.py` notebooks under `{workspace}/insights/`. Use `@app.cell`, PEP 723, and **marimo-notebook** conventions. **Combine with other marimo skills** when useful: **anywidget**, **add-molab-badge**, **implement-paper**, **marimo-batch**, **wasm-compatibility**. The index auto-reloads when you respond. |
0 commit comments