skills: convert assistant next-step menus into buttons

This commit is contained in:
Eve
2026-04-15 23:06:40 +08:00
parent a1e7d02406
commit f101e34d64

View File

@@ -1,6 +1,6 @@
---
name: telegram-inline-buttons
description: Use when sending proactive Telegram messages that ask Eric to confirm, choose, defer, or pick from a few next actions; especially for yes/no, A/B/C, do-now-vs-later, short multi-step button flows, implicit yes/no prompts like 如果你要..., and numbered option lists like 1.xxx / 2.ooo / 3.yyy that should be converted into inline buttons.
description: Use when sending proactive Telegram messages that ask Eric to confirm, choose, defer, or pick from a few next actions; especially for yes/no, A/B/C, do-now-vs-later, short multi-step button flows, implicit yes/no prompts like 如果你要..., agent-proposed next-step lists, and numbered option lists like 1.xxx / 2.ooo / 3.yyy that should be converted into inline buttons.
---
# Telegram Inline Buttons
@@ -14,6 +14,7 @@ Prefer inline buttons over free-text prompts when sending a proactive Telegram m
- Do it now vs later
- Picking one of a few next actions
- Numbered option lists like `1.xxx`, `2.ooo`, `3.yyy`
- Agent-proposed next-step menus written as `1. ... 2. ... 3. ...`
## Do not use buttons for
- Purely informational messages
@@ -27,8 +28,9 @@ Treat these as button-worthy even if they are not written as direct questions:
- `如果你要,我可以現在幫你處理`
- `如果你要我繼續,我就直接做`
- `如果你要 ooooxxxxx`
- `1. 立刻重發一次 2. 改成更明顯的測試文案 3. 直接在這裡做另一種測試`
These are usually implicit binary decisions and should default to inline buttons such as `[好,繼續] [先不要]` rather than requiring free-text confirmation.
These are usually implicit binary decisions or compact next-step menus and should default to inline buttons rather than requiring free-text confirmation.
## Natural-language preservation rule
When the original sentence is already natural Chinese, preserve the original wording as much as possible. Prefer changing only the reply mechanism to inline buttons instead of rewriting the sentence into a stiffer or more mechanical question.
@@ -41,6 +43,21 @@ Avoid unnecessary rewrites like:
- `請問是否要立即執行?`
- `是否要我現在開始處理此事項?`
## Next-step menu rule
When the assistant itself proposes 2-4 concrete next actions, do not leave them as a plain numbered text list if Telegram buttons are available. Convert the options directly into inline buttons.
Good:
- Text: `要怎麼測比較好?`
- Buttons: `[立刻重發] [改文案] [另一種測試]`
Avoid:
```text
1. 立刻重發一次
2. 改成更明顯的測試文案
3. 直接在這裡做另一種測試
```
when the whole point is to let Eric choose one.
## Button design
- Keep labels short: 1-4 words
- 2-4 buttons is ideal
@@ -49,6 +66,7 @@ Avoid unnecessary rewrites like:
- When the source prompt is a numbered list, convert each visible option into a short button label while preserving the original order
- When the source prompt is implicit yes/no, convert it into a clear binary choice without changing the underlying intent
- Prefer preserving natural Chinese phrasing and only replacing the free-text reply path with buttons
- When the assistant proposes next steps, use buttons instead of a numbered response menu whenever the user is expected to pick one
Recommended layouts:
- Binary: one row `[Yes] [No]`
@@ -56,6 +74,7 @@ Recommended layouts:
- A/B/C: one row `[A] [B] [C]`
- Numbered list: `[1] [2] [3]` or short labels derived from each option
- Implicit yes/no: `[好,繼續] [先不要]`, `[要] [不用]`, `[現在做] [稍後]`
- Next-step menu: `[立刻重發] [改文案] [另一種測試]`
## Telegram message tool pattern
For user-visible delivery, use `message(action="send")` with `buttons`.
@@ -138,7 +157,11 @@ Buttons: `[好,繼續] [先不要]`
Text: `如果你要,我現在就幫你開跑。`
Buttons: `[好,開始] [先不要]`
### Assistant-proposed next steps
Text: `要怎麼測比較好?`
Buttons: `[立刻重發] [改文案] [另一種測試]`
## Decision rule
Default to buttons whenever Eric is being asked to choose, confirm, defer, or select the next action on Telegram. This includes numbered lists that would otherwise require a reply like `1`, `2`, or `3`, and implicit yes/no prompts that would otherwise require a reply like `好` or `不用`.
Default to buttons whenever Eric is being asked to choose, confirm, defer, or select the next action on Telegram. This includes numbered lists that would otherwise require a reply like `1`, `2`, or `3`, implicit yes/no prompts that would otherwise require a reply like `好` or `不用`, and assistant-proposed next-step menus where Eric is clearly meant to pick one option.
When the original wording is already natural Chinese, keep the wording and just turn the response path into buttons.