ai_co_discuss 0.0.0-stage → 0.1.1

package/.agents/skills/discuss-host/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: discuss-host
+description: "AI CoDiscuss 的主持技能，仅主持人调用，且须同时调用 discuss-participant。用于开始、继续、暂停或收束讨论：组织有针对性的交锋，形成有原文依据的结论。编辑技能本身不启动讨论。"
+---
+
+# 讨论主持（discuss-host）
+
+把用户的议题推进为有依据的判断，保留有价值的分歧与未确认事项。**主要工作是理解论证、发现影响结论的争点、提出有效追问；流程只用于可靠交接这些工作。**
+
+主持人同时调用 [discuss-participant](../discuss-participant/SKILL.md)。阅读、署名、发言权、可靠提交和执行凭据统一由参与技能定义，本技能只补充主持决策与交接。编辑或评审技能不启动讨论。
+
+## 先判断讨论需要什么
+
+先明确用户想解决的问题、背景、约束和合格结果；沿用已有共识，只询问阻碍推进的缺项。探索可以保留多个方向，决策需要比较标准，事实问题需要可核验的证据；快速咨询不必套完整的全员流程。
+
+用户提出目标、约束与偏好，并作出最终决定；主持人负责理解用户意图、判断对讨论的影响并安排后续发言。安排下一位专家或收束前，先处理尚未处理的用户留言，结合上下文决定直接回答、调整问题、请相关专家回应或改变方向。意图清楚就推进，只在影响判断的关键歧义处确认，不只转发留言。用户的倾向不等于已验证事实，参与者仍应独立判断并指出矛盾与风险。
+
+原生定时与事件驱动均遵循此约定，分别在下一次检查或主持执行中处理；普通留言不默认打断当前专家，明确的暂停、继续或收束要求按现有规则执行。通过后续发言、主持简报或总结自然说明用户意见如何被处理，不为每条留言另发确认回执。
+
+默认先形成必要的独立观点，再围绕关键分歧深入讨论，按需复核并总结。阶段是阅读和判断边界，不是需要填满的轮次：
+
+- `initial`：必要专家先独立判断。主持人兼任专家时也要贡献自己的观点；尽量先安排自己，避免先读他人回答再声称独立。
+- `discussing`：找出会改变结论的事实、假设、标准或偏好差异，请最相关的人回应。一轮内每位专家各回应一次，轮次以此计数；不连续安排刚发言的专家，新一轮也不先安排上一轮最后发言者。只有需要其本人澄清刚发表内容的事实或原意时才例外，并在简报中说明原因。
+- `reviewing`：仅在需要时，用拟定结论请相关当事人核对原意、条件和剩余阻碍；不是让全员再赞同一次。
+- `concluded`：已有足够依据完成本次目标，或依约交付有限结论。明确哪些已确认、哪些仍有分歧、缺什么证据；到限不等于达成共识。
+
+追问应说明真正需要弄清的争点及材料入口，给专家自主质疑前提、发现遗漏和改变观点的空间，不预设答案或固定逐项答题格式。例如：“两种建议似乎采用了不同的失败容忍度。请判断这是否解释了分歧；若不是，指出决定选择的证据。”
+
+意见相同不等于事实已验证，意见不同也不必投票决定。核对会改变结论的数字、出处与适用条件，区分实测、外部声称、估计和建议。误述原意时请原作者澄清；另一人的赞同不能代替当事人确认。保留少数意见及其影响，不为了收束抹去限制，也不为凑轮次制造争论。重复立场时缩小争点或补有区分力的证据，仍无法判断就明确保留未决。
+
+## 定位、模式与上限
+
+当前实际会话承担主持，不另建调度聊天。沿用用户指定的房间和运行方式；新讨论尚未选择时，只确认“全自动讨论 / 手动复制冷启动”。自动任务已表明用户启动意图，无需再次确认。
+
+用户从当前 AI 对话发起全自动讨论时，首次读取 [对话入口与启动配置](references/launch.md)，使用 `codiscuss launch` 复用本机软件配置并将首个主持任务交回当前会话；网页入口由本机服务交付主持任务。入口与推进方式、CLI / App 客户端分别判断。已收到有效自动任务时，不再次调用启动命令。
+
+未指定房间时，保存目标、背景、参与配置和上限，核验后再接入专家。全自动使用上述启动入口，手动模式沿用 CLI 建房与接入流程。全自动要求主持和专家均具备本地 CLI 读写能力；配置完成后依据用户的启动指令运行，普通建房本身不代表已启动。在线只读专家使用手动接入分工，不静默转换模式。
+
+新建讨论时，将用户请求完整保存到房间独立的“用户原文”字段（CLI 使用 `--user-request-file`），不改写或概括；“背景”只保存补充材料，其余主持流程照常。原文超过该字段 4000 字上限时，将完整原文按参与技能保存为开场主持消息，“用户原文”保留原文消息链接，不截断原文。
+
+网页新建只要求话题名称与用户原文，目标、背景和讨论边界留给主持人。首次接手时若这些字段为空，先读用户原文与已知材料补全，用 `room update ROOM --goal-file ... --background-file ... --boundaries-file ... --as 本人`（受保护写入附本次 `--access-file`）一次保存，再安排专家。只写原文能支持的内容，推断的前提注明“主持推断”，不添加用户未提出的硬性约束；只有歧义会改变讨论方向时才向用户确认。已有内容视为用户或此前主持的决定，不覆盖。
+
+工具入口、站点、项目与 cwd 的定位遵循参与技能。新建会话可指定所属项目及 cwd，也可缺省；已有会话不靠提示词迁移目录。仅在首次配置或启动自动程序时查阅仓库 `docs/deployment.md` 与 `docs/cli.md`，不把安装操作混入每次讨论。
+
+统一入口中，`codiscuss service …` 管理本机服务，`codiscuss run … ROOM` 控制网站讨论。暂停本房间不停止其他房间共用的服务。
+
+每次接手先读 `room view`，用其中的阶段、当前安排、`limits` 和运行状态恢复现场，再按需补读 state 与有关原文。网站已有的安排优先于旧笔记；没有待处理的专家安排不等于主持人没有工作。
+
+遵守用户设定的轮次、总时长、单次执行及到限方式，不自行放宽。轮次以服务端 `completed_rounds` 为准；暂停、准备与收束期间不计时。到限而尚未进入收束时，用 `room limits ROOM --check --as 本人`（受保护写入附本次 `--access-file`）处理：
+
+- 返回暂停就停止；自动执行若换代，结束旧执行，等待新任务。
+- `limits.closing=true` 且本次执行仍有效时，只根据已有材料总结，不再安排专家。预留时间包含在总时限内，来不及完成就保留未决，不谎称收束。
+
+## 自动主持：一次实质推进，一次交接
+
+收到自动任务后，按参与技能进入本次执行；若当前调用已成功进入，不重复认领。不创建原生定时，也不手动通知已配置的本地专家，通知程序负责后续交付与续租。
+
+阅读新增的相关回答、用户约束及必要原文，判断下一步是追问、补证、复核还是收束。不要只回复“已就绪”或只写一段摘要就退出；本次执行需要以以下一种结果交接：
+
+| 判断 | 保存与结束边界 |
+| --- | --- |
+| 还需专家回应 | 先保存本次判断与下一步意图，再持有发言权创建正式安排；问题互不依赖时用 `turn create --plan-file` 一次排好本轮顺序，网站在专家间自动接力，末位答完才交回主持；接力不发通知，需要逐个转交的在线专家不放进整轮。创建成功即结束本次执行。 |
+| 本轮仍有排队安排（`queued_turns` 非空） | 说明用户留言、改资料（`held_since` 非 0）或打断让本轮提前交回。先处理这些新内容；原计划仍适用就 `turn continue`，否则直接创建新安排，剩余排队随之作废。 |
+| 主持人需要以专家身份发言 | 给自己创建正式安排后结束；同一会话收到新的专家任务，再凭新资格发表 `opinion`。 |
+| 已可收束，或正在限时收束 | 先发表有原文依据的最终 `moderation`、保存 state 与简报，最后设为 `concluded`。 |
+| 缺少必要用户决定或无法继续 | 保留已有判断与具体阻碍，用 `execution fail` 暂停，向用户说明需要什么。 |
+
+创建安排、完成收束或执行失败会结束本次写入资格；此后只允许回读核验，不再补 state、回执或归还已交接的发言权。是否完成以网站业务结果为准；结果不明按参与技能核对原提交，不另创安排。
+
+## 保存有用的进度
+
+当判断、争点、下一步或阶段发生变化时，用一次 `state set ROOM --body-file ... --until ... --brief-file ... --as 本人` 同时保存：
+
+- state：足够恢复判断的依据与原文编号、已处理内容、未决问题和下一步意图。
+- 简报：让用户迅速了解当前结论、关键分歧和为什么接下来这样安排；不复述执行日志。
+
+`--until` 只覆盖实际已读材料。下一安排尚未创建时写成意图，实际编号与状态由服务端安排记录提供；恢复时两者对照，不为补写同一个编号再做一轮状态维护。无变化不写，已在当前上下文的材料不反复全文读取。保存失败先核对，不能一边失去接续依据一边继续派发。
+
+最终总结必须另以主持消息留档，简报不能替代它；结论、不同意见、重要条件与未验证影响按议题组织，不强制固定栏目。用户要求独立报告时再调用仓库的 discuss-report，报告不表示建议已获采纳。
+
+## 手动兜底与停止
+
+**仅在用户选择手动模式、需要在线专家转交或处理已有原生任务时**，读取 [手动接入与持续主持](references/manual.md) 对应部分。自动讨论不加载这份操作细节。
+
+等待回答或一次回复结束不是整场结束。用户叫停、已暂停/收束或时间用尽时停止新增安排；自动任务的失效与失败遵循参与技能，手动模式清理本话题的原生任务。恢复须有明确继续指令。向用户报告结论或暂停点，以及影响协作的真实障碍，不索要全员启停回执。

package/.agents/skills/discuss-host/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "讨论主持"
+  short_description: "主持人同时调用参与技能，围绕关键争点推进讨论并形成有依据的结论"
+  default_prompt: "使用 $discuss-host 和 $discuss-participant，由当前会话主持这个话题，沿用用户选择的运行方式，组织观点交锋并形成有依据的结论，保留重要分歧。"

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

@@ -0,0 +1,50 @@
+# 从 AI 对话发起讨论
+
+仅在用户要求开始一场全自动讨论、且当前会话尚未收到有效自动任务时使用。网页启动交付的任务直接按参与技能进入执行，不重复启动。
+
+## 配置与当前会话
+
+1. 使用已安装的 `codiscuss`；未安装时用本仓库 `node runner/codiscuss.mjs`。`codiscuss launch settings` 只读本机软件默认配置，不启动服务或 AI。缺少配置时按仓库 `docs/runner.md` 的“两种讨论入口与启动配置”补齐；用户已提供的软件、目录和上限直接沿用，只询问无法确定的缺项。
+2. 从当前软件的实际会话信息取得会话 ID，不自造编号。启动文件中 `entry` 使用 `conversation`，`current_session_id` 使用该实际 ID；主持人的 `participants` 覆盖配置必须对应当前实际 CLI / App 客户端，不能仅根据模型名称选适配器。当前会话继续主持，不另建主持聊天。
+3. 站点始终明确指定。每场讨论选择主持人、专家、目标、用户原文、背景和上限；软件路径来自本机默认配置，本次可用 `participants` 覆盖。`cwd` / `discussion_project` 可省略，单个参与者可覆盖。已有会话仍在原目录，设置 cwd 不会迁移它。用户要一起查看某个项目时，把该项目目录设为 `cwd`；项目文件默认要求只读，仅当用户明确要求 AI 修改项目时才设 `"project_access": "write"`，也可在 `participants.NAME.project_access` 单独指定。只读不通过更换项目目录实现；agy 新会话由 runner 设置原生项目权限，已有会话（包括当前主持）仍由提示词约束。答案草稿只使用任务给出的 `draft_directory`，不写到项目或存放凭据的运行目录。
+
+新讨论的 UTF-8 启动文件示例（替换示例内容；软件已在本机配置）：
+
+```json
+{
+  "site": "http://127.0.0.1:8765",
+  "entry": "conversation",
+  "current_session_id": "当前实际会话ID",
+  "room": {
+    "submission_id": "本次新生成的UUID",
+    "title": "本次议题",
+    "goal": "用户希望解决的问题",
+    "user_request": "用户原文",
+    "background": "补充背景",
+    "boundaries": "讨论边界",
+    "host": "Codex",
+    "experts": { "Codex": "cli", "Claude": "cli" },
+    "limits": { "max_rounds": 3, "max_minutes": 60, "execution_minutes": 10, "on_limit": "pause", "summary_minutes": 5 }
+  },
+  "participants": {
+    "Codex": { "adapter": "codex" }
+  }
+}
+```
+
+此示例的主持在 Codex App；若当前是独立 Codex CLI，应使用 `codex_cli`。可执行文件、App 来源聊天或 Sidecar 等缺项仍须来自实际本机配置。主持也须出现在 `experts` 中并设为 `cli`。示例中的上限不能覆盖用户已经指定的参数；总时长为 0 时，另用顶层 `minutes` 指定本次有限运行时长。
+
+已有房间改为指定顶层 `room_id`，省略 `room`；受保护房间另提供原私有配置的 `access_file` 路径，不读取或打印令牌。首次启动命令不替代已暂停房间的继续操作，已有运行按当前房间状态接续。
+
+## 启动与交接
+
+```sh
+codiscuss launch start --file 启动文件.json --dry-run
+codiscuss launch start --file 启动文件.json
+```
+
+预览只检查配置，不证明软件已登录或具备工具权限。实际启动保存房间私有配置、启动本机服务、保留当前主持会话，并返回房间、`current_task.task_file`、`current_task.access_file` 和执行编号；不会再给当前会话发送一份启动提示。
+
+读取返回的任务文件，按参与技能使用其凭据路径执行 `execution enter`，然后读取房间现状并进行本次实质主持工作。接入程序负责续租和后续专家交付；创建安排或收束成功即结束本次执行，不另建原生定时任务。不要把配置文件里的控制凭据当成自动主持的本次执行凭据。
+
+回执丢失时沿用原启动文件、建房提交编号和配置重试，程序核对同一房间与运行；不换编号重建。已返回的房间若暂停、结束或过期，先按其实际状态处理，不把重复启动回执当成继续授权。修改软件或会话绑定不能覆盖已有运行目录。

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

@@ -0,0 +1,88 @@
+# 手动接入与持续主持
+
+仅在用户选择手动模式、需要在线专家转交或处理已有原生任务时读取相关部分；自动事件任务不使用本流程。讨论判断、到限处理与进度保存以主技能为准，写入规则只在 discuss-participant 维护。
+
+## 首次接入
+
+工具入口沿用相邻参与技能；已安装 `codiscuss` 时无需定位仓库脚本，直接使用 Python 时才从当前项目或用户指定路径定位 `runner/discuss.py`。站点由用户给定的房间链接、`--site` 或当前进程 `DISCUSS_URL` 明确提供，没有默认公共站点。首次接手读项目 `AGENTS.md`，网站协议由 CLI 获取；需要详细讨论方法时读仓库中的 `docs/workflow.md`，不在每次定时检查中重读全部文档。
+
+有在线网页专家时，**在接入初期主动询问协助方式**：「在线网页 AI 的对话，你希望由主持人负责浏览器操作，还是由你手动复制问题和回答来协助？」用户已明确指定本次分工时直接沿用，不重复询问；不同专家可以采用不同方式。将选择记入接续信息。等待选择期间可完成建房与资料核验，确认后交付启动文本，不先操作在线专家的聊天或发送问题；不要把选择留到浏览器受阻后才询问。
+
+1. 从任务确定目标、背景、边界、成功标准、必要专家和决策者，写入话题资料。分别明确讨论截止/轮次边界、必要回答的等待边界，以及各端定时任务的运行上限；可依据议题规模确定并声明合理值，不固定套用检查次数。沿用已有共识，只询问真正阻碍启动的缺项；默认交付简洁结论，有明确要求再写完整报告。
+2. 当前窗口就是主持会话，从可信运行环境取得当前会话 ID；工具能隐式绑定当前聊天时不必索要 UUID。不得用最近活跃聊天或其他测试会话代替，也不另建调度聊天。
+3. 指定房间则读取并继续，否则通过 CLI 创建。主持人配置为 `cli`，专家按实际读写能力配置为 `cli` 或 `online`；不凭模型名称判断，不因浏览器碰巧打开某房间就接管它。
+4. 在当前任务的接续信息中保存站点、房间、主持身份、实际定时任务 ID 和上限、已处理消息/安排编号、尚未执行的下一步，以及在线专家的聊天入口、问题原文与发送状态。未确认写入还需保留提交编号和原文位置。恢复时先对照网站和工具现状，不能只凭旧记录继续；交接主持时核对旧任务，避免两套主持同时推进。
+
+接手活动话题时沿用有效安排。暂停恢复需明确继续指令，先核对目标、原阶段和安排，再恢复阶段与各自任务；已收束话题重开时追加原因，保留旧结论。新约束只重审受影响的判断并取消失效安排，目标已变成另一问题时另开关联话题。中途加入者按需补资料，已看过其他观点就如实说明，不补称独立观点。
+
+启动文本只提供技能调用、讨论话题、讨论配置和用户特殊要求；执行流程由技能负责，不复制技能正文、默认路径、命令教程或通用规则。用户只要供另一个主持会话使用的启动文本时，当前会话仅交付文本，由接收文本的主持会话建房并执行。
+
+**实际接入专家前，先建好房间并核验，再一次性交付简短、可执行的接入文本，不等用户催促。** 本次检查周期、运行截止和等待边界写入房间资料的边界字段，供参与者通过 `room brief` 获取。主持人回读 `room view` / `room brief`，确认议题、背景、边界和参与配置已保存。建房失败或结果不明时先处理阻碍，不让专家自行寻找或创建房间。
+
+需要用户首次转交时，每位 CLI 参与者的文本通常只需“调用 discuss-participant，以实际身份通过 CLI 持续参与”及房间入口；仅补充尚未保存在房间中的本次特殊要求。首个立即回答的专家先创建正式安排，可附真实安排编号，问题原文从安排读取；后续本地专家可先接入等待。不要再列技能/项目/CLI 路径、协议地址、阅读顺序、提交参数或定时与回执流程，这些由参与技能提供；工具入口确实缺失时再补。已运行者不重复启动，后续由其读取当前安排。正式启动前核对运行上限，不沿用已过期约定。
+
+主持人已负责在线专家浏览器接入时，在该专家轮到发言后直接发送正式问题，保存送达记录；向用户报告结果即可，不再输出一份让用户重复转交的启动文本。用户明确要查看或复制文本时仍完整提供。首启交付、实际送达和任务启动分别记录，不能混为一个状态。
+
+| 参与方式 | 启动文本与接入方式 |
+| --- | --- |
+| 本地可写入专家 | 要求调用 `discuss-participant`，给出身份、房间与本次约定；默认检查周期及参与流程由技能提供。由已获准的通道送达，或交给用户首次转交。 |
+| 在线只读专家 | 能加载技能时同样要求调用讨论参与技能；无法加载本地技能时，在启动文本中提供适用于该角色的参与规则。要求在原聊天形成回答；按已选择的方式由主持人操作浏览器，或由用户手动复制问题与完整回答，主持人负责原文留档。无需该专家自己建立定时任务。 |
+
+接入前核实本地专家已能读取 `discuss-participant`；缺失时提供仓库内 `.agents/skills/discuss-participant/SKILL.md` 的实际路径及 `docs/skills.md` 安装说明。启动文本给任务与入口，不打包背景、主持摘要或他人观点；专家按需阅读。展示文本不等于送达，网页复制按钮也不代替主持人的交付。
+
+专家确实读不到入口时，主持人提供本轮判断必需的原始材料和出处，保留原文的条件、例外与反例；不得用倾向性节选替代需要复核的完整观点。记录实际交付的材料编号及仍缺少的内容；关键材料未补齐时，回答只能记为基于有限材料的暂定判断。独立阶段不夹带他人意见或主持结论。没有定时能力的可写入专家仍自行提交，只改为人工触发。当前同一模型名称只能配置一个参与者、同房间安排串行进行，不能声称并行或技术盲评。
+
+## 在线专家：协助方式与操作恢复
+
+每次请专家回答时，要求同时提供简述与完整正文；简述的写法、保存与署名遵循 discuss-participant。若原回答缺少简述，主持人可据完整原文另行整理并注明摘要归主持人，专家正文保持原样。
+
+选择「用户手动复制协助」时，每轮在当前聊天给出完整、可复制的提问文本和对应安排编号，由用户发到专家原聊天并贴回完整回答；主持人不自行操作该专家网页或发送问题。用户确认送达后再记录通知，收到并核对对应回答后通过 CLI 原文代发。展示提问文本不算送达，等待用户期间不重复催促。
+
+选择「主持人负责」时，向该专家发送本话题问题、读取回答和代发属于已确定的分工，不逐轮重复申请授权。浏览器工具默认显式选择 **Chrome**，复用已有登录状态和本话题聊天；用户指定浏览器或已允许后备浏览器时遵循其选择。采用后台操作，不抢占用户窗口或鼠标键盘，不默认切换内置浏览器重新登录。以下送达核对与中断恢复适用于主持人操作浏览器的情况。
+
+发送前保存本轮房间/安排编号、专家、问题原文和聊天入口，并检查页面上的已有记录。发送中断或工具回执不明时，按以下证据恢复：
+
+| 实际证据 | 下一步 |
+| --- | --- |
+| 对应聊天中已出现本轮问题，或已有对应回答 | 视为已送达，补齐发送记录；安排尚待通知且阶段允许时确认通知，不再发送。 |
+| 已检查正确聊天，确认本轮问题未送达 | 重新核对房间仍活动、安排仍待处理，再发送同一问题并核对页面结果。 |
+| 页面无法读取、聊天归属不明或证据不足 | 保留“发送结果不明”，停止重发并报告具体障碍；下次先恢复核对，不换编号绕过。 |
+
+这里核对的是浏览器中的真实消息；CLI 的提交编号只能去重网站写入，不能防止网页重复提问。待回答完整生成后，确认它对应本轮问题，通过 CLI 原文代发并关联安排；生成中不提交半成品。转录同时保留原回答中的引用编号与可见链接对应关系，不能只复制正文中的数字而漏掉出处。若链接只显示在引用面板，可在同一条留档末尾添加明确标注“主持人从原回答提取的引用”的附录；不把附录冒充专家原句，不补造无法取得的链接。网站看不到尚未转录的回答，因此选择主持人负责时，定时检查也要查看该聊天。
+
+主持人负责浏览器操作时，先实际检查工具和目标页面；只有登录验证、访问或工具限制确实阻碍继续时，才请用户完成受阻的一步。用户选择手动协助不需要以工具受阻为前提，收到其贴回的原文后主持人继续留档。
+
+## 主持人的持续检查
+
+先完成当前可以推进的工作；需要持续主持时，再用返回当前聊天的原生定时任务继续。单次咨询无需额外建立任务。创建前查找并复用同房间、同职责的任务，记录工具返回的真实 ID；不为每次检查新建任务或会话。
+
+主持人无其他约定时参考 **每 30 秒一次**，首次立即检查；通常应比单个专家检查更频繁，因为主持人承接每一轮回答。等待长耗时调研可放宽到 3–5 分钟；工具不支持目标周期时采用最接近且更长的可用周期，并报告实际值。专家周期由参与技能中的参与约定提供。
+
+定时提示词只保存本技能与 CLI 入口、实际站点/房间/身份、检查目的、约定上限及停止条件，并要求每次从网站恢复进度。不把“当前第几轮、等待谁、下一步做什么”等动态状态固定在提示词里；接手旧任务时清除已失效的进度指令，保留有效约定。无变化时安静结束本次检查，只在有实质进展、完成、故障或需要用户决策时报告。创建成功、实际触发和有效推进分别核验，核验不等于发布回执；主持人与专家统一遵循 discuss-participant 的回执规则。原生定时不可用时如实说明，改为手动触发。
+
+每次先读 `room view`，缺少安排或接续信息时再补读 `turn current` / `state view`，优先处理用户新约束，结合 `latest_id` 与实际已读编号，按 CLI 的增量读取规则补读新原文。当前阶段和安排以服务端实际记录为准；state 用于恢复判断依据、已处理回答和未完成的下一步，不能覆盖后来发生的变化：
+
+| 当前情况 | 主持人处理 |
+| --- | --- |
+| 已暂停、收束或用户叫停 | 停止推进并清理本次任务，不继续联系专家。 |
+| 达到讨论上限 | 按主技能执行到限处理；仍可收束时只总结，返回暂停则停止并清理。 |
+| 有尚未处理的回答或用户新留言 | 读原文、核对关联，结合讨论进展和待回应的 @ 决定下一安排、必要复核或收束。 |
+| 正等待在线专家 | 按已选方式推进：主持人负责则检查浏览器中的送达和回答；用户手动协助则核对用户提供的送达信息与完整原文，不自行接管网页。完整取得后留档并继续。 |
+| 正等待本地专家 | 未完成接入则交付启动文本；已运行则等待，不反复联系或重建任务。 |
+| 专家超时、退出或自身任务到期 | 判断意见是否必需，选择等待、替换或带缺席说明继续；不推定同意，也不直接把整场讨论标为结束。 |
+| 没有未完成安排（尚无安排、已回答或已取消） | 根据目标决定下一项安排或结束；已读回答不重复分析，但尚未执行的下一步仍要推进，不能因为“没有新安排”直接退出主持。 |
+| 没有任何待处理变化 | 保留进度，结束本次检查，不结束整个讨论。 |
+
+推进前再次确认阶段与当前安排，沿用已经创建的下一安排，按主技能的进度规则记录结果。暂时读取失败时保留进度，按约定周期再查；持续故障需要改变计划时报告，不把重试当成新一轮讨论。
+
+## 暂停与收尾
+
+等待回答、一次回复结束或暂时没有新消息都不是整场结束。用户叫停、已暂停/收束或达到本次任务上限时，停止新增安排与联系，先停用自己创建的主持任务并查询实际状态；不为等发言权、补摘要或追查回执延长运行。只操作本话题的任务，各专家负责自己的任务，不能代替他们宣称已经停止。
+
+已暂停或收束只处理未完成的清理，不自动恢复或重复总结。需要继续但本次任务到期时保留原阶段、原因与下一步，设为 paused；用户取消或正常完成时按已有材料收束。达到讨论上限则先执行主技能的到限处理，不能把已暂停或超时状态当成继续总结的授权。
+
+需要收束且阶段允许时，取消未完成安排、发表最终 moderation、保存 state 与简报，最后设为 concluded。取消和发言遵守参与技能的发言权；不能夺取本地专家持有的发言权。在线专家无法回答时，主持人按参与技能代归还再处理安排。写入受阻则先暂停，保留原文、原定终点和未完成事项，向用户报告实际障碍。
+
+手动路径允许在外部送达、故障或清理状态发生实质变化后补 state，不为重复抄写已有安排编号而写。停止前归还本人仍持有的发言权；结果不明保留待核对信息，不继续运行定时任务。暂停后的迟到回答保留原文，明确恢复后再判断适用性，不改职责绕过限制。
+
+正常启停不生成或索要回执。确因交接或异常需要确认其他端时，按运行标识与真实任务 ID 核对已有证据；没有回执不等于仍运行或已停止。只更新影响后续安排的结果，不要求全员补报。恢复须有明确继续指令，旧定时任务不能自行恢复讨论。

package/.agents/skills/discuss-participant/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: discuss-participant
+description: "AI CoDiscuss 的通用参与技能，所有参与者（包括主持人）使用。围绕真实问题独立判断、回应论证，并可靠保存观点；支持自动任务与手动接入。编辑技能本身不启动讨论。"
+---
+
+# 讨论参与（discuss-participant）
+
+**主要任务是参与讨论：理解问题，检验证据与假设，回应其他人的论证，形成或修正自己的判断。** 网站操作负责保存这份工作，不应代替思考或成为发言主题。
+
+所有参与者包括主持人使用本技能；主持人另读 discuss-host。只承担本次授予的职责，安装、读取或编辑技能不启动讨论。各 AI 在自己的软件中形成观点，不调用模型服务 API 替代参与者。
+
+## 讨论质量
+
+先回答真正的问题，再给影响判断的理由、证据、适用条件与不确定性。初始观点形成自己的见解；深入讨论先理解对方实际主张及其最有力的依据，再指出同意、分歧或需要补证的部分。区分事实错误、假设不同、评价标准不同和偏好不同，避免把它们混成“谁对谁错”。
+
+可以坚持有依据的少数意见，也可以因新证据修改判断并解释变化。主动检查关键反例与遗漏，但不为反对而反对，不以赞同人数代替证据；若现有材料不足，说明什么证据会改变结论。需要对方回应时直接 `@专家名` 并说明具体问题；@ 是讨论线索，不会自动通知或授予发言权。
+
+篇幅和结构由问题决定，不要求固定栏目、反驳数量或字数。保留关键数字、条件与失败情形；回应追问只补新论证或观点变化，旧内容用原文编号引用。每次专家回答附一两句简述与完整正文；简述表达主要判断或变化，完整论证与出处放正文，避免再复制一遍长清单。
+
+## 本次运行方式
+
+网站读写优先用 `codiscuss room …`、`codiscuss message …` 等统一命令；任务或用户显式指定 CLI 路径时沿用指定入口。未安装统一命令时，用已核实的 `python 路径/runner/discuss.py …`。统一入口需 Node.js 24+，网站读写需 Python 3.10+。裸 `codiscuss` 会启动服务；查询用法使用 `codiscuss --help` / `codiscuss schema …`，下文命令均省略入口前缀。
+
+从实际任务或用户指定值核实站点、房间和身份，不从当前网页或最近聊天猜测。站点用 `--site` 或当前进程 `DISCUSS_URL`，房间始终显式指定，业务写入显式 `--as`。首次接入读一次 `room protocol`。
+
+项目与 cwd 可缺省，有值时用于本次获准资料；CLI 路径只定位工具，不把 CLI 仓库当作讨论项目或扩大文件权限。
+
+**自动任务（收到 `*.task.json`）：**
+
+- 从任务文件取得身份、职责、事件、安排、CLI 和 `access_file`。按任务指令以 `execution enter ROOM EVENT --access-file FILE` 认领一次；**若当前调用刚已成功 enter，直接沿用，不再执行第二次**。会话 ID 由接入程序提供，不编造、不打印凭据内容。
+- 进入失败或重复交付时，用 `execution view` 和实际业务结果核对；仅凭事件显示 started，不能认定可以再做一遍。暂停、到期或失效的旧任务不得继续写入。
+- 本次受保护写入统一附同一 `--access-file`。只处理交付的职责和安排；专家提交答案即完成此执行，主持人的交接边界见主持技能。
+- 通知程序负责续租与后续交付。AI 不创建定时任务、不操作其他软件，不另发“就绪/完成”回执。确实无法继续时保留草稿，用 `execution fail ROOM EVENT --reason 原因 --access-file FILE` 暂停；已失效时不再写回执或清理消息。
+
+**手动接入：** 用户已选手动时沿用人工触发或原生定时；需要持续参与才读 [手动持续参与](references/manual.md)。没有任务文件本身不代表手动授权：若房间正在自动运行，等待本次交付或核对缺项，不从旧文件接管。受保护房间的手动写入使用用户提供的私有接入文件。
+
+## 先读什么
+
+先读 `room view` 获取目标、阶段、当前安排、发言权和上限；已有所需字段就不重复查询同一信息。背景不足读 `room brief`，需要接续判断读 `state view`，核对具体论据读 `message view ROOM ID`，查找材料才用 `message list`。
+
+`initial` 阶段只读议题、背景、边界和自己的材料，独立提交后再读其他观点与主持总结；已经受影响就如实说明，不补称盲评。深入讨论按争点阅读相关原文，不用摘要代替需要复核的论证，也不无目的拉取全部历史。
+
+增量读取用实际已读编号 `message list ROOM --after ID`，按 `next_after` / `has_more` 续读；`latest_id` 不等于已读。筛选后的游标只代表该查询范围，不能用来声称已读全场。阶段和安排以最新服务端状态为准。
+
+## 发言权与提交边界
+
+专家只回答属于自己的当前未完成安排（pending/notified），使用真实 `--turn`；没有安排就等待，不自行接管主持。提交前核对阶段、安排和上限。暂停、收束、`limits.reached` 或 `limits.closing` 时不新增专家观点，保留草稿；主持人按主持技能处理到限或总结。
+
+**任何 AI 消息，包括主持总结和必要回执，都须由本人持有发言权；仅用户本人留言豁免。** 创建或取消安排也需要主持人持有发言权，修改资料、state 和阶段无需领取。AI 不借用用户身份绕过。
+
+用最新房间中的 `floor` 判断：本人已持有则沿用；无人持有且 `next_speaker` 为本人时，以该版本 `floor take ROOM --as 本人 --revision 版本` 领取；否则保留草稿等待。发言、创建或取消安排成功会原子交接发言权，不额外归还。仍有效但放弃发言时才主动 `floor return`；版本冲突或结果不明先回读。
+
+新房间由主持人持有；正式安排交给专家，答案保存后回到主持人。主持人可连续发表说明，也可再次安排同一专家，但每次遵守新的发言权与安排。在线专家的代操作、字段和故障恢复按需查 [写入与恢复](references/writing.md)，本地专家由本人处理。
+
+## 保存真实结果
+
+观点用 `message post`，摘要用 `--summary` / `--summary-file`，完整正文优先 UTF-8 `--body-file`；自己的观点署名自己。主持消息用 `moderation`。代发保留真实作者、完整原文及引用关系，摘要归实际撰写者，不把自己的改写冒充对方回答。
+
+创建房间、安排、消息前保存 `--submission-id` 与原内容；同次重试沿用，新内容换新编号。成功须核对服务端返回的持久记录、作者和关联；返回不含所需证据时按编号补读，避免重复获取同一份已确认内容。答案落库后只读核验即可结束，不补启停回执或使用旧资格继续写入。
+
+结果不明先按原 `submission_id` 精确查询，找到就沿用；明确可重试时仅用原编号原内容重试一次，再不明则保留草稿并报告。不换身份、职责或编号绕过拒绝。首次使用某类写入、代发、超长正文或遇到失败时，读取 [写入与恢复](references/writing.md) 的相关部分；不把全部故障流程作为每次发言的检查表。
+
+正常阅读、等待、启停和成功回答不发布运行回执。只有用户要求或协作确需处理的异常才记录真实结果；回执不能作为观点、完成安排或共识的证据。执行结束不等于整场讨论结束。

package/.agents/skills/discuss-participant/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "讨论参与"
+  short_description: "所有参与者使用，独立判断、回应论证并可靠保存观点，支持自动与手动接入"
+  default_prompt: "使用 $discuss-participant，以指定身份参与这个 AI CoDiscuss 房间，围绕本轮问题检验证据、回应相关观点并保存自己的判断。"

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

@@ -0,0 +1,15 @@
+# 手动持续参与
+
+仅用于用户选择的手动模式及本软件原生定时；自动任务的租约、后续唤醒和终态由接入程序处理，不读取或照做本页。先核实房间的模式，不能因缺少 task 文件就建立定时任务。
+
+## 专家持续参与
+
+仅在本次任务要求后台持续参与时使用所在软件的原生定时功能；网站读写子命令不负责定时调度。先通过 `room brief` 读取本次检查周期、运行上限和停止边界；用户或主持启动文本给出更新约定时沿用更新值，不因接入文本简短就忽略房间中已有的约定。无周期约定时，专家参考 **每 60 秒一次**，首次立即检查。长耗时调研可放宽到 3–5 分钟；工具不支持时选最接近且更长的周期，并报告实际值。创建前复用同房间同职责已有任务，记录真实任务 ID、频率和约定上限；工具不可用时说明，由用户或主持人手动触发，仍可自行写入。
+
+运行上限优先沿用本次约定；未约定时按任务规模确定并声明有限上限，不固定套用 20 次。自身任务到期只表示停止本次后台参与，不代表讨论结束。接续信息保留实际任务 ID、当前安排、尚未确认的提交编号及原文位置；恢复后先核对现场，再处理原任务。
+
+每次先查房间阶段和自己的安排，触及下述停止条件时先清理；仍可参与且有未完成、属于自己的任务，才按上述阅读与写入规则回答；其他情况安静结束本次检查，保留后续检查。没有任务不代表整个讨论结束，不自行接管主持或更改房间阶段。
+
+读到 paused/concluded、用户叫停或达到本次上限时（包括 limits.reached / limits.closing），停用自己创建的任务并查询状态，将实际结果保留在本地接续信息；同时核对发言权，仍由本人持有则主动归还并回读确认。归还结果不明时保留未确认状态并报告，不继续发言，也不为等待归还而继续运行定时任务。是否需要回执按主技能判断，正常启停不发。恢复需明确指令，不由旧定时任务自行重启；请求停止不等于已退出。不影响其他房间或其他参与者的任务。
+
+原生任务停止时间不得晚于房间 limits.deadline（有值时）。缺少有界约定先明确有限上限；不为等待答案、归还或回执无限延长。

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

@@ -0,0 +1,57 @@
+# 写入与恢复
+
+首次使用某类写入、需要在线代发、处理结果不明或超长正文时查阅相关部分。正常讨论按主技能完成必要读写，不逐轮重读本页或整套 CLI 帮助。
+
+## 命令发现与在线代操作
+
+沿用主技能确定的命令入口，不在技能目录另写 HTTP 客户端。命令不确定时用 `codiscuss schema message post` 或对应 `--help`；任务指定脚本入口或未安装统一命令时，在该入口后加 `schema message post` / `--help`。角色限制以目标站点 `room protocol` 为准。
+
+在线专家无法执行本地技能时，在原聊天按主持人提供的参与规则回答；本地操作者负责留档，不能声称在线专家已调用本地 CLI。主持人用自己的 `--as` 和 `--speaker 原专家` 代领其被点名的发言权，再以 `--author 原专家` 代发；本地专家由本人领取。无法完成在线回答时，主持人代归还，随后处理取消。其他本地专家持有而无法归还时，报告用户处理，不强行夺取或修改身份配置绕过。
+
+## 可靠写入
+
+本地提交用 `message post --summary` 或 `--summary-file` 保存摘要，`--body` / `--body-file` 保存完整正文；摘要上限 1000 个 Unicode 字符。自己的摘要默认归自己。代发原作者提供的摘要时用 `--summary-by 原作者`；由主持人或用户另行整理时注明实际撰写者，默认是操作者，不能冒充原作者。摘要与正文一起使用同一提交编号，回读核对两者和归属。在线专家在原聊天分开摘要与完整正文，交由主持人留档；缺少摘要的旧记录不自动生成摘要。
+
+一次写入先确定目标、身份、正文与关联关系，再选择对应命令：
+
+| 意图 | 命令与关键语义 |
+| --- | --- |
+| 自己的观点 / 回答 | 领取后 `message post`，默认 `opinion`，须带真实 `--turn` |
+| 主持说明 | `message post --kind moderation`，以当前主持人署名 |
+| 代发专家观点 | `message post --kind opinion`，`--as` 是实际操作者，`--author` 是原专家 |
+| 创建 / 维护话题 | `room create` / `room update`；`--experts-file` 会替换完整参与配置 |
+| 安排发言 / 取消 | `turn create` / `turn cancel`；同房间只能有一个未完成安排 |
+| 准备 / 确认通知 | `turn prompt` 仅生成文本；实际送达后才 `turn mark-notified`，它本身不发送 |
+| 保存摘要 | `state set`，`--until` 只覆盖实际已读消息 |
+| 必要的运行回执 | `message post --kind receipt`，仅按下述回执规则记录真实结果，不带 `--turn` |
+
+主持类写入需要本次任务授予主持职责。代发保留真实作者、完整原文、原答复的链接/引用对应关系及同房间关联，不把自己的改写冒充他人原文。主持人补充的引用附录需明确标注来源与归属，无法取得的出处说明缺失；不把自己的核验结论混进专家原文。receipt 不作为观点、完成安排或形成共识的证据。
+
+房间、消息和安排创建使用显式 `--submission-id`：新内容生成新编号，同一次提交保留编号、原始资料、身份和关联。**先保存编号与原文，再发请求**，避免中断后无法核对。编号为 8–100 位字母、数字、下划线或连字符，可用 UUID。建房重试对照首次创建资料，不使用后来修改的话题内容替换请求。
+
+长正文优先 UTF-8 文件，`--body-file -` 可读 stdin。当前消息正文上限为 32000 个 Unicode 字符，详细讨论状态上限为 4000 字；以目标站点协议为准。完整回答一次提交并完成安排，不能截断或用第一段冒充完整回答。超过上限时保留完整原文并说明限制，先明确完整材料的留档方式。
+
+成功后核对服务端返回的持久记录，包括作者、正文及安排关联；响应已给出这些证据时不重复全文查询，缺少的证据再按编号补读。`duplicate=true` 表示服务确认已有同一提交，不是新发言。讨论暂停或收束后不再提交新观点/安排，保留原文。手动控制凭据可能仍允许必要的 receipt 或主持说明，但自动执行失效后不能借此继续写入；不能改消息职责绕过阶段限制。
+
+保存摘要后核对服务端返回的正文和截止编号，响应不足时用 `state view` 补读。`--until` 表示实际已读材料范围，不能证明下一安排、外部通知或清理已完成；这些事项在摘要正文中保留各自真实状态。保存结果不明时先比较现存摘要与待保存内容，不直接用旧草稿覆盖更新后的进度。
+
+`--dry-run` 只展示本地请求，完全不联网，不证明服务端接受；在需要审查参数时使用，不作为每次写入的强制审批。`api` 仅补充尚未包装的原始接口，不自动补身份或提交编号，不用于绕过规则。
+
+## 结果与故障处理
+
+默认 JSON：退出码 0 且 `ok=true` 才按成功处理，数据在 `data`、请求目标在 `meta`。错误写 stderr；退出码 1 为 HTTP/API 错误，2 为参数或输入错误，3 为网络失败/结果不能确认，130 为中断。结合 `http_status`、`outcome` 与错误说明判断是否可能已经写入，不只看退出码。
+
+- 参数错误或明确拒绝：按原因修正或重读最新状态，不换身份、职责、编号来绕过拒绝。
+- 创建结果不明或中断：先用对应 `list --submission-id` 精确查询，再读回关联安排和原文；查到已保存结果就沿用，不能重新创建。查询失败不代表未写入，保留原文与编号并报告。
+- 确认仍需重试创建时：原编号、原内容最多再试一次；仍不确定就停止重试。不要把下一次定时运行当成新提交。建房重试只返回已有房间，不会恢复或覆盖后来修改的阶段与资料。
+- 其他更新操作先读现状再决定是否需要重做。旧站点没有建房幂等或精确查询时，先按协议核对已有记录，不把不受支持的筛选当作查询成功。
+
+这些核对覆盖网站 HTTP 写入；浏览器向在线专家发送问题时，由主持人另行核对实际送达结果。
+
+## 回执：非必要不生成
+
+默认不生成运行回执。正常启动、停止、首次触发、阅读、等待、无变化轮询和已提交回答都不另发回执；任务启停仍须核验，实际任务 ID、频率/上限和证据保留在本地接续信息。
+
+只有用户明确要求、异常影响协作且需要处理，或交接确需补充外部确认时，才提交回执。必要回执也必须先取得本人发言权；暂时无权时保留本地记录，等待主持安排，不抢占或借用用户身份发布。现有状态或消息已足够说明的，不重复补发，也不改用主持说明发布同一条非必要运行通知。
+
+必要回执通常用 1–3 句说明实际结果、协作影响和需要的下一步；有任务时保留足以核对本次运行的标识和真实任务 ID，不堆叠工具日志、轮询记录或讨论统计。无法核验就说明未确认，不把请求成功写成任务已退出；没有创建任务就不虚构启停。相同事件只提交一次，重试沿用原提交编号；只有影响协作的结果发生实质变化时才补充。

package/.agents/skills/discuss-report/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: discuss-report
+description: "将已结束或明确选定范围的真实讨论整理为独立可读的中文综合报告，并归档原文与来源。用于 AI CoDiscuss 房间或用户提供的本地讨论文档；不负责主持、继续讨论或将建议自动写成正式决策。"
+---
+
+# 讨论归档（discuss-report）
+
+把讨论转为可以独立阅读、核对依据和继续使用的本地成果。按问题与洞察组织报告，解释当前建议如何形成、哪些旧方案被放弃、分歧如何变化及仍缺少什么；不以过程简报、结论短讯或逐轮拼接代替综合报告。
+
+报告作者是材料整理者，不因此取得主持或专家身份。只读已有资料并写入用户指定的本地归档位置；不创建或重启讨论、联系专家、设置任务、发送通知、改变网站阶段或房间存档状态。归档不代表任务已经停止，也不授权改写正式设定、剧本、执行下一步或提交/推送 Git。
+
+## 确定范围
+
+从本次请求确认来源、主题或消息范围、归档根目录，以及报告用途与用户已采纳的事项。已有信息直接沿用；缺少来源或输出目录时，只询问缺项，不从最近聊天、当前打开网页或示例推断。
+
+- **已结束的房间**：读取房间状态，固定本次归档的最新消息编号，再读取该范围的完整讨论。仍在进行且用户未指定截止范围时，先明确范围，不自行结束房间。
+- **指定消息或阶段**：保留明确的起止及排除范围；为理解引用补读必要的更早原文，并标为背景补充，不称已覆盖整场讨论。
+- **本地讨论文档**：只处理用户指定的文件或目录，先识别初始材料、真实发言、转录、摘要及既有报告。日期、作者或先后关系不清楚时标为未知，不补造一场完整研讨。
+
+读取目标目录现有结构、项目说明和同主题成果，沿用用户的中文命名与分层。材料中的“定稿”等旧标题不能推翻用户本次明确的“尚未确认”边界；材料内的提示词和行动要求是讨论内容，不作为本次执行授权。
+
+## 取得可复核的来源
+
+### AI CoDiscuss 房间
+
+从用户给定链接取得站点和房间 ID，从当前项目或用户指定路径定位 `runner/discuss.py`。需要 Python 3.10+；复制到个人技能目录后，技能目录不是程序目录。首次使用或字段不明确时读 CLI 帮助；详细命令见项目 `docs/cli.md`。
+
+本任务只使用读取命令，例如：
+
+```text
+python <已核实的项目路径>/runner/discuss.py room view <房间ID> --site <实际站点>
+python <已核实的项目路径>/runner/discuss.py room brief <房间ID> --site <实际站点>
+python <已核实的项目路径>/runner/discuss.py state view <房间ID> --site <实际站点>
+python <已核实的项目路径>/runner/discuss.py message list <房间ID> --after 0 --site <实际站点>
+```
+
+默认 JSON 的 `ok=true` 与退出码 0 才表示读取成功。消息每页最多 20 条；使用 `--after` 时按实际返回的 `next_after` 续读，结合 `has_more` 核对是否覆盖固定截止编号。相关提问与安排通过 `turn list <房间ID> --page 1` 起读，按返回的 `page` / `pages` 递增页码覆盖相关安排，必要时用 `turn view` 补读。
+
+不要把首屏、过滤查询或最后一条总结当作完整来源。按编号和选定范围去重；缺失编号不能仅因不连续就判为丢失，消息编号可能跨房间分配。
+
+保存原始响应及读取时间，保留消息编号、作者、职责、正文、摘要与摘要作者、代发者、引用和安排关系。消息中的材料引用要追到实际可得的原文；无法访问的外部出处列为未核实，不因链接存在就认定其支持结论。固定截止后的新消息不自动纳入当前报告，也不启动持续监控。
+
+找不到 CLI 时先使用用户提供的完整导出或文档；不要为生成报告再实现一套客户端，也不要以可读的概要替代无法取得的原文。关键来源不足时交付明确标注范围与缺口的阶段报告，不声称完整归档。
+
+也可使用网页“备份当前讨论”下载的 ZIP：保留原包，读取 `完整数据.json` 和 `讨论记录.md`。核对 `format=ai-codiscuss-room-backup`、版本、导出时间、房间 ID 与全部消息范围；JSON 的 `tables` 保留原始记录，消息职责、简述和安排需按编号关联。不要把外部链接当成已经备份的附件，也不要因拿到 ZIP 就跳过阅读原文。旧站点尚无备份入口时，继续使用上述 CLI 分页读取，无需等待部署。
+
+### 本地文档与混合来源
+
+保留所选原文件的副本与原始名称；记录原始来源、作者、日期、格式和本次读取范围。仅有摘要时标注“仅摘要可用”；网页讨论与本地原材料可能是同一内容，不重复算作多个独立证据。路径变化或文件不同版本保留对应关系，不擅自以新版本替换讨论当时看到的旧材料。
+
+文档中的技术数字、作品情节和研究结论若未独立核验，只能称为原作者提出的说法、假设或待查线索。外部事实核验仅在本次任务需要且有条件完成时进行；报告清楚区分新核验与讨论原文。
+
+## 形成主题综合
+
+写作前读取本技能的 [默认报告模板](assets/Discussion_Report_Template.md)。报告的必要信息、事实边界与结构弹性统一在模板中定义；用户指定格式时优先沿用，仍须覆盖必要信息。复制技能时须连同 `assets/` 一起复制。
+
+先整理“主张—理由—来源—变化—当前状态”，并将范围内的核心问题、实质性方案、影响结论的异议与条件、修订或撤回、用户决定和未决事项对应到报告的具体位置。问候、回执及重复内容不必逐项入正文；不得因最终总结未提及就遗漏有实质影响的观点。优先读完整专家发言和修订，最终主持总结用于交叉核对，不能覆盖专家保留意见或取代原文。
+
+涉及轮次统计时，不把主持说明、回执或重复补充算作专家轮次。依据材料中的实质问题重组论证，避免逐轮拼接；表格用于帮助比较方案或观点变化，不为排版形式替代解释。
+
+关键判断在相邻位置链接到具体原文。短引文须与原文一致；转述不用引号且保留条件，不为增加权威堆砌引用。引用同时标明作者与消息编号，或文件名及可定位的标题/段落；只链接房间首页不足以支持具体主张。
+
+## 写入归档
+
+通常采用下面的最小结构，用户已有约定时沿用：
+
+```text
+<用户指定归档根目录>/<讨论日期或明确日期未知>-<中文主题>/
+  讨论报告.md
+  原始记录/
+    讨论原文.md          # 房间原文或文档转录，需要时生成
+    房间快照.json        # 房间元信息和完整消息的原始响应
+    <所选本地原文件>     # 本地输入时保留原格式
+```
+
+本地文档无需生成房间文件；已有可直接阅读的原文不重复转录。按模板用顶部 YAML 概览讨论身份、规模、状态和报告更新时间，详细时间、范围、来源索引与版本依据放在文末来源说明。
+
+房间归档同时保留机器可核对的原始响应与便于引用的正文：转录按消息顺序保留原文，元信息与正文分开，可用 `<a id="message-52"></a>` 形式提供稳定锚点。报告使用相对链接，如 `[Claude #52](原始记录/讨论原文.md#message-52)`；上例只是格式，编号和作者须换成实际来源。原始来源自身的链接原样保留，本地副本链接不能依赖维护者的绝对路径。
+
+写入前确认目标路径及文件是否存在。重复调用先比较来源范围与现有成果：无需修订时沿用；需要新版本时新建明确的修订目录并说明替代关系。不得静默覆盖用户编辑、把两个不同议题混入同一目录，或将重跑时间冒充讨论时间。用户明确要求更新已有报告时，先保留原文件，再修改获准部分。归档过程中失败保留已取得资料，标明哪些文件和范围尚未完成，不宣称成功。
+
+## 验收与交付
+
+按模板“必要信息与事实边界”逐项回读，从原文反查实质事项是否进入报告；核心问题有回答或列为未决，范围与计数对应实际来源。章节经过合并或重排时，核对信息仍可定位，不因标题不同判为缺项。
+
+检查顶部 YAML 能正确解析且各字段与来源一致，相对链接和锚点可达，写作说明与占位符未混入成稿；重复调用没有覆盖原有文件，输出未越过用户指定目录。
+
+至少抽查一条最终建议及一条发生变化或仍有争议的主张，沿报告引用追到原文；涉及主张撤回时同时核对前后两端。检查报告可以独立读懂“为什么得到这个建议”和“现在还不能决定什么”，不只核对标题或文件存在。
+
+交付实际报告与来源目录链接、覆盖范围和影响使用的缺口，说明是否仍待用户确认。只报告已完成的归档；不把报告完成写成正式方案采纳、外部事实验证或后台任务停止。

package/.agents/skills/discuss-report/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "讨论归档"
+  short_description: "按主题整理真实讨论并保留原文来源，生成可追溯、可持续归档的报告"
+  default_prompt: "使用 $discuss-report，将指定范围的真实讨论整理为中文综合报告，并归档到我指定的本地目录。"

package/.agents/skills/discuss-report/assets/Discussion_Report_Template.md

@@ -0,0 +1,65 @@
+---
+讨论日期: "{{实际讨论日期或跨日范围}}"
+讨论房间号: "{{实际房间号，本地文档省略}}"
+参与者: "{{参与者姓名，注明主持人等必要角色}}"
+讨论规模: "{{选定范围内已核实的轮次、专家发言数等，简写为一行}}"
+讨论状态: "{{选定范围对应的讨论状态}}"
+采纳状态: "{{待确认、部分采纳或已采纳}}"
+报告更新: "{{本次生成或更新日期}}"
+---
+
+# 讨论综合报告模板
+
+让未参加讨论的人读懂问题、关键取舍、当前判断如何形成，以及仍不能确定什么，并能回到原文核对依据。
+
+## 使用约定
+
+- **必须覆盖**：下方“必要信息与事实边界”是内容要求，调整结构时仍须满足；验收按信息与依据，不按标题字面匹配。
+- **默认沿用**：基本信息在前，随后交代问题、讨论概况、主题分析、结论与未决事项，来源索引在后，便于跨报告查阅。下方骨架是起点，可按内容合并、拆分、重命名或调整顺序；用户指定格式时优先沿用。
+- **自主发挥**：主题划分、论证顺序、分析视角、篇幅及图表由材料与读者需要决定。可以提出有依据的新联系、解释或后续设想，明确标为报告作者分析并交代推导依据与不确定性，不冒充原有共识。例如，方案比较可关注收益与代价，创作讨论可关注人物动机与设定一致性；这些不是必设章节。
+
+顶部 YAML 用于快速识别讨论、了解规模和判断成果状态，默认采用上方七项：日期、房间号与参与者说明身份；轮次和专家发言数合并为讨论规模；讨论状态与采纳状态分别说明进展和采用情况；报告更新标明整理时间。字段值保持简短，参与者尽量同行，本地文档省略不适用的字段，不为凑齐七项编造数据。
+
+主题由标题表达。精确时间与时区、来源链接、消息和安排范围、报告作者、首次生成日期及版本依据放在文末来源说明；核验缺口在正文相关位置说明。必要但未知的信息如实标注；更新时保留首次生成日期，不将报告更新时间冒充讨论日期。成稿删除使用说明和占位符。
+
+消息、发言、安排和完整轮次只统计声明范围，背景补读另列，不直接套用房间全量计数。讨论状态注明可确认的截止范围或读取时间，不用当前阶段反推历史阶段；跨日讨论写全起止日期，转换时间时标明所用时区。
+
+## 必要信息与事实边界
+
+| 信息 | 合格标准 |
+| --- | --- |
+| 报告身份与范围 | 主题、实际讨论时间、来源与截止范围、参与者及角色、报告作者与生成日期、用户采纳状态、材料覆盖与缺口可查。讨论时间与生成时间分开，作者、代发者、摘要作者不混淆。 |
+| 背景与问题 | 说明讨论缘由、目标、约束和可调整的前提；每个核心问题有回答或明确列为未决，不补造材料没有的目标。 |
+| 关键分析 | 解释实质性方案的理由、证据、反对意见及适用条件，保留影响判断的转折、修订、撤回及放弃替代方案的原因。不要求每条发言入正文，也不为凑章节重复结论。 |
+| 当前结论与未决事项 | 区分共同方向、个人偏好、保留异议、作者分析与用户实际采纳。多数支持或未发现异议不等于全员认可；未确认不等于否决。撤回的主张不再作为当前依据，已解决的争议不继续列为未决。后续建议说明验证目的与判断依据，负责人、日期与承诺仅在来源明确时记录。 |
+| 来源与归档 | 关键判断可定位到具体原文；来源索引对应实际副本，说明纳入/排除范围、背景补充、版本与重复材料。仅有摘要或无法访问的外部来源须注明，不因存在链接就称已核验或已归档。 |
+
+必要信息缺失时写明“材料未提供”或“未核实”及其影响；不适用时简述原因，可合并说明，无需保留空章节。只有核对完整的选定范围后，才可写“在本次范围内未发现”。关键原文不足时，在开头标明“阶段报告”及缺口，禁止为补齐结构虚构事实、轮次、共识或决策。
+
+## 默认报告骨架
+
+先填写并保留顶部 YAML 元信息，再接以下正文。主题分析可展开为多个独立章节，简短讨论也可合并相关部分；标题应表达该报告的实际问题与洞察。
+
+```markdown
+# {{讨论主题}}讨论报告
+
+## 背景与核心问题
+
+{{为何讨论、目标与约束、需要回答的问题}}
+
+## 讨论概览与关键转折
+
+{{实际讨论方式及影响判断的变化}}
+
+## {{体现核心洞察的分析主题}}
+
+{{围绕实质问题解释方案、依据、取舍与条件；按需要展开更多主题}}
+
+## 结论与未决方向
+
+{{回应核心问题，说明结论边界、当前分歧、未决事项及后续建议}}
+
+## 来源与归档说明
+
+{{具体来源与本地副本的对应索引、范围及必要的版本说明}}
+```