
che-bot-toolkit
Bot 開發工具集
- version
- 0.1.0
Install
/plugin install che-bot-toolkit@psychquant-claude-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add PsychQuant/psychquant-claude-plugins.
Contents
Discovered from sourceAgents 2
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
⚠ This file was bootstrapped by
changelog-tools:changelog-initfrom theplugin.jsondescription field. Section categorization is best-effort — review and refineAdded/Changed/Fixedetc. as needed.
[Unreleased]
[0.1.0] - (date unknown — please fill in)
Changed
- Telegram 群組訊息監控 → GitHub Issue 自動化 pipeline。支援多專案、多人消歧義、衝突解決、launchd 定時背景檢查。
Inbox Pipeline — Telegram → GitHub Issue
使用前設定
此 skill 需要專案提供設定檔 .bot-inbox-config.json:
{
"telegram_group_id": "-5042817596",
"github_repo": "kiki830621/martingale",
"members": [
{ "name": "Hardy", "user_id": 8555072302 },
{ "name": "Che", "user_id": 7039911891 }
],
"bot_user_id": 7712962679,
"offset_file": ".bot-inbox-offset",
"pending_file": ".bot-inbox-pending.json"
}
如果沒有設定檔,詢問用戶提供 group ID 和 repo 資訊。
Workflow
Step 1: 讀取設定和新訊息
1. 讀取 `.bot-inbox-config.json` 取得設定
2. 讀取 offset 檔案取得上次的 update_id(沒有就用 0)
3. 呼叫 get_updates(offset=last_id+1, limit=100, timeout=0)
4. 篩選來自目標群組的訊息
5. 讀取「所有人」的訊息,只忽略 bot 自己的訊息
6. 如果沒有新訊息,回報「沒有新訊息」並結束
Step 2: 分析訊息內容
對群組中每則非 bot 的訊息,判斷類型:
| 類型 | 判斷依據 | 動作 |
|---|---|---|
| Feature Request | 提到新功能、「能不能」「可以加」「想要」 | 提議建 issue |
| Bug Report | 提到錯誤、「壞了」「不能用」「有問題」 | 提議建 issue |
| Data Request | 提到新資料來源、爬蟲、API | 提議建 issue |
| Question | 問句、需要回答 | 提議用 bot 回覆 |
| Reply/Answer | 回覆 bot 的消歧義問題 | 整合到對應的 issue 提案 |
| Chit-chat | 閒聊、無明確 action item | 跳過 |
Step 3: 檢查是否已有相關 Issue
gh api "repos/{GITHUB_REPO}/issues?state=open" --jq '.[].title'
比對現有 issue 標題,如果已有類似的就標注「可能重複」或「可合併到 #XX」。
Step 4: 消歧義 + 衝突解決循環
這是一個迴圈,持續與群組成員互動直到:
- 需求完全明確(無歧義)
- 所有成員的觀點衝突已解決(有共識)
WHILE 仍有歧義 OR 仍有觀點衝突:
1. 用 bot 發送問題
2. Polling 等待回覆
3. 分析「所有人」的回覆
4. 偵測觀點衝突
5. 如果有衝突 → 整理雙方觀點,請群組討論
6. 如果還有不清楚的 → 繼續問下一輪
7. 如果全部清楚且有共識 → 跳出迴圈
4a. 發送問題
mcp__che-telegram-bot-mcp__send_message(
chat_id="{TELEGRAM_GROUP_ID}",
text="關於「{訊息摘要}」,想確認幾個問題:\n1. {問題1}\n2. {問題2}",
reply_to_message_id={原訊息ID}
)
4b. Polling 等待回覆
- 每 30 秒呼叫
get_updates檢查新訊息 - 篩選群組中的新訊息(所有人都可能回覆)
- 忽略 bot 自己的訊息
- 最多等 15 分鐘。超時則用 AskUserQuestion 詢問用戶
4c. 多人觀點整合
| 情況 | 處理方式 |
|---|---|
| 全員一致 | 確認結論,跳出迴圈 |
| 觀點衝突 | 整理雙方觀點 + 提出折衷方案,請群組達成共識 |
| 部分人未表態 | @ 未表態的人詢問意見 |
| 有人說「就這樣」「OK」 | 確認其他人也同意後跳出 |
4d. 衝突解決
mcp__che-telegram-bot-mcp__send_message(
chat_id="{TELEGRAM_GROUP_ID}",
text="關於 {議題},目前有兩種看法:\n\n
{人A}:{觀點A}\n
{人B}:{觀點B}\n\n
技術上的分析:{技術說明}\n
1. {方案1}\n2. {方案2}\n3. 其他想法?"
)
Step 5: 整理 Issue 提案
將消歧義結果整理成 issue 提案:
- 比對現有 open issues
- 準備好 issue title、body、labels
Step 6: 呈現給用戶做最終審核
用 AskUserQuestion 列出所有提議的 issue/更新,讓用戶做最終審核。
Step 7: 建立/更新 Issue(需用戶授權)
只有用戶明確同意後才執行。
Step 8: 更新 Offset
只在流程完成時寫入 offset 檔案。消歧義等待中不更新。
Step 9: 回報結果
- 用 bot 在群組通知:「已建立 Issue #{number}: {title}」
- 向用戶顯示結果
Important Rules
- 絕對不自動建 issue — 必須經過用戶 AskUserQuestion 授權
- 不刪除或修改訊息 — 只讀取和回覆
- offset 持久化 — 只在流程完成時寫入,消歧義等待中不更新
- bot 回覆要簡潔 — 群組裡不要發太長的訊息
- 重複檢測 — 建 issue 前一定先比對現有 open issues
- 讀所有人的訊息 — 不只看特定人,只忽略 bot 自己的訊息
- 等待回覆 — 發出消歧義問題後必須等回覆,不可跳過
- 衝突解決 — 不偏袒任一方,客觀呈現觀點,提出折衷方案
Sponsors
Details
- Marketplace
- PsychQuant/psychquant-claude-plugins
- Source
- plugins/che-bot-toolkit
- Author
- Che Cheng
- Category
- Development
More from PsychQuant/psychquant-claude-plugins
All 42- che-creative-suitev0.1.0
- che-dropbox-ignorev2.1.0
- che-duckdb-mcpv2.3.0
- che-ical-mcpv1.7.0
- che-latex-mcpv0.7.0
- che-pixel-mcpv0.1.0
- che-svg-mcpv0.1.0
- che-telegram-mcpv1.0.0
- che-things-mcpv1.7.1
- che-word-mcpv1.17.0
- che-xcode-mcpv1.0.1
- che-zotero-mcpv1.0.2
- claude-config-guidev1.0.0
- claude-switchv1.0.0
- cli-toolsv1.0.0
- codex-batchv1.0.0
- docflowv1.0.1
- gifthubv1.2.1
- issue-driven-devv2.9.0
- lean-proverv1.1.0
- mcp-tccv0.1.2
- mcp-toolsv1.13.0
- parallel-ai-agentsv1.1.1
- perspective-writerv2.2.0