Skip to content

Commit fffbc1d

Browse files
committed
docs: refine agents.md
Signed-off-by: Chojan Shang <psiace@apache.org>
1 parent 0582135 commit fffbc1d

1 file changed

Lines changed: 7 additions & 18 deletions

File tree

AGENTS.md

Lines changed: 7 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,14 @@
11
# Bubseek Agent Instructions
22

3-
## DingTalk Channel ($dingtalk)
3+
## Chat channels (`$dingtalk`, `$wechat`, `$feishu`, …)
44

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.
66

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.
89

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`)
1011

11-
## WeChat Channel ($wechat)
12+
Same rule: **plain text** replies go to the gateway UI.
1213

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

Comments
 (0)