From af54904da160d084faefa3f2ecf7f0dfe492fb2b Mon Sep 17 00:00:00 2001 From: zizi Date: Sun, 23 Aug 2026 21:28:54 +0800 Subject: [PATCH] =?UTF-8?q?=E8=92=B8=E9=A6=8F:=20=E4=B8=A4=E9=98=B6?= =?UTF-8?q?=E6=AE=B5=E5=86=99=E6=89=8B=E5=BD=A2=E6=80=81=E4=B8=8E=E5=AF=B9?= =?UTF-8?q?=E7=85=A7=E8=A3=81=E5=86=B3=E8=BF=9B=E7=A8=B3=E5=AE=9A=E6=96=87?= =?UTF-8?q?=E6=A1=A3=EF=BC=8C=E6=80=BBplan=E6=94=B6=E5=8F=A3=EF=BC=88?= =?UTF-8?q?=E8=BF=87=E7=A8=8B=E6=B8=85=E7=90=86=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agent/docs/architecture/domains/05-创作流程领域.md | 2 ++ .agent/docs/architecture/domains/07-Agent与Skill领域.md | 2 +- .agent/skills/write-next-chapter/SKILL.md | 6 +++++- docs/plans/2026-08-22-agent-example整体收敛总plan.md | 4 ++-- 4 files changed, 10 insertions(+), 4 deletions(-) diff --git a/.agent/docs/architecture/domains/05-创作流程领域.md b/.agent/docs/architecture/domains/05-创作流程领域.md index e12c8c6..8a5c22e 100644 --- a/.agent/docs/architecture/domains/05-创作流程领域.md +++ b/.agent/docs/architecture/domains/05-创作流程领域.md @@ -264,6 +264,8 @@ DRAFT/CHECKING/PASSED -> DISCARDED（用户明确决策） 当前生产编排实现（`run_writer_pipeline`）的事实：机械门 → 语义检测 → 单次收敛、证据缺口收敛为授权终态（AUTHORIZATION_REQUIRED，补证/重写经人授权后以新运行继续）、CAS 乐观锁 + 失败收敛终态、生成篇幅与机械接受底线分层合同、评测候选四层强制；业务继续/停止的授权归人，技术保护（超时、预算、取消）在执行策略层。生产写手收到 4000–7000 汉字（目标 7000），可信适配器只拒绝不满 3001 汉字或超过 10000 汉字的异常输出；两层区间由 WriterContext 机械校验保持嵌套。 +写手执行的生产验证形态是两阶段写手（`produce_next_chapter.py --two-phase`）：探索阶段派发写作智能体（只读工具集）自主取材（细纲、前文、文风、范式、实体）、产出探索清单；确定性回放按清单重放只读工具（无模型参与），得到写手实际依赖的材料；生成阶段无工具派发、单次成稿，生成输入只含回放材料与篇幅/文风合同，不含全量预组装。探索与生成使用独立会话、各记独立派发运行，写手事实只来自它探索到的材料；探索清单与摘要落运行工件，探索轨迹与依赖清单进事件账本，是创作台链路透视的数据源。探索与生成分离的原因：单阶段同会话形态下，长篇生成会被多回合探索挤占输出空间导致正文碎片化（2026-08-23 烟测实证）。该形态已于 2026-08-23 生产烟测双门通过并经人采纳进正典；同源对照实验裁决直调链退出创作生成（见 `07-Agent与Skill领域`）。 + ## 6. 运行与落库 - 正式内容和候选都在 PostgreSQL 内；Git 只管代码与文档，不承载正式内容。 diff --git a/.agent/docs/architecture/domains/07-Agent与Skill领域.md b/.agent/docs/architecture/domains/07-Agent与Skill领域.md index 60988f8..ebef1de 100644 --- a/.agent/docs/architecture/domains/07-Agent与Skill领域.md +++ b/.agent/docs/architecture/domains/07-Agent与Skill领域.md @@ -29,7 +29,7 @@ Agent 与 Skill 领域拥有角色职责、可调用能力合同、确定性工 5. 输出是结构化 JSON，由派发方按 schema 校验后才可进入下游；校验失败按失败关闭。 6. 派发方负责证据落库（record-run-evidence）：事件账本、raw、逐回合模型调用，以及工具读取形成的依赖清单；角色本身不写回执、不推进状态。 -执行底座分三条链：框架派发链（dispatch-agent-task，宿主智能体框架会话）承载生产与评测的角色执行主链；受治理直调链（`muse_role -> muse_llm.chat_governed`）承载内容模型任务（清洗、拆书、抽取、审卡）与对照生成；批处理执行链（execute-role-task）承载无工具的直接角色任务。三条链共用角色合同、证据账本与落库合同；合同不绑定任何 CLI 的原生角色装载机制。 +执行底座分三条链：框架派发链（dispatch-agent-task，宿主智能体框架会话）承载生产与评测的角色执行主链，是唯一的创作生成链；受治理直调链（`muse_role -> muse_llm.chat_governed`）只承载内容模型任务（清洗、拆书、抽取、审卡）与对照生成——2026-08-23 同源对照实验裁决其退出创作生成（同一份探索依赖上下文下，直调臂复读细纲原句被机械门拒绝，框架派发臂双门通过并经人采纳）；批处理执行链（execute-role-task）承载无工具的直接角色任务。三条链共用角色合同、证据账本与落库合同；合同不绑定任何 CLI 的原生角色装载机制。 ## 3. Skill 合同 diff --git a/.agent/skills/write-next-chapter/SKILL.md b/.agent/skills/write-next-chapter/SKILL.md index 2364631..8e3d2bf 100644 --- a/.agent/skills/write-next-chapter/SKILL.md +++ b/.agent/skills/write-next-chapter/SKILL.md @@ -40,7 +40,11 @@ Writer 不接收 `runId`、权限信息、manifest、hash、候选版本、验 Dashboard 与人工生产入口统一调用 `scripts/produce_next_chapter.py`。该入口只负责编排本 Skill 已登记的冻结、检索、writer、detector、CAS、候选落库和人闸步骤；不提供自动 accept。运行 artifacts 仍由只读看板按 run_id 读取。 -- 默认走直调链（`run_writer_with_receipt`）。`--dispatch-writer --provider P --model M [--thinking T]` 改走框架派发链：写作智能体经 `dispatch-agent-task` 自主探索取材并产正文（`scripts/dispatch_writer_bridge.py`），一章一个稳定会话（复用=继续原写作智能体）。派发链的模型证据记在派发运行下，生产候选账本以显式 `writer_raw_ref` 关联，不双套记账。 +- 写作节点有三种执行模式（写手合同相同，产出同为 `candidateBody` 信封）： + - `--two-phase --provider P --model M [--thinking T]`：**已验证的生产形态**（2026-08-23 候选 164 双门通过并经人采纳入正典）。两阶段写手（`scripts/two_phase_writer.py`）：探索阶段写作智能体带只读工具自主取材并产出探索清单；确定性回放按清单重放只读工具（无模型参与）得到写手实际依赖资料；生成阶段写作智能体无工具、单条成稿，生成输入只含回放资料与篇幅/文风合同，不含预组装上下文。探索与生成各记独立派发运行，探索摘要落 `artifacts/-exploration-summary.json`。 + - `--dispatch-writer`：单阶段派发（探索与生成同会话的过渡形态，已被两阶段取代，属链路清理对象）。 + - 缺省：直调链 `run_writer_with_receipt`（对照裁决后只用于对照实验与回放评测，不再是创作生成的生产形态）。 +- 派发链的模型证据记在派发运行下，生产候选账本以显式 `writer_raw_ref` 关联，不双套记账；一章一组稳定会话（`writer-explore-work-ch` / `writer-gen-work-ch`，复用=继续原写作智能体）。 - 授权继续：管线停在 `AUTHORIZATION_REQUIRED` 时留痕 `artifacts/-authorization-request.json`；人授权后以 `--continue-from <前序 run_id>` 发起新运行，编排方按缺口补证重组上下文后继续。 ## 生产落库 diff --git a/docs/plans/2026-08-22-agent-example整体收敛总plan.md b/docs/plans/2026-08-22-agent-example整体收敛总plan.md index 0c4efd4..30cb1b1 100644 --- a/docs/plans/2026-08-22-agent-example整体收敛总plan.md +++ b/docs/plans/2026-08-22-agent-example整体收敛总plan.md @@ -1,7 +1,7 @@ # agent-example 整体收敛总 plan -日期：2026-08-22 -状态：总 plan 已定；阶段细节在各阶段启动时另行制定。 +日期：2026-08-22（2026-08-23 收口） +状态：**已收口**。阶段 A–G 全部完成并逐项提交（`eb83053`→`661695f`）；最终验收 §11 五类可见项全可见（记录见 `docs/acceptance/`）；对照实验裁决创作生成直调链退役、框架派发链为唯一创作生成链。各阶段台账见本目录阶段文件。 ---