docs: align CSM terminology with code

This commit is contained in:
nav
2026-03-30 18:24:24 +00:00
parent 3b5ca21f40
commit 4dde4f6efe

View File

@@ -13,10 +13,10 @@
本方案采用:
- 由发起讨论的 Agent 直接调用 `create private channel`
- 由发起讨论的 Agent 直接调用 `discord_channel_create`
- 为该工具新增两个可选参数,以标记“讨论模式”
- 由插件侧 moderator bot 用纯字符串拼接方式驱动讨论流程
- 由发起讨论的 Agent 在讨论结束时显式调用新工具 `discuss-callback`
- 由发起讨论的 Agent 在讨论结束时显式调用新工具 `discuss-callback`
- 回调后关闭讨论 channel并唤醒原工作 channel 继续处理
---
@@ -31,7 +31,7 @@
4. 讨论结果能回传到原工作 channel
5. 讨论结束后,讨论 channel 不再继续处理任何 Agent 发言
6. moderator bot 不使用任何模型,所有发言均为固定模板/字符串拼接
7. 整个机制尽量复用现有插件顺序讨论能力
7. 整个机制尽量复用现有插件中的 turn-manager 轮转发言能力
---
@@ -55,16 +55,16 @@
- 由工作中的 Agent 主动创建
- 创建时提供原工作 channel idcallback channel id和讨论指引discuss guide
- 插件识别该频道为特殊讨论频道
- moderator bot 在频道中发布一条固定 kickoff message说明
- moderator bot 通过插件内部 `sendModeratorMessage(...)` 在频道中发布一条固定 kickoff message说明
- 讨论目的
- 应如何进行讨论
- 结束条件
- 发起讨论的 Agent 在结束时必须写总结文档并调用 `discuss-callback`
- 讨论期间复用现有“顺序讨论”机制驱动 Agent 发言
- 讨论期间复用现有 turn-manager 轮转发言机制驱动 Agent 发言
- 如果轮转一圈无人发言,则 moderator 提醒发起者执行 callback 收尾
- callback 成功后:
- 检查总结文档是否存在,且必须位于发起讨论 Agent 的 workspace 下
- 将讨论 channel 中对应 session 的模型覆盖为 `NO_REPLY`
- 将讨论 channel 中对应 session 的 provider/model override 到 `noReplyProvider` / `noReplyModel`
- 讨论 channel 后续任何消息都不再参与讨论,仅由 moderator 回复“channel 已关闭,仅留档”
- moderator 在原工作 channel 发消息,给出讨论结果文档路径,唤醒原工作流
@@ -72,9 +72,9 @@
## 5. 工具设计
### 5.1 扩展 `create private channel`
### 5.1 扩展 `discord_channel_create`
在现有 `create private channel` 工具上新增两个可选参数:
在现有 `discord_channel_create` 工具上新增两个可选参数:
- `callbackChannelId?: string`
- `discussGuide?: string`
@@ -107,7 +107,7 @@
```text
讨论私密协作 channel 的回调机制,需要明确:
1. create private channel 扩展参数设计
1. `discord_channel_create` 扩展参数设计
2. discuss-callback 工具的行为
3. 讨论结束后的 session 收口方式
4. MVP 范围内的异常处理策略
@@ -147,7 +147,7 @@
## 6. 讨论模式 Channel 的元数据
`create private channel` 以讨论模式创建 channel 时,插件需要记录对应 metadata。
`discord_channel_create` 以讨论模式创建 channel 时,插件需要记录对应 metadata。
建议结构如下:
@@ -234,7 +234,7 @@ After callback:
### 7.2 空转提醒机制
插件当前已有顺序讨论机制。
插件当前已有基于 turn-manager 的轮转发言机制。
现有逻辑:
- 发言列表轮转一圈,如果没有人发言且所有人均回复 `NO_REPLY`,则认为 channel 休眠
@@ -271,7 +271,7 @@ If more discussion is still needed, continue the discussion in this channel.
`discuss-callback` 成功后:
1. 讨论 channel 标记为关闭/完成
2. 讨论 channel 中所有相关 session 的模型覆盖为 `NO_REPLY`
2. 讨论 channel 中所有相关 session 的 provider/model override 到 `noReplyProvider` / `noReplyModel`
3. 后续任何在该 channel 中的发言均不再触发实际讨论流程
4. 如果讨论结束后仍有人发言,由 moderator 统一回复:
- `channel 已关闭channel 仅做留档使用`
@@ -525,7 +525,7 @@ plans/discussions/csm-discussion-summary.md
- 内容包含 callback 操作说明
### 第三步:接入空转提醒
- 复用现有顺序讨论逻辑
- 复用现有 turn-manager 轮转逻辑
- 在讨论模式 channel 中改为空转提醒发起者 callback
### 第四步:实现 `discuss-callback`
@@ -536,7 +536,7 @@ plans/discussions/csm-discussion-summary.md
- metadata 更新
### 第五步:完成关闭逻辑
- 指定 session 模型覆盖为 `NO_REPLY`
- 指定 session 的 provider/model override 到 `noReplyProvider` / `noReplyModel`
- 结束后任何发言统一由 moderator 回复 channel 已关闭
### 第六步:原 channel 唤醒
@@ -565,11 +565,11 @@ plans/discussions/csm-discussion-summary.md
本方案将 Agent 间讨论能力实现为一种“特殊模式的私密 Discord channel”通过
- 扩展 `create private channel`
- 扩展 `discord_channel_create`
- 新增 `discuss-callback`
- 复用现有顺序讨论机制
- 复用现有 turn-manager 轮转发言机制
- 使用纯规则驱动的 moderator bot
- 在指定 session 上临时覆盖 `NO_REPLY` 模型
- 在指定 session 上临时应用 `noReplyProvider` / `noReplyModel` 覆盖
形成一个完整闭环: