TriBot Bot 团队 · DSH 插件

把一支分工明确的 Bot 团队装进你的 Agent：选一个角色，就切到那套方法论和输出契约；不用搭多进程、不用写提示词、还特别省 token。

一句话：总管拆解 · 研究员查证 · 工程师动手 · 管家巡检 · 审稿人挑刺，五个角色装在一个技能里。

---

功能与亮点

• 一次安装，五种专精：一个 SKILL.md 里塞了五套完整方法论（怎么做、什么算合格、不能做什么）和五套输出契约。选角色 = 换工作模式，不是换模型。
• 输出结构固定，可直接交付：每条回复都按「结论 / 依据 / 未完成 / 下一步」这类结构落地，不用再手工整理一遍。
• 省 token 有实测（桌面版引擎）：长工具输出落盘、长会话摘要压缩、稳定前缀吃缓存、重复调用提醒——综合场景实测 省 88.3%，¥0.425 → ¥0.050。
• 质量纪律有实测（DSH 技能）：同一交接文档任务三轮对比——单干 ≈¥0.35；团队 v1（全量重读）≈¥1.28（3.7×）；团队 v2（上下文经济）≈¥0.39，成本与单干持平，且轻审 60 处抽验抓到 1 处真实错误（路由数 54→58，已独立复核修正）。深审模式按需开启。
• 零配置：纯指令型插件，不联网、不写文件、不需要任何密钥或环境变量，装完即用。
• 跨客户端同一份文件：SKILL.md 同时写了 when_to_use（ZCode）与 whenToUse（DSH）两个字段，DSH / ZCode / 任意兼容 Agent 都能用。
• 可选的可视化选角：装上附带的 DSH 客户端插件，输入框旁会出现「选择角色」胶囊，点一下就选，不用记命令。

五个角色

角色	专精	典型交付
🧭 总管	任务拆解、并行分派、验收与合并；不亲自调研、不亲自写码	结论 + 依据 + 未完成 + 下一步建议
🔍 研究员	多角度检索、A/B/C 来源分级、交叉验证、冲突裁决	带链接与日期的要点清单，标出不确定项
🛠 工程师	先读后写、最小改动、写完必验、失败贴原始报错	改动清单 + 实际验证输出 + 风险与回滚方式
⏰ 管家	巡检清单化、阈值判级、只报变化不写长文	200 字内的状态 / 异常 / 建议
🧪 审稿人	结论与证据一致性、引用可信度、边界与可执行性、查夸大	通过 / 需修改 / 拒绝 + 分级问题清单
👥 团队	总管拆解 → 专家并行 → 审稿人验收 → 总管交付	完整流水线产物（同一 Agent 内按角色切换）

每个角色都有自己的质量门槛与硬边界：不编造来源与数字、没权限就直说、破坏性操作先审批、失败不硬闯。

省 token 怎么省的

实测环境：本仓库真实文件、真实工具 Schema，tokenizer 为 cl100k_base（不同供应商 tokenizer 有 ±10% 差异）。

场景	不处理	TriBot	省
读 3,705 行 lockfile	56.2k	1.1k	98.1%
cat 61,158 行打包产物	615.3k	626	99.9%
40 条历史对话压缩	12.7k	5.2k	58.8%
30 轮 + 3 次大输出 + 6 次重复调用	849.4k	99.3k	88.3%（¥0.425 → ¥0.050）

四个机制：

1. 长工具输出落盘：超过 6,000 字符不整段塞回上下文，只回填头尾，并给模型一个把手按需读回原文——既不爆窗口也不丢信息。
2. 长会话摘要压缩：保留最近对话 + 摘要，原文仍可回读。
3. 稳定前缀吃缓存：系统提示按「人设 → 技能 → 任务卡 → 摘要 → 时间/环境」排序，把每分钟变化的时间戳放到最后，多轮请求前缀尽量不变（30 轮再省 44.5%）。
4. 重复调用提醒：同一工具同一参数第 3/5/8 次时提醒换思路，少烧无效 token。

这些数字来自本仓库的 pnpm bench 实测脚本，可复现；完整数据见 docs/token-benchmark.md。

DSH 技能的 A/B 实测（同一交接文档任务）：单干 ≈90k in / ≈¥0.35；团队 v1（审稿人重读全仓）≈420k in / ≈¥1.28（3.7×）；团队 v2（上下文经济：审稿两级制 + 阅读预算 + grep 定向核验 + 回执蒸馏）≈135k in / ≈¥0.39——成本与单干持平（1.1×），且轻审 60 处抽验抓到 1 处真实错误并已独立复核。省 token 的 88% 是桌面版引擎的机制；技能卖的是「同等价格下多一层验证过的质量」。

安装

方式一：插件市场一键装（推荐）

在 DSH 的插件市场搜索 TriBot，点安装即可。市场安装会把它放进 Agent 的技能目录。

方式二：手动 clone

# DSH / 通用 Agent 技能目录
git clone --depth 1 https://github.com/P3NN4L/Tribot.git ~/.agents/skills/tribot

# 或 DSH 专用目录
git clone --depth 1 https://github.com/P3NN4L/Tribot.git ~/.dsh/skills/tribot

装完目录里要有 SKILL.md（仓库根目录就是它），重启 / 重新加载 Agent 即可。

使用示例

直接点名角色：

/tribot 总管

/tribot 工程师 把这个构建错误修好并给出验证输出

/tribot 研究员 查一下这个说法有没有一手来源

不点名时它会先给你一张菜单，你回编号即可：

选一个 Bot：
1. 🧭 总管   2. 🔍 研究员   3. 🛠 工程师
4. ⏰ 管家   5. 🧪 审稿人   6. 👥 团队

选定后，每条回复第一行都会标出当前角色，方便你和它对齐：

> 🛠 **当前角色：工程师** · TriBot 3/6

配置

不需要任何配置。 没有环境变量、没有密钥、没有后台服务。

角色指令只在你显式调用时加载，不占常驻上下文；这也是它省 token 的原因之一。

附：可视化选角插件（可选）

仓库里的 integrations/dsh-role-picker 是一个 DSH 客户端插件，装上后 DSH 输入框旁会出现：

[ 选择角色 ▾ ]

点开就是六个角色，选完自动填入 /tribot 工程师 。颜色、亮暗外观、语言跟随 DSH 设置。

# 在 DSH profile 里链接这个插件
pnpm --dir ~/.dsh/profiles/desktop add "dsh-tribot-role-picker=link:<你的路径>/integrations/dsh-role-picker"

仓库里还有什么

这个仓库同时是 TriBot 桌面版（本地 Bot 团队工作台）的 monorepo：Electron + Windows 原生壳、会话工作区、文件预览、检查点回滚、权限审批、用量统计。桌面端的说明见 docs/tribot-desktop.md。

目录：

SKILL.md                     # 这个插件本体（市场收录的就是它）
skills/                      # 其它技能（设计系统等）
integrations/dsh-role-picker # 可视化选角的 DSH 客户端插件
packages/                    # core / server / app / cli / shared
docs/                        # 文档、实测数据、设计说明

开发

pnpm install
pnpm test        # 单测
pnpm typecheck   # 类型检查
pnpm bench       # 重新跑省 token 实测

改完技能记得同步已安装的副本：

cp SKILL.md ~/.dsh/skills/tribot/SKILL.md
cp SKILL.md ~/.zcode/skills/tribot/SKILL.md

License

MIT © 2026 Zhanjian Li。见 LICENSE。