# 编写 Room Skill

为多 Agent 协作编写职责、通信和结束规则。

## 什么时候使用 Room Skill

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

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

## 必须写清楚的内容

Room Skill 应包含以下内容。

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

## 公开与私下协作

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

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

## 提及与任务记录

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

## 发布前检查

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

完整工具选择与通信规则见 [Room Skill 编写指南](https://github.com/nexus-research-lab/nexus/blob/main/docs/guides/room-skill-authoring.md)。

## 最小可导入示例

创建一个目录并把下面内容保存为 `SKILL.md`，再通过[技能页](/docs/skills)导入。

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

## 开始条件

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

## 协作流程

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

## 通信和停止

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

## 启用和验证

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

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