ai_co_discuss 0.3.17 → 0.3.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- interface:
2
- display_name: "讨论主持"
3
- short_description: "主持人同时调用参与技能,围绕关键争点推进讨论并形成有依据的结论"
4
- default_prompt: "使用 $discuss-host 和 $discuss-participant,由当前会话主持这个话题,沿用用户选择的运行方式,组织观点交锋并形成有依据的结论,保留重要分歧。"
1
+ interface:
2
+ display_name: "讨论主持"
3
+ short_description: "主持人同时调用参与技能,围绕关键争点推进讨论并形成有依据的结论"
4
+ default_prompt: "使用 $discuss-host 和 $discuss-participant,由当前会话主持这个话题,沿用用户选择的推进方式,组织观点交锋并形成有依据的结论,保留重要分歧。"
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## 定位与新建
6
6
 
7
- 当前实际会话承担主持,不另建调度聊天。沿用用户指定的房间和运行方式;新讨论尚未选择时,只确认“全自动讨论 / 手动复制冷启动”。入口与推进方式、CLI / App 客户端分别判断。
7
+ 当前实际会话承担主持,不另建调度聊天。沿用用户指定的房间和推进方式;新讨论尚未选择时,只确认“全自动讨论 / 手动复制冷启动”。入口与推进方式、CLI / App 客户端分别判断。
8
8
 
9
9
  未指定房间时,保存目标、背景、参与配置和上限,核验后再接入专家。全自动使用下文启动入口,手动模式沿用 CLI 建房与接入流程。全自动要求主持和专家均具备本地 CLI 读写能力;配置完成后依据用户的启动指令运行,普通建房本身不代表已启动。在线只读专家使用手动接入分工,不静默转换模式。
10
10
 
@@ -48,7 +48,7 @@
48
48
 
49
49
  此示例的主持在 Codex App;若当前是独立 Codex CLI,应使用 `codex_cli`。可执行文件、App 来源聊天或 Sidecar 等缺项仍须来自实际本机配置。主持也须出现在 `experts` 中并设为 `cli`。示例中的上限不能覆盖用户已经指定的参数;总时长为 0 时可不限总时长运行,按轮次上限或手动停止结束。单次执行默认 0(不限),主动设置的单次执行超时仍有效。只有用户另设本次时长时才提供顶层 `minutes`,不能用它延长房间既定截止。
50
50
 
51
- 已有房间改为指定顶层 `room_id`,省略 `room`;受保护房间另提供原私有配置的 `access_file` 路径,不读取或打印令牌。首次启动命令不替代已暂停房间的继续操作,已有运行按当前房间状态接续。
51
+ 已有房间改为指定顶层 `room_id`,省略 `room`,并提供原私有配置的 `access_file` 路径(含房间控制凭据),不读取或打印令牌。首次启动命令不替代已暂停房间的继续操作,已有运行按当前房间状态接续。
52
52
 
53
53
  ### 启动与交接
54
54
 
@@ -27,7 +27,7 @@ description: "AI CoDiscuss 的通用参与技能,所有参与者(包括主
27
27
  1. **不读取或打印凭据内容**,token 不进入提示或房间。每个成员只用自己的凭据,AI 不借用用户身份发言,房主控制凭据不能代替成员署名。(身份与权限由网站按凭据校验。)
28
28
  2. **执行失效后不再写入**:暂停、到期或被打断的旧任务保留草稿并结束,不换身份、职责或编号绕过拒绝,也不去掉 `--execution` 改作普通发言。任务文件的 `stopped_executions` 列出你此前被用户停止或跳过的执行:会话里如有它们未完成的工作,不接着做、不为它们补交,只处理本次请求。(失效的执行若还能产生可见结果,用户的打断与暂停就失去意义。)
29
29
  3. **写入前定好 `--submission-id`**:同次重试沿用编号和原内容,新内容换新编号;结果不明时先按原编号查询,再按 [写入与恢复](references/writing.md) 处理。(网站靠它去重,换号会产生重复发言。)
30
- 4. **不创建定时任务、不操作其他软件、不发运行回执**(就绪、开始、完成、停止等说明),除非用户要求或出现需要记录的异常;回执不能作为观点、完成或共识的证据。(这些动作有副作用,回执只会淹没真正的回答。)
30
+ 4. **不创建定时任务、不操作其他软件、不发状态回执**(就绪、开始、完成、停止等说明),除非用户要求或出现需要记录的异常;回执不能作为观点、完成或共识的证据。(这些动作有副作用,回执只会淹没真正的回答。)
31
31
 
32
32
  ## 命令入口与身份
33
33
 
@@ -38,6 +38,6 @@ codiscuss message post ROOM --as 本人 --kind chat --execution 执行编号 --b
38
38
  codiscuss message post ROOM --as 本人 --kind chat --request 请求编号 --body-file draft.md --submission-id 新UUID --access-file FILE
39
39
  ```
40
40
 
41
- 需要摘要时一并使用 `--summary` 或 `--summary-file`。成功提交后当前请求即完成;不要再补一条普通 chat 或运行回执。
41
+ 需要摘要时一并使用 `--summary` 或 `--summary-file`。成功提交后当前请求即完成;不要再补一条普通 chat 或状态回执。
42
42
 
43
43
  任务执行失败时,用 `execution fail ROOM 执行编号 --reason 原因 --access-file FILE` 失败本次执行并保留草稿。该操作只处理当前请求,不自动暂停整场讨论;主持人会收到专家请求失败并判断后续安排。不要改用其他成员、请求编号或身份绕过拒绝。
@@ -21,7 +21,7 @@
21
21
  | 自由协作回答或讨论专家回答 | `message post --kind chat`;自动执行使用 `--execution 执行编号`,手动成员使用 `--request 请求编号` |
22
22
  | 主持说明 | `message post --kind moderation`,仅主持人在允许的房间状态下使用;该消息本身不结束讨论 |
23
23
  | 网页来源成员代发(自由协作或讨论) | 使用 `message post --kind chat --author 网页成员`,讨论回答同时用 `--request 请求编号` 关联安排 |
24
- | 创建 / 维护话题 | `room create` / `room update`;`--experts-file` 会替换完整参与配置 |
24
+ | 创建 / 维护话题 | `room create` / `room update`;成员请通过成员管理调整 |
25
25
  | 安排发言 / 取消 | `turn create` / `turn cancel`;同房间只能有一个未完成安排 |
26
26
  | 创建或继续安排 | `turn roster` 读取最新名单与 `revision`,随后 `turn create` 或 `turn continue` 携带该版本 |
27
27
  | 保存摘要 | `state set`,`--until` 只覆盖实际已读消息 |
@@ -49,4 +49,4 @@
49
49
 
50
50
  这些核对覆盖网站 HTTP 写入;浏览器向在线专家发送问题时,由主持人另行核对实际送达结果。
51
51
 
52
- 自动任务的状态以本次执行及服务端请求状态为准;不要创建原生定时任务或补写运行回执。影响协作的异常直接向用户报告。
52
+ 自动任务的状态以本次执行及服务端请求状态为准;不要创建原生定时任务或补写状态回执。影响协作的异常直接向用户报告。