AGENT SKILL

belfry

把活派给 Belfry 里另一条 Agent 会话:看有谁在(peers)、在协作房间里跟统筹和成员一起完成一个需求(rooms、room status/say/task)、请对方做事(send)、交差(done/fail)。**用户在侧栏给多条会话起了名字(reviewer、前端、测试这类),本身就是要你派活给那些真实会话的信号**——此时说「交给 X」「让 X 做」「派给 X」指的是那条会话,不是让你起子代理扮演这个角色。先 belfry peers 确认对方在不在。反过来,如果只是想把一件事拆开跑快点、并没有指定的会话,那用子代理,别去占用户的工作现场。需要环境变量 BELFRY_TAB_ID。

License 许可
LGPL-3.0
最近更新
2026-11-15
Stars
★ 26
Forks
3

01 前言 Front Matter

name
belfry
description
把活派给 Belfry 里另一条 Agent 会话:看有谁在(peers)、在协作房间里跟统筹和成员一起完成一个需求(rooms、room status/say/task)、请对方做事(send)、交差(done/fail)。**用户在侧栏给多条会话起了名字(reviewer、前端、测试这类),本身就是要你派活给那些真实会话的信号**——此时说「交给 X」「让 X 做」「派给 X」指的是那条会话,不是让你起子代理扮演这个角色。先 belfry peers 确认对方在不在。反过来,如果只是想把一件事拆开跑快点、并没有指定的会话,那用子代理,别去占用户的工作现场。需要环境变量 BELFRY_TAB_ID。

02 资源文件 1

03 SKILL.md 正文

Belfry 会话协作

Belfry 是一个终端工作台,它把每条 Agent 会话都摆在用户眼前。belfry 命令让这些会话互相 说话——派出去的活会注入对方终端,用户在协作面板里看得到每一条的去向和状态,也随时能切进 那条会话自己接手。

动手之前先确认自己就在这样一条会话里:

test -n "${BELFRY_TAB_ID:-}"

不成立就说明这里不是 Belfry 开的 Agent 会话,belfry 不可用——直接告诉用户,别去猜端点。

先看有谁

belfry peers

输出每条会话的名字、Agent 类型、忙闲和标题,自己那条前面带 *:

* planner   claude   (我自己)        — 把协作切回点对点
  reviewer  codex    idle · 可以派活   — 审一下队列回滚
  (未命名)  claude   要派活得先在侧栏给它起个名字 — 改 registry 的寻址

名字是唯一的寻址键。 标题不是——它由用户最后一条输入自动生成,每敲一条 prompt 就变。 没有名字的会话寻址不到;如果用户想派活给它,让他在侧栏双击那条会话起个名字。 名字可以是中文(审查、前端),字母开头、不带空格即可——汉字不是 shell 元字符,裸写就能派活。

协作房间

用户可以把几条会话拉进一个协作房间,一起完成一个需求:一位统筹负责拆需求、派活、跟进度、 最后向用户汇报,自己也接活;其他成员各管自己的职责。被拉进房间时你会收到一条上手说明, 写着你的角色和职责。先看全貌:

belfry rooms          # 我在哪几间房、我是统筹还是成员、还有几条活没完
belfry room status    # 需求简报、成员与职责、任务板、等我回复的消息
belfry room log       # 最近的对话(每条带短 id,--count <条数>)

同时在多间房里时,所有 room 命令加 --room <房间名>。

发消息

belfry room say 登录接口的字段定了吗              # 不写收件人:成员发给统筹,统筹发给全体成员
belfry room say @后端 token 过期时间改成 2 小时    # @角色 只发给那个人
belfry room say --to @全体 下午三点前提交          # --to 也接受 @全体 @成员 @统筹 @用户
belfry room say --ask @前端 今天能联调吗           # --ask 要求回复:对方回复前一直挂着「等你回复」
belfry room say --reply a1b2c3d4 可以,四点        # 回复某条(默认回给原发件人),这也会了结对方的回复请求

room status 里出现「等你回复」的消息要回。没有要补充的普通消息不必回复。 要找用户(需要拍板、做完了要汇报)就 --to @用户,用户在界面上看。一分钟最多 12 条,别刷屏。

任务板

任务号是 T1、T2……,所有人看的是同一块板。

belfry room task add 登录接口 --to 后端 --outcome "返回 token 和过期时间"   # 建任务(--after T1 表示要等 T1 完成)
belfry room task start T1          # 开工
belfry room task note T1 已联调     # 记一条进展
belfry room task done T1 已合并到 main,接口文档在 docs/api.md   # 完成并写结果
belfry room task assign T3 前端     # 换人(统筹);成员只能认领没人负责的任务给自己
belfry room task reopen T1         # 退回待开工
  • 统筹:先读需求简报,把需求拆成任务、按职责派给成员;成员完成任务或手上没活时你会收到通知, 据此派下一件;全部完成后用 room say --to @用户 汇报结果。需要调整目标时 belfry room brief --focus <当前重点>(还有 --objective、--constraint),成员都会收到通知。
  • 成员:只做派给自己的任务。开工 start,完成 done <结果>——结果写清楚产物在哪、怎么验证, 统筹靠它决定下一步。需要别人配合或发现需求有问题,跟统筹说;不能给别的成员派活。
  • 房间任务不用 belfry done:那是 belfry send 派来的活才用的。

派活

belfry send reviewer 审一下 src/auth.ts 的边界情况,只报可执行的问题

指令不用加引号,多个词会拼回去。要点:

  • 同项目派活直接放行,返回「已送给…」表示已经交给投递队列。但**「已送出」不等于对方开工了**: 对方正忙或卡在权限框时,指令会排在队里等它空闲。别在这之后假设它已经看到了。
  • 在别人派给你的任务中间再派活,带上 --parent <任务号>——转包层数和成环检测靠它算准。
  • 拒绝是有理由的:跨项目、给自己派、转包超过 3 手、绕成环、目标已退出都会当场说明原因。

收活与交差

belfry inbox                    # 派给我、还没结的
belfry done <任务号> 改完了,测试也过了
belfry fail <任务号> 这条要前端上下文,我这边看不到

收到的任务长这样,最后一行就是交差要敲的命令,照抄即可:

[belfry] 来自「planner」的任务 01m1bqyc
审一下 src/auth.ts 的边界情况
完成后执行:belfry done 01m1bqyc

done 是唯一可信的完成信号。 Belfry 判断「你在忙还是空着」靠扫屏幕文本,那是猜的; 做完了不敲 done,派活方会一直看到「已送出 · 完成情况未知」。做不了就 fail 并说清原因, 那句话是对方唯一能看到的解释。

等对方交差再往下走

要串起「A 做完再交给 B」这种流程,派完之后盯着那条任务:

belfry send ui 按需求文档出一版原型   # 返回里带任务号
belfry wait <任务号>                 # 一直等到它交差

wait 只在对方敲了 done / fail 之后才返回,所以它返回就意味着那一步真的结束了, 可以接着派下一个人。要点:

  • 默认一直等,不设上限——有些活要跑很久,而给个上限只会让你在超时那一刻误判成 「可以往下走了」。真需要上限时用 --timeout <秒>。
  • 一直等不会挂死:对方会话被关掉、用户在协作面板按「全部停下」、或者用户 Esc 掉你 这条会话,三条路都会让 wait 返回。目标消失时它报的是「已作废」,那不是完成。
  • 等之前先说一句你在等谁。等待期间用户只看到你在「Working」,不知道卡在哪一步—— 开等之前留一句「已派给 ui,等它交差」,他才看得懂这段沉默。
  • 超时不是完成。给了 --timeout 而超时了,消息里会带上当前状态(排队中/已送出但 还没交差),那都不是往下走的信号。
  • 等多条就依次 wait:它们并行在跑,先等哪个都一样,总耗时等于最慢那个。
  • 只能等自己派出去的任务;别人派的连状态都查不到。

命令面以 --help 为准

belfry --help

这份文档会过期,装在机器上的那个二进制不会。参数对不上时先查 --help,别猜。 失败信息走 stderr、退出码非零,里面通常已经写了下一步该敲什么。

这不是子代理

派活的对象是用户已经开好、正摆在他眼前的一条会话,不是你新起的一个子代理。区别决定了 什么时候该用哪个:

belfry send 子代理(spawn_agent / Task)
对方是谁 用户开的长期会话,有自己的历史和上下文 你临时起的,干完就没了
谁看得见 用户看得见整个过程,能随时接手 基本是黑盒
代价 占用用户的一个工作现场,会打断他在那边的思路 只花 token
适合 需要另一个视角、另一个模型,或对方已经在那个上下文里 并行跑一批边界清晰的机械活

「这件事并行做会更快」是用子代理的理由,不是派活给别人会话的理由。

但反过来也要认得出信号:用户已经在侧栏开好并命名了几条会话(项目经理、前端、测试), 那就是他搭好了一个班子,说「交给前端」指的就是那条会话。这时候起子代理自己扮演前端,等于 把他摆好的人全都绕开了——而他开那些会话是为了能一个个看着、随时接手。拿不准就先 belfry peers 看一眼:名单里正好有他点名的那个名字,就是它。

worktree 并行又是第三件事——那是分支隔离,和这里无关。

分寸

  • 派活前先 peers:确认对方在、闲着、而且名字没记错。
  • 不要替用户回答别人终端里的权限确认框——那是他的决定。
  • 你只能派活和交差;开会话、关会话、给会话起名都由用户在界面上做。

04 同仓库更多 Skills