108 lines
7.9 KiB
Markdown
108 lines
7.9 KiB
Markdown
# 阶段 B：链路盘点与清理
|
||
|
||
日期：2026-08-22
|
||
总 plan：[2026-08-22-agent-example整体收敛总plan.md](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`：通过。
|