bug-bot
Skill1 starsChanged 8 days agoApache-2.0View on GitHub
Use when 管理飞书群里的「查 bug 机器人」(lark-channel-bridge + Claude Code):给机器人加项目、加生产库、给新群配机器人、改查 bug 流程、看运行状态、重启 bridge、排查机器人不回复 / 回复异常;关键词:查 bug 机器人、bug-bot、群里 @机器人查 bug、加项目、加群、auto-bug-tester、lark-channel-bridge 重启。
In this repository5 other files it gives its agents.
- github-image-uploadSkill
- qwen-ttsSkill
- video-summarizerSkill
- wechat-typesetSkill
- wx-articleSkill
The file
Files
bug-bot:飞书群查 bug 机器人管理
群主在绑定的飞书群里 @机器人 → bridge 在该群的工作目录启动 Claude → 按目录里的 CLAUDE.md 读群聊、
同步最新 release 代码到 /tmp/auto-bug-tester/<项目>、经 SQL 执行窗口只读查生产 → 群里回一条结论,修复建议追加到飞书文档。
- 配置:
config.json(项目、生产库别名、群)。只在本机,不进仓库;新机器先把config.example.json复制成config.json再填。 依赖:lark-channel-bridge、lark-cli(已登录用户身份)、sql-window skill(~/.codex/sql-window/connection.json已接通)。 - 查生产库:不直连。
scripts/sqlq.mjs复用 sql-window skill,以群主身份把 SQL 发到飞书「研发SQL执行群」,由「SQL执行窗口」机器人执行后读回结果。只支持 MySQL 单条 SELECT。 - 管理命令:
python scripts/bugbot.py <子命令>(-h看参数),路径相对本 skill 目录。命令和字段说明见references/management.md。 - 机器人运行时脚本:
scripts/chat_context.py、sync_code.py、sqlq.mjs、append_bug_doc.py,由生成的CLAUDE.md调用。 - 查 bug 流程模板:
assets/workspace-CLAUDE.md.tmpl。改流程只改模板,然后bugbot.py render,所有群一起更新,不用重启。
常见任务:
- 加群:不用跑命令。把机器人拉进群、群主 @ 一次就会自动登记(
onboard,默认项目default_projects,自动建记录文档);所有人都能 @ 要在群里发/invite group。指定项目 / 文档才用add-group。 - 加项目 / 加库 / 改群配置 / 改流程 / 查库不通 →
references/management.md - 机器人不回复、回复报错、重启、Windows 上 bridge 的坑 →
references/bridge-windows.md
约束:生产只读(只走 sqlq.mjs);机器人只给修复建议、不改代码;重启只用 bugbot.py restart,不用 lark-channel-bridge restart/start。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

