ai_co_discuss 0.3.56 → 0.3.58

package/.agents/skills/discuss-host/references/dev-flow.md

@@ -4,7 +4,6 @@
 
 - **先定计划再派活**：与用户谈清目标后写一份计划文档（目标、按目录或文件划分的分工、接口约定、验收方式），写入项目里用户指定的位置；用户未表示可以开始时不派活。
 - **按文件划分**：派活时写明每位成员负责的目录或文件和对应的计划章节；需要并行的部分事先约定接口，避免两人改同一文件。
-- **要接力就让它回到你**：只点名一位成员时，它的回答默认直接给用户；之后还要交给评审或安排下一步时，派活加 `--handoff`（API 为 `handoff: true`），它做完你会再被唤醒。点名多位时总会回到你。
-- **实现后评审**：实现成员结束后，按 `descriptions` 交给负责评审的成员，写明计划文档位置和本次改动的范围（`room view` 的执行报告列有改动文件），并加 `--handoff` 取回评审结论。
+- **实现后评审**：实现成员结束后，按 `descriptions` 交给负责评审的成员，写明计划文档位置和本次改动的范围（`room view` 的执行报告列有改动文件）；评审结论会交回你。
 - **返工回原实现者**：评审提出问题时交回原实现者修改，再请评审复核；同一问题反复不通过，或本链剩余轮数（`free.chain_rounds` 里本链的 `allowed` 减 `used`）不够完成下一轮时，停下向用户说明分歧与现状。
 - **最后整理文档**：评审通过后，再交给负责文档的成员同步说明；向用户汇报时列出各步结果和仍未验证的部分。

package/.agents/skills/discuss-host/references/free.md

@@ -1,38 +1,42 @@
-# 自由协作主持
-
-仅用于自由协作房间的主持人（任务 `role` 为 `host`）。成员的回答与提交方式见参与技能的自由协作一节。
-
-## 请求类型
-
-任务的 `request_purposes` 说明每条请求为何交给你：
-
-- `route`：用户未点名的消息，或全体调度交回的原问题，由你回答或分派；全体调度未代办时仍须读取原文，再决定安排。
-- `handoff`：你派出并要求交回的成员都已结束，据结果决定下一步。
-- `all`：用户请全体成员各自回应一次，其他成员已同时收到；你只回答自己的部分，不加 `--to`。
-- `goal_start`、`goal_continue`：用户开启了 Goal，按 [Goal 模式主持](goal.md) 处理。
-- `discuss_start`：用户发了 `/discuss`，等你补全讨论目标后开启讨论。消息带了文本时以原文为准，只整理措辞；没带时从最近对话提炼，提炼不出明确的讨论问题就不开启，直接回答并说明缺什么。开启：`run start ROOM --request 请求编号 --goal-file 草稿`，上限用房间默认值，你不设置。然后照常简短回答；之后程序会给你讨论主持任务，按 [讨论主持](discussion.md) 安排发言。
-
-先 `room view` 看成员与状态，再决定由谁处理。
-
-任务若有 `scheduler_suggestions`，按其中的 `request_id`、`message_id` 先读原问题；`applied:false` 表示未自动生效，`actual_action:unverified` 表示动作结果尚未核验。需要依据时用 `state decision ROOM DECISION_ID` 读取 `decision_id` 对应的完整判断，再自行决定；“没有模型判断”或没有记录编号时，不假定模型已经给过建议。
-
-## 派活
-
-- 需要他人时在回答中加 `--to 显示名`（可重复，不能点名自己），写明各自负责的文件或模块；不需要他人时不加，本次即结束。
-- 只点名一位成员时，它的回答直接面向用户；还要按结果安排下一步（如再交评审）时加 `--handoff`，它做完你会再被唤醒。派评审、验证这类结论要回到流程里的工作时默认加：不加则结论只停在用户面前，房间不会自动继续。点名多位时，全部结束后总会回到你汇总。
-- 需要预先指定实现后的只读评审时，先读 `review roster ROOM`，再在派实现的 `message post` 中带 `--next-review NAME --review-scope 范围 --review-roster REVISION`；评审者不能是本批实现者。授权与实现任务同时保存，自动要求该批交回主持人。候选目前限程序启动的 Codex CLI；没有合格成员时读取结果给出原因。
-- 收到 `review_handoffs` 时，先用 `review ready ROOM --batch ID` 读取完整委派、交付和报告，确认可交既定评审后用 `review advance ROOM --batch ID --revision REV --submission-id UUID --as 本人` 推进。只处理该批交接，其他请求继续完成；状态变化须重读，不能替换评审者或扩大权限。能力失效、额度不足、交付不完整等原因保留在读取结果和任务中。实际投递前本机复核只读权限与能力版本，失败撤销该次评审并交回主持人。
-- 收到 `handoff` 后交给其他成员或汇总给用户；成员的回答已完整时只用一两句说明完成，不复述。
-- 几位成员要按固定先后接力、后一位依赖前一位的结果（写完再审、实现后评审）时，派活加 `--sequential`，`--to` 按接力顺序点名：程序在每位答完后直接交给下一位，最后一位答完交回你，中间不唤醒你。每一棒算一轮，派活前确认剩余轮数够走完。派活正文要把每一棒做什么、按什么标准交给下一棒写清楚，后面的成员靠它和前一棒的回答工作。
-- 要“改完再审、审到通过为止”时再加 `--loop`：每走完一圈，交回你的 `handoff` 带 `sequence.phase: checkpoint`。本圈最后一位明确要求返工时，用 `sequence continue ROOM --request 该交接请求编号 --as 本人` 开始下一圈（程序直接接着走，你本次即结束）；认可、只剩可不采纳的建议、需要你或用户裁定时，不继续，直接验收或说明。开启智能调度时，它会先替你判断检查点，只有明确返工才自动开始下一圈，其余仍交给你；任务的 `scheduler_suggestions` 记着它的判断。`sequence view ROOM ID` 可读本圈各棒原文。轮数用尽时循环停下，由用户决定是否继续。
-- 同一条用户消息最多推进若干轮（`room view` 的 `free.max_rounds`，本链已用见 `free.chain_rounds`，用户可调）：你派一次活算一轮，成员做完交回给你汇总不另计。到上限时你的下一次派活会被暂存、任务链停下，由用户决定继续或发新消息；你不能自己加轮。派活前先想清楚需要几位、几轮，最后一轮留给汇总。（上限防止 AI 之间无人值守地来回转交。）
-
-用户请成员分工改代码（定计划、实现、评审、整理文档）时，先读 [开发协作](dev-flow.md)。
-
-## 工作流
-
-本次任务有 `workflow` 字段时，本房间启用了用户的工作流。它像技能一样按需使用：`workflow.description` 是它的用途，请求与用途相符或用户要求按它做时才用，其他请求照常处理。要用时，本会话还没读过、或 `workflow.revision` 与上次读到的不同，才读 `workflow.skill_path`（API 主持人读系统提示中的工作流正文）；否则沿用已读内容。按它组织工作时，`workflow.members` 列出每张卡片现在由哪位成员担任、是否在场、项目权限；只点名在场的成员，缺某个角色时在回答里说明缺谁，不另找成员代替。工作流只带来做法和成员，不扩大你的权限。
-
-本次任务（本地任务文件或 API 的 `task`）没有 `workflow` 字段时，不按任何工作流做事，即使会话里读过。
-
-用户请你把本房间的做法存成工作流（或要你按某种分工新建一套流程）时，按 [workflow-creator](../../workflow-creator/SKILL.md) 技能做。任务有 `host_workflows: true` 时，房主已允许你自行保存并启用，不必等用户导入。
+# 自由协作主持
+
+仅用于自由协作房间的主持人（任务 `role` 为 `host`）。成员的回答与提交方式见参与技能的自由协作一节。
+
+## 请求类型
+
+任务的 `request_purposes` 说明每条请求为何交给你：
+
+- `route`：用户未点名的消息，或全体调度交回的原问题，由你回答或分派；全体调度未代办时仍须读取原文，再决定安排。
+- `handoff`：你派出的成员都已结束（含失败），据结果决定下一步。
+- `notice`：程序发现了要你处理的事，请求所在消息写明是什么：成员执行失败、依次派活某一棒失败、冲突或可能冲突（重叠的执行都改了同一文件；“冲突”表示双方都用编辑工具写过，“可能冲突”表示无法确认是谁改的）、重试后的结果，或你上次要求的续跑。先读相关原文和 `room view`，再决定重试、改派、核实修正，或告诉用户需要他定什么。你已有待处理请求时，程序只把通知写进记录、不另建请求：处理任何请求时，新消息里作者为“系统”的通知同样要处理。你派出的同一批成员改了同一文件不另发通知，收到 `handoff` 时看 `room view` 的 `free.conflicts`。
+- `all`：用户请全体成员各自回应一次，其他成员已同时收到；你只回答自己的部分，不加 `--to`。
+- `goal_start`、`goal_continue`：用户开启了 Goal，按 [Goal 模式主持](goal.md) 处理。
+- `discuss_start`：用户发了 `/discuss`，等你补全讨论目标后开启讨论。消息带了文本时以原文为准，只整理措辞；没带时从最近对话提炼，提炼不出明确的讨论问题就不开启，直接回答并说明缺什么。开启：`run start ROOM --request 请求编号 --goal-file 草稿`，上限用房间默认值，你不设置。然后照常简短回答；之后程序会给你讨论主持任务，按 [讨论主持](discussion.md) 安排发言。
+
+先 `room view` 看成员与状态，再决定由谁处理。
+
+任务若有 `scheduler_suggestions`，按其中的 `request_id`、`message_id` 先读原问题；`applied:false` 表示未自动生效，`actual_action:unverified` 表示动作结果尚未核验。需要依据时用 `state decision ROOM DECISION_ID` 读取 `decision_id` 对应的完整判断，再自行决定；“没有模型判断”或没有记录编号时，不假定模型已经给过建议。
+
+## 派活
+
+- 需要他人时在回答中加 `--to 显示名`（可重复，不能点名自己），写明各自负责的文件或模块；不需要他人时不加，本次即结束。
+- 派出的工作无论点名几位，全部结束（含失败）后都会交回你，由你接着安排或汇总。只点名一位、它的回答已足以直接给用户（简单问答、无需验收）时可加 `--no-handoff`（API 为 `no_handoff: true`），做完不再交回；失败仍交回你。要评审、验证或接着安排的不要加。
+- 发现还要继续、但本次执行不便接着做时（如等成员的结果之外还要复查、分几步推进），回答加 `--continue 继续做什么`（API 为 `continue`）：房间没有其他进行中的工作时，程序再唤醒你一次。你下次回答不带它、或用户发了新消息，就取消。不要用它等用户回复；需要用户定的事直接在回答里问。它只管一次续跑；用户开启了 Goal 时由 Goal 负责空闲续跑，不必再加。
+- 需要预先指定实现后的只读评审时，先读 `review roster ROOM`，再在派实现的 `message post` 中带 `--next-review NAME --review-scope 范围 --review-roster REVISION`；评审者不能是本批实现者。授权与实现任务同时保存，自动要求该批交回主持人。候选目前限程序启动的 Codex CLI；没有合格成员时读取结果给出原因。
+- 收到 `review_handoffs` 时，先用 `review ready ROOM --batch ID` 读取完整委派、交付和报告，确认可交既定评审后用 `review advance ROOM --batch ID --revision REV --submission-id UUID --as 本人` 推进。只处理该批交接，其他请求继续完成；状态变化须重读，不能替换评审者或扩大权限。能力失效、额度不足、交付不完整等原因保留在读取结果和任务中。实际投递前本机复核只读权限与能力版本，失败撤销该次评审并交回主持人。
+- 收到 `handoff` 后交给其他成员或汇总给用户；成员的回答已完整时只用一两句说明完成，不复述。
+- 几位成员要按固定先后接力、后一位依赖前一位的结果（写完再审、实现后评审）时，派活加 `--sequential`，`--to` 按接力顺序点名：程序在每位答完后直接交给下一位，最后一位答完交回你，中间不唤醒你。每一棒算一轮，派活前确认剩余轮数够走完。派活正文要把每一棒做什么、按什么标准交给下一棒写清楚，后面的成员靠它和前一棒的回答工作。
+- 要“改完再审、审到通过为止”时再加 `--loop`：每走完一圈，交回你的 `handoff` 带 `sequence.phase: checkpoint`。本圈最后一位明确要求返工时，用 `sequence continue ROOM --request 该交接请求编号 --as 本人` 开始下一圈（程序直接接着走，你本次即结束）；认可、只剩可不采纳的建议、需要你或用户裁定时，不继续，直接验收或说明。开启智能调度时，它会先替你判断检查点，只有明确返工才自动开始下一圈，其余仍交给你；任务的 `scheduler_suggestions` 记着它的判断。`sequence view ROOM ID` 可读本圈各棒原文。轮数用尽时循环停下，由用户决定是否继续。
+- 同一条用户消息最多推进若干轮（`room view` 的 `free.max_rounds`，本链已用见 `free.chain_rounds`，用户可调）：你派一次活算一轮，`--continue` 的续跑也算一轮，成员做完交回给你汇总不另计；程序发现问题的通知不计轮数，到上限后照样交给你。到上限时你的下一次派活会被暂存、任务链停下，由用户决定继续或发新消息；你不能自己加轮。派活前先想清楚需要几位、几轮，最后一轮留给汇总。（上限防止 AI 之间无人值守地来回转交。）
+
+用户请成员分工改代码（定计划、实现、评审、整理文档）时，先读 [开发协作](dev-flow.md)。
+
+## 工作流
+
+本次任务有 `workflow` 字段时，本房间启用了用户的工作流。它像技能一样按需使用：`workflow.description` 是它的用途，请求与用途相符或用户要求按它做时才用，其他请求照常处理。要用时，本会话还没读过、或 `workflow.revision` 与上次读到的不同，才读 `workflow.skill_path`（API 主持人读系统提示中的工作流正文）；否则沿用已读内容。按它组织工作时，`workflow.members` 列出每张卡片现在由哪位成员担任、是否在场、项目权限；只点名在场的成员。`workflow.missing` 列出启用后才新增、还没有成员的卡片：本次要用到时，运行 `<cli> launch workflow-join --card 卡片ID --access-file <本次任务的 access_file>`（多张用逗号分隔），返回的 `members` 给出新成员名，本次执行里就能点名；API 主持人没有命令行，在回答里请用户在右栏点工作流的“刷新”。成员离开或被移除的角色不要自行请回，在回答里说明缺谁，不另找成员代替。工作流只带来做法和成员，不扩大你的权限。
+
+本次任务（本地任务文件或 API 的 `task`）没有 `workflow` 字段时，不按任何工作流做事，即使会话里读过。
+
+用户请你把本房间的做法存成工作流（或要你按某种分工新建一套流程）时，按 [workflow-creator](../../workflow-creator/SKILL.md) 技能做。任务有 `host_workflows: true` 时，房主已允许你自行保存并启用，不必等用户导入。
+
+用户请你启用工作流库里已有的工作流（如“启用工作流「连载」（`novel-serial`）”）时：任务有 `host_workflows: true` 就运行 `<cli> launch workflow-adopt --id <工作流 ID> --access-file <本次任务的 access_file>`，程序在本房间启用它、邀请缺少的卡片成员（离开的请回），返回 `members`（卡片 ID → 成员名）和 `skill_path`；本次执行要接着按它做时读 `skill_path`，下一次执行起任务里有 `workflow` 字段，按上文使用。用户只说了启用、没给具体任务时，回答说明已启用和带来了谁即可。没有该字段，或你是 API 主持人（没有命令行）时，不能启用：在回答里请用户在电脑上“成员与设置 → 协作设置”打开“允许主持人自建工作流”后再让你启用。

package/.agents/skills/discuss-participant/references/free.md

@@ -12,6 +12,10 @@
 
 任务的请求带 `sequence` 时，你是主持人安排的依次接力中的一棒：`sequence.message_id` 是主持人的安排原文，`request_messages` 是上一棒的回答；按安排完成你这一棒，答完程序直接交给 `sequence.next`（没有则交回主持人），不要等别人或自己点名下一位。
 
+## 主动发言
+
+不是房间派来的任务、而是用户在你自己的窗口里要你在房间发言时，用 `message post ROOM --as 本人 --kind chat --proactive --access-file FILE` 提交（凭据用你最近一次任务的 access_file）。它不关联执行或请求，房间里标为“主动发言”；你有进行中的执行时改用本次执行回答；还有待处理的请求时也不能主动发言（手动接入的用 `--request` 回答，程序启动的等本机服务交给你）；讨论进行中不可用。普通成员的主动发言不能派活；主持人可以同时 `--to` 派活或 `--continue`，从这条消息起算一条新任务链，同样受轮数上限约束。
+
 ## 共享工作目录
 
 多位成员共享同一工作目录时，只改分给自己的文件；只提交自己的改动，切分支、reset、全仓 stash 或 checkout 须用户确认。（目录不加锁，越界改动会覆盖别人的工作。）

package/.agents/skills/workflow-creator/SKILL.md

@@ -23,7 +23,7 @@ description: AI CoDiscuss 工作流的创建与修改技能。用户要把房间
 2. **设计**：按下面“写什么、放哪里”决定 SKILL.md 和每张卡片的内容。
 3. **按格式写**：见“格式”。
 4. **校验并保存**：见“校验与保存”，按报错修正，直到通过。
-5. **修改已有工作流**：先读现有文件，沿用同一 ID，优先局部调整；保存后，启用它的房间从成员下一次执行起读到新内容。
+5. **修改已有工作流**：先读现有文件，沿用同一 ID，优先局部调整；保存后，启用它的房间从成员下一次执行起读到新内容；新增的卡片不会自动加入这些房间，由主持人用到时补齐，或由用户在右栏点工作流的“刷新”。
 
 ## 写什么、放哪里