muse-agent-example/docs/plans/2026-08-22-阶段B-链路盘点与清理.md

7.9 KiB
Raw Blame History

阶段 B:链路盘点与清理

日期:2026-08-22 总 plan:2026-08-22-agent-example整体收敛总plan.md 状态:已完成(本文件同时是阶段 B 台账与验证记录)。

1. 意图

盘点全部模型调用路径、58 个 Skill、一次性脚本与散落设计文档,每项定终态归属,删除无消费者的遗留。

2. 四条模型调用路径终态判定

路径 当前消费者(取证于 2026-08-22) 终态 依据
框架派发链(dispatch-agent-task) 仅测试与自身;无生产消费者 生产与评测主链(阶段 E/F 接入) 总 plan 目标架构;pi 会话机制已验证可用
治理直调链(muse_llm.chat_governed) 8 个 Skill 脚本:call-content-model、clean-book-text、deconstruct-book×3、extract-chapter-knowledge、repair-work-extraction、review-knowledge-cards 保留:内容模型任务主链 + 对照实验生成 消费者全部是清洗/拆书/抽取/审卡等内容模型任务,无角色场景;对照模式归阶段 F
角色运行时链(muse_role.run_role) 6 个消费方:evaluate-frozen-replay、refresh-runtime-probe、replay-writer-gate×2、write-next-chapter×2 保留至阶段 E/F 切换,随后随直调链处置 全部是角色调用场景,属框架派发链的目标替换对象
批处理执行链(execute-role-task) SKILL.md 文档引用(评测链角色调用入口);无独立脚本消费者 保留:无工具直接批处理角色任务 与框架派发链职责不同(无 ReAct 循环、无会话);边界合同已登记两者并列关系

判定含义:本阶段无路径删除。四条路径各有现存消费者,全部符合或终态符合边界合同;角色运行时链的生产替换发生在阶段 E,评测替换在阶段 F,替换后按零引用再删。

3. Skill 层盘点结论

58 个 Skill 全部有机械登记(skills.json、_index.md)之外的真实引用(meta/chains、领域文档、测试、其他 SKILL.md、dashboard)。无删除候选。工具层(工具 server)当前整体缺失,属阶段 D 建设对象,不是清理对象。

4. 文档清理

4.1 删除(24 份,全部零引用)

样张快照(7 份)--数据权威在库,文档是当时展示快照,Git 历史可回溯:

  • 2026-07-13-B2放量-5书50章-216卡样张.md(正式卡在库)
  • 2026-07-13-S3新卡39张样张.md("库内活卡")
  • 2026-07-16-批9终态样张-升格机动.md(559 张升格卡,数据在库)
  • 2026-07-16-批9终态样张-升格深空.md
  • 2026-07-16-批9终态样张-范式五书.md
  • 试拆-门②样张.md
  • 试拆-opus基准-机动风暴.md

已执行完的一次性计划/记录(6 份)--稳定结论已蒸馏进领域文档、DDL 或父仓 SoT:

  • 2026-07-13-M3清洗拆书执行计划.md(清洗已全部落库,见 4.3 库证据)
  • 2026-07-13-S3窗级出卡验收报告.md(验收完成,管线已投产)
  • 2026-07-13-B4-fable独立审查报告.md(自称"SoT"实为历史执行;后续批9 全量重审已取代)
  • 2026-07-19-回放评测-细纲首跑设计与计划.md(首跑完成,结论蒸馏进 08-01 评测 harness 设计与领域文档)
  • 2026-07-24-Gate-A-正文智能体职责重构记录.md(自称"历史执行记录,非 SoT";引用的 .claude/ 路径已不存在)
  • 2026-07-24-work8-窗108-116续跑修复记录.md(一次性修复记录)

清洗审核材料(9 份)--对应 8 个作品的清洗已全部落库(example_clean_log 有 work 2/3/4/6/7/8/10/11 的记录,共 1685 条),报告是历史人审材料:

  • 清洗-2-希泊尼战纪.md ~ 清洗-11-超神机械师.md(8 份)
  • 清洗质检-机破星河前50章.md

过程锚点与内部执行记录(2 份):

  • 2026-07-16-批9c-收官与优化方案.md(compact 恢复锚点;自带处置指令"任务完成后蒸馏进 README §九 并删本文档";稳定产物已有独立落点:代码提交、升格卡改造设计、升格级联重跑设计)
  • 2026-07-17-卡的第一性原理与知识效用闭环.md(自称"内部执行记录,不是交付物";交付物=父仓 design-docs 专题-07 等已落盘)

4.2 保留(9 份)

文档 保留原因
2026-07-14-参考书作品面数据入库方案.md 被 DDL 94、升格卡改造设计引用
2026-07-16-升格卡改造设计.md 被 meta/schemas(faction/item/power_system)引用
2026-07-21-升格级联重跑设计.md 执行状态未完成(备份/恢复演练/重建未执行),是未完成工作的依据
2026-07-30-落库与看板设计.md 被 DDL 99/101/102 引用,raw 与落库合同的设计拍板记录
2026-08-01-评测harness改造设计.md 被领域文档 05/06 引用
2026-08-19-craft-distillation-trace.md 被 skill 质量审查清单引用
2026-08-20-skill-质量审查与复利改造清单.md 被 harness/README 引用
2026-08-20-质量收敛环运行手册.md 被 optimize-content-quality SKILL 引用
2026-08-19-evaluate-frozen-replay-raw边界冲突.md 待所有者裁决:文档自称"待裁决",虽取证显示合同层已对齐 DB-first(评测链 SKILL.md 已写"完整 prompt/response 只经 record-run-evidence 写入受控 raw 表",run_role 内部走 persist_call 落库,vault 降为仓外备份),但按仓规缺显式所有者批准不得代为关闭;裁决后删除或归档

4.3 库证据

清洗落库核对(example_clean_log 按 work 聚合):work 2(49)、3(61)、4(163)、6(107)、7(566)、8(20)、10(596)、11(123)--删除的 9 份清洗材料对应作品全部有落库记录。

5. 上一轮清理的并入

工作树中上一轮"清理冗余链路"的未提交改动并入本阶段提交(同属链路清理语义):

  • 删除 docs/write-chapter/step1_setup_work.py、step2_setup_chapter2.py、step2_setup_chapter3.py、step2a_retrofit_ch1_context.py、step2a_write_chapter1.py(5 份无调用方的一次性建章脚本;其中 step2a_write_chapter1 含绕过人闸的直接 accept 路径)
  • 修改 produce_next_chapter.py(删除对旧建章脚本的说明,改为数据库前置条件)
  • 修改 05-创作流程领域.md(统一使用 produce_next_chapter.py 入口)

6. 文件台账(阶段 B 触碰的全部文件)

处置 文件 原因
删除 docs/ 下 24 份(见 §4.1) 零引用 + 已落库/已蒸馏/已被取代,逐份理由见 §4.1
删除 docs/write-chapter/step*.py ×5 上一轮清理遗留:无调用方的一次性入口(并入提交)
修改 produce_next_chapter.py、05-创作流程领域.md 上一轮清理遗留的引用修正(并入提交)
保留 docs/ 下 9 份(见 §4.2) 逐份理由见 §4.2
保留 58 个 Skill、四条调用路径 见 §2、§3:全部有真实消费者
保留 dashboard/fixtures/ 离线回退数据,被 server.py 引用
新增 本文件 阶段 B 台账与验证记录
遗留 raw 边界冲突裁决 待用户裁决(§4.2 末行);裁决后处置
遗留 2026-07-21-升格级联重跑设计.md 的未完成执行 属知识链工作,归阶段 F 或另行立项
遗留 用户候选文档 docs/design/candidates/初步设定候选-统合.md 用户未提交改动,不属于本阶段范围,不触碰

7. 验证

  • 被删文档全仓零引用:rg 检索被删文件名关键词,除本计划文档外无残留(含互引收敛后追加删除的批9c、第一性原理两份)。
  • 技能严格审计:skill_harness.py --strict 通过,58 个 Skill,阻断 0,质量发现 0。
  • Skill 索引一致性:skills_index.py --check 通过。
  • 全量离线清单:101 通过、8 项外部依赖阻断、0 失败,与阶段 A 基准一致。
  • 架构门禁:test_import_boundaries + test_skills_index 全部通过。
  • git diff --check:通过。