本实践说明如何把 @Waker 作为团队在 IM 中的统一工作入口。连接完成后，群成员始终 @ 同一个机器人或已连接账号；QoderWake 在后台识别任务、选择合适的 Waker，并通过同一个 IM 身份把进度和结果送回原会话。
@Waker 适合执行、跟进和交付任务，例如修改代码、整理方案、分析数据和生成文档。「群聊答疑专员」适合依据知识回答高频问题。两者可以服务同一个团队，但解决的问题不同。
先选择协作方式
| 协作方式 | 如何触发 | 适合的工作 |
|---|
| 群聊机器人或已连接账号 | 在群内 @ 统一入口并描述任务 | 多人共同跟进的项目交付、故障处置和运营协作 |
| IM 单聊 | 直接发送消息，无需 @ | 个人资料整理、方案准备、连续修改和私下确认 |
一个机器人如何连接多位 Waker
一个群只接入一个机器人或账号作为统一入口。群成员不需要知道背后配置了多少 Waker，也不用记住每个角色的入口。每条 @ 消息到达后，系统依次完成以下判断：
- 这条消息是在创建新任务，还是继续、查询、修改或取消已有任务。
- 如果是新任务，消息是否明确指定了 Waker 或职责。
- 如果没有指定，路由规则是否能够匹配；仍无法匹配时，由默认 Waker 响应或先向用户澄清。
- 任务交给选中的 Waker 执行，状态中显示实际执行者；回复仍由同一个机器人或账号发回原群。
群内讨论 → @ 同一个机器人 → 识别任务关系 → 路由到合适的 Waker
→ 同一个机器人返回进度和结果 → 人工确认 → 继续原任务
通用配置方法
一个会话建议配置 2～4 个职责互补的 Waker：
- 为每个 Waker 写清“负责什么”和“不负责什么”，避免使用“综合助手”一类宽泛名称。
- 选择一个能够承接通用请求、判断意图并发起澄清的默认 Waker。
- 用路由规则写明各类工作由谁负责，并为代码合并、生产变更、对外发布等动作设置人工确认边界。
- 分别配置响应模型、工作目录和文件权限。每个 Waker 只访问完成其职责所需的目录。
- 保存后确认会话为
活跃，并开启 @Waker。在测试群中用同一个机器人连续发起两类任务，确认状态显示了不同的执行 Waker，回复身份保持不变。
在开通 @Waker 时选择会话和响应 Waker，并设置默认 Waker、模型和相关权限。
如果页面提供「检测职责冲突」，上线前运行一次。出现冲突时，先缩小角色职责，再在路由规则中补充优先级。
场景一：在项目群推进研发交付
这个场景适合需求评审、实现、测试和发布准备都在同一个群里协作的团队。机器人负责接住群内结论并持续推进，项目负责人仍保留范围、合并和上线的决定权。
配置分工
| Waker | 负责 | 不负责 |
|---|
| 项目协调（默认） | 拆分需求、整理排期、汇总进度和风险 | 不修改业务代码 |
| 研发执行 | 阅读代码、定位问题、实现修改和运行测试 | 不决定需求范围，不直接发布生产环境 |
| 测试验收 | 设计用例、执行回归、整理验收结论 | 不代替负责人批准上线 |
需求拆分、排期和进度汇总交给项目协调；代码、构建和故障定位交给研发执行；测试用例、回归和验收结论交给测试验收。代码合并和正式发布必须等待人工确认。
操作流程
1. 把讨论结论变成任务
团队先在群内正常讨论，负责人确认范围后再 @ 统一机器人：
产品负责人（普通消息）：本次只调整优惠券叠加校验，不改变领券流程。
研发负责人：@项目机器人 新任务：根据上面的讨论拆分本次交付工作。
交付：研发、测试和发布准备清单，包含负责人、依赖、验收标准和风险。
约束：本周五前完成；暂不修改代码。
2. 确认计划后并行推进
负责人确认拆分结果后，仍然 @ 同一个机器人发起不同工作：
研发负责人：@项目机器人 新任务：检查订单服务的叠加校验实现，按已确认方案修改并运行单元测试。不要合并代码。
测试负责人：@项目机器人 新任务：根据刚才的验收标准补充边界用例，与代码修改任务并行处理。
3. 在原群跟进同一项任务
研发负责人：@项目机器人 查询代码修改任务的进度，不要新建任务。
研发负责人：@项目机器人 继续代码修改任务：再检查一次兼容旧优惠券的逻辑。
4. 在关键动作前保留人工确认
代码合并、发布和生产变更不要和分析任务放在同一条消息中。Waker 先返回准备结果、风险和回滚方案，负责人确认后再继续原任务。
群聊中的确认消息也必须 @ 同一个机器人，并明确它是在继续哪项任务：
研发负责人：@项目机器人 继续构建排查任务：
确认修改并运行测试，但不要合并代码。
钉钉群聊中，同一个「项目机器人」先后把计划整理和构建排查路由给不同 Waker；执行 Waker 显示在任务状态中，消息始终由同一个机器人返回。
场景二：在 IM 单聊中连续完成个人工作
单聊适合先完成材料整理、方案草稿或数据分析，再把结论带回团队群。只有一个主要角色时，只配置一个默认 Waker；任务跨度较大时，再增加职责明确的专业 Waker。
配置分工
个人工作助理（默认）：整理材料、形成方案、持续修改交付内容。数据分析（可选）：处理表格、指标和数据结论；只访问指定数据目录。
操作流程
单聊无需 @。第一条消息创建任务，后续消息明确写“继续”即可沿用上下文：
新任务：把附件中的客户访谈记录整理成需求摘要。
交付：按“问题、证据、建议、待确认事项”输出，并生成一份 Markdown 文件。
约束：隐去姓名和联系方式，不补写访谈中没有的结论。
继续刚才的访谈摘要：把建议按影响和实施成本排序。
新任务：让数据分析处理附件中的反馈统计，与访谈摘要任务分开。
钉钉单聊中，生成文档以可点击链接随结果返回；后续消息继续原任务并更新同一份产物。
@Waker 可以交付本次任务生成的文档、图片和表格。钉钉当前会把产物上传到钉钉文件空间，为接收方添加下载权限，并在同一条回复中返回可点击链接；不会显示成原生文件气泡。飞书等渠道的展示方式，以及是否需要开启「自动发送产物文件」，以连接配置为准。代码改动不会作为附件发送。
场景三：在故障群辅助定位和恢复
故障群需要快速形成共同事实、并行排查原因和准备可审阅的恢复方案。一个机器人承接所有请求，后台 Waker 分工处理；任何生产操作都必须经过人工确认。
配置分工
| Waker | 负责 | 不负责 |
|---|
| 故障协调（默认） | 汇总时间线、影响范围、当前进展和待办 | 不执行系统变更 |
| 研发排查 | 分析代码、错误栈和近期变更 | 不直接操作生产环境 |
| 运维分析 | 检查监控、日志和资源状态，提出恢复步骤 | 未经批准不执行重启、扩容或发布 |
影响范围、时间线和进展汇总交给故障协调；代码、错误栈和版本变更交给研发排查；监控、日志、容量和恢复方案交给运维分析。任何生产变更只输出步骤、风险和回滚方案，等待人工确认后再执行。
操作流程
1. 先建立事件摘要
值班负责人：@故障机器人 新任务：建立事件摘要。
现象：14:05 起订单提交失败率升高，受影响范围待确认。
输入：脱敏日志和监控截图见附件。
交付：时间线、影响范围、已知事实、待验证假设和下一步负责人。
约束：不要执行重启、扩容、回滚或发布。
2. 并行创建技术排查任务
研发负责人：@故障机器人 新任务：对比最近一次发布，定位与错误栈相关的变更。只输出证据和修复建议。
值班负责人：@故障机器人 新任务：检查监控和日志，给出恢复方案、风险和观察指标。不要执行方案。
3. 汇总结论并申请确认
值班负责人：@故障机器人 继续事件摘要任务：纳入研发和运维结论，列出需要人工批准的恢复动作及回滚方式。
钉钉群聊中，同一个「故障机器人」把事件汇总和日志分析分派给不同 Waker，结果由同一机器人返回，并保留人工审批。
不要发送未脱敏的日志，也不要用“尽快恢复”代替明确的禁止操作和审批边界。
场景四：在运营群完成内容生产
这个场景适合从选题、撰写、数据核对到发布审核的协作。群成员始终使用同一个“运营机器人”，最终对外发布仍由人确认。
配置分工
内容策划（默认）：理解目标人群、拆解选题、撰写和修改内容。数据分析：核对数据来源、统计结果和图表口径。审核发布：检查事实、敏感信息、链接、素材授权和发布清单；不自动对外发布。
操作流程
运营负责人：@运营机器人 新任务：根据附件中的公开产品资料撰写发布稿初稿。
目标读者：首次使用产品的研发团队。
交付：标题备选 3 个、正文初稿、配图清单和待确认事实。
约束：不使用内部链接和未公开数据，不直接发布。
运营负责人：@运营机器人 新任务：核对已完成发布稿中的指标和来源。
交付：需要修订或确认的清单。
约束：不改写正文。
运营负责人：@运营机器人 新任务：对已完成发布稿进行上线前检查。
检查：事实、敏感信息、链接和素材授权。
约束：保留所有待人工确认项，不直接发布。
可复用的消息结构
通常不需要指定执行者，直接说明任务即可：
@机器人 [新任务 / 继续任务 / 查询进度 / 修改任务 / 取消任务]
目标：这次要解决什么问题
输入：文件、链接、目录或已确认结论
交付：需要返回的内容、文件和完成标准
约束：禁止操作、权限边界、截止时间和人工确认点
执行者：仅在需要覆盖自动路由时指定 Waker 或职责（可选）
| 意图 | 推荐写法 |
|---|
| 继续原任务 | “继续刚才的构建排查，再检查依赖版本。” |
| 创建独立任务 | “新任务：整理发布说明，与前面的排查无关。” |
| 查询进度 | “查询构建排查任务的进度，不要新建任务。” |
| 修改任务 | “把交付改为只输出修复方案，暂不改代码。” |
| 取消任务 | “取消刚才的发布说明任务。” |
上线检查和持续维护
先在测试群完成以下检查，再逐步扩大使用范围：
- 群里只出现一个机器人或账号；不同任务能够路由到不同 Waker，任务状态显示实际执行者。
- 普通群消息不会触发任务，正确 @ 后可以参考近期讨论。
- 继续、新任务、查询进度、修改和取消都指向正确任务。
- Waker 只能访问允许的工作目录，代码合并、生产变更和对外发布保留人工确认。
- 返回群内的文本、图片和文件不包含凭据、个人信息或跨群数据。
会话稳定运行后，可以使用 任务记录 查看发起人、状态、总结和交付文件；有相关数据时，还可以查看 话题记录 和 群聊记忆。记忆只保留长期稳定的团队约定、项目边界和交付格式，不保存临时进度、访问令牌、个人敏感信息或未经确认的结论。
每次调整响应 Waker、默认 Waker、模型、工作目录、权限或路由规则后，都用同一个机器人重新验证一条默认路由和一条专业路由消息。 
单聊也不是凭据通道。密码、Token、客户隐私和其他敏感信息仍应通过受保护的凭据或数据连接提供。
