docs: align CSM terminology with code
This commit is contained in:
34
plans/CSM.md
34
plans/CSM.md
@@ -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 id(callback 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` 覆盖
|
||||
|
||||
形成一个完整闭环:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user