编写 Room Skill | Nexus 文档

什么时候使用 Room Skill

任务需要多个 Agent 在同一会话中遵循固定协作规则时，可以使用 Room Skill，例如主持、执行、复核、汇总，或先私下收集再公开结论。

只影响一个 Agent 的规则应写成普通 Agent Skill。

必须写清楚的内容

Room Skill 应包含以下内容。

适用任务、触发条件与不适用场景。
每类成员的职责与交付要求。
哪些事实进入公开区，哪些上下文只私下发送。
工作如何交接，最终结论由谁公开。
没有新工作、超时、失败或成员不可用时如何结束或报告问题。

公开与私下协作

公开区只发布所有成员都需要知道的目标、已确认决策、进展、阻塞和最终结论。未确认草稿、重复确认和无意义附和不应公开。

私下消息适合指定成员才能处理的请求、不宜公开的背景，以及需要先收集再汇总的中间意见。私下结果不会自动公开，负责汇总的人需要转述必要结论。

提及与任务记录

公开区的 @成员 用于唤醒成员或交接工作。需要记录任务、负责人、依赖、提交和验收时，应建立工作图。提及本身不会创建这些记录。

发布前检查

写明 scope: room。
明确成员职责和最终汇总者。
区分公开事实与私下上下文。
只在需要行动时提及成员。
说明私下结果如何回到公区。
定义停止、超时与失败处理规则。

完整工具选择与通信规则见 Room Skill 编写指南。

最小可导入示例

创建一个目录并把下面内容保存为 SKILL.md，再通过技能页导入。

---
name: team-review
description: 多成员共同评审已有材料，需要分工核对与统一汇总时使用。
scope: room
---

## 开始条件

先确认输入材料、执行成员、复核成员和最终汇总者。
缺少成员或材料时先提出问题，不空转。

## 协作流程

1. 汇总者公开目标、交付文件名和验收标准。
2. 执行成员阅读材料并提交带依据的初稿。
3. 复核成员检查事实和缺口，把具体修改意见交回执行者。
4. 汇总者核对修订结果，公开最终文件与未解决问题。

## 通信和停止

只在对方有新动作时提及成员。私下结果由汇总者带回公开区。
没有新材料时停止重复发言。成员不可用时公开阻塞与所需处理。
达到验收标准后结束；不能完成时明确缺失条件，不宣称成功。

启用和验证

在 Room 设置中启用该技能，确认参与成员能承担上述职责。用一份短草稿进行评审，检查交接记录、复核意见和最终文件。

如果需要持久跟踪每一步负责人和验收，另行建立工作图。Skill 中写了职责并不等于已创建结构化任务。