7.9 KiB
7.9 KiB
阶段 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终态样张-升格深空.md2026-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:通过。