franksong2702 · franksong2702 · Jul 12, 2026 · Jul 12, 2026
diff --git a/00_Knowledge-Graph-总图.md b/00_Knowledge-Graph-总图.md
@@ -8,7 +8,7 @@ tags: [AI工程, 知识图谱, 统一框架, 总编辑]
 
 # 《AI Engineering Knowledge Graph》总图
 
-> 这是整套 AI Engineering 知识库的总编辑视图。**十五本书**（原九本核心 + 审计后补齐的六本：数据、模型定制、人机协作、生产系统、人机交互、多模态）、186 个文件、约 400 个知识单元，被统一成一个理论框架、一张知识地图、一条学习路径和一张使用路由。
+> 这是整套 AI Engineering 知识库的总编辑视图。**十五本书**（原九本核心 + 审计后补齐的六本：数据、模型定制、人机协作、生产系统、人机交互、多模态）、203 个文件、约 400 个知识单元，被统一成一个理论框架、一张知识地图、一条学习路径和一张使用路由。
 > 四份总编辑文档：本篇（统一框架与地图）· [编辑审计（重复/矛盾/缺失/层级）](01_编辑审计.md) · [概念依赖·学习路径·未来扩展](02_学习路径与未来扩展.md) · [使用路径与任务路由](03_使用路径与任务路由.md)
 
 ## 知识库全景
@@ -19,7 +19,7 @@ tags: [AI工程, 知识图谱, 统一框架, 总编辑]
 | 2 | [Multi-Agent 架构手册](multi-agent-patterns-handbook/00_INDEX.md) | 多体协调模式 | 方法 | 15 模式 |
 | 3 | [AI 决策框架大全](decision-frameworks-guide/00_INDEX.md) | 决策工具箱 | 方法+原则 | 27 框架 |
 | 4 | [LLM Design Patterns](llm-design-patterns/00_INDEX.md) | 推理与推断模式 | 方法 | 24 模式 |
-| 5 | [Agent 圣经](agent-bible/00_INDEX.md) | Agent 角色落地 | 方法 | 21 Agent |
+| 5 | [Agent 圣经](agent-bible/00_INDEX.md) | Agent 角色入口 + 能力运行规则 | 方法 | 21 个角色卡 + 5 个生产级运行规则样板 |
 | 6 | [The Laws of AI Engineering](laws-of-ai-engineering/00_INDEX.md) | Law System / 约束库 | 规律 | 102 Law |
 | 7 | [The Foundation of AI Engineering](foundation-of-ai-engineering/00_INDEX.md) | 隐性知识蒸馏 | 原则+元规律 | 7 章 |
 | 8 | [The Evaluation of AI Systems](evaluation-of-ai-systems/00_INDEX.md) | 评价理论 | 原则+方法 | 7 部 |

diff --git a/01_编辑审计.md b/01_编辑审计.md
@@ -12,7 +12,7 @@ tags: [AI工程, 编辑审计, 重复, 矛盾, 缺失]
 
 > [!important] 活任务队列归口（2026-07-08）
 > 本文末尾的「待办清单」是后续批次的唯一活任务队列。其他治理文件（例如 [[_governance/laws/LAWS_REWRITE_GRAND_PLAN]]、[[_governance/laws/LAW_REFERENCE_SYSTEM_CLOSURE]]、[[_governance/laws/LAW_REFERENCE_REMAINING_CANDIDATES]]、`_governance/fable5/FABLE5_架构收束REVIEW.md`）作为依据、审计或快照保留；若它们的“下一步”措辞与本清单冲突，以本清单为准。
-> 本文三段结构：**审计正典**（第一～四节与审计总结——2026-07-06 的历史判断，原文不再改，只追加状态注记）→ **修复轮记录**（按日期追加）→ **待办清单**（唯一活动区）。
+> 本文三段结构：**审计原文**（第一～四节与审计总结——2026-07-06 的历史判断，原文不再改，只追加状态注记）→ **修复轮记录**（按日期追加）→ **待办清单**（唯一活动区）。
 
 ---
 
@@ -204,19 +204,22 @@ Foundation 提出了"技巧<方法<原则<规律<元规律"五层，这是整个
 - **P2 追加二十四（2026-07-10，非 Core Laws 风险排序外部核验）**：按主动 heading 入链、强模态与安全/可靠性风险选出 18 条高影响非 Core Law，集中 citation 已写入 [[laws-of-ai-engineering/00_EXTERNAL-REFERENCES|Laws 外部依据说明]]，全库去重覆盖提升到 **41/102**。其中 Law 47/72/79 保留正文，Law 2/3/21/25/30/31/36/41/42/63/71/76/77/92/99 共 15 条收窄：纠正 softmax、停机问题、可观测性/可控性、热力学熵等过度理论化解释，并撤销“必然退化、唯一手段、恢复应对一切、简单必然存活”等绝对措辞。编号与 heading 全部保留；Constitution、ADS、Foundation、Evaluation、Production、Anti-patterns、Multimodal 与 Human-AI 高确信度主动转述已同步。逐条裁决见 [[_governance/laws/NON_CORE_LAWS_RISK_RANKED_EXTERNAL_AUDIT|非 Core 风险排序核验]]；剩余 61 条回到季度候选池，不机械清零。
 - **P2 追加二十五（2026-07-10，M6–M8 与 v1.0 收束）**：完成 [[_governance/content/M6_M8_SCOPE_AND_VERSION_READINESS_REVIEW|M6–M8 立项与 v1.0 收束审计]]。裁决：M6 治理深化与 M7 组织采纳未来合并为一个组织级运行层，只有出现明确读者/组织场景、真实案例、法域边界和维护责任时才立项；M8 继续排除在正典外，只允许 dated snapshot。三者均不阻塞当前版本，知识库内容架构进入 v1.0 发布候选；本轮不创建 `v1.0` tag 或 GitHub Release。
 
-### 待办清单（后续批次的唯一正典位置，做完即勾）
+### 待办清单（后续批次的唯一有效位置，做完即勾）
 - **P2 追加十（2026-07-09，Laws citation 呈现架构）**：采纳“正文轻量入口 + 集中 citation 文档”的方案，新增 [[laws-of-ai-engineering/00_EXTERNAL-REFERENCES|Laws 外部依据说明]]，并在 11 个 Law family 文件开头加入默认折叠的 `cite` callout。原则：Law 正文不堆 citation；研究型阅读从集中入口进入。
 - **P2 追加十一（2026-07-09，学习路径 / 使用路径收束）**：新增 [[03_使用路径与任务路由|使用路径与任务路由]]，把“长期怎么读”和“有具体任务时从哪里进入”分开：学习走 [[02_学习路径与未来扩展|长期学习路径]]，做事走 ADS，找样板走 Case Library，维护走 [[MAINTENANCE|维护手册]] 与本文待办清单。README 与总图已接入该入口。
 - **P2 追加十二（2026-07-09，使用路径 Dogfood Audit）**：完成 [[_governance/usage-router/USAGE_ROUTER_DOGFOOD_AUDIT|使用路径与任务路由 Dogfood Audit]]，用 10 个真实任务验收“任务→使用路径→ADS→案例→书籍”链路。结论：8 个通过、1 个轻微摩擦（SIT-19 人机协作制度设计未进入常见任务一键入口）、1 个文案小错（“四种入口”实际 A–E 五类）。本轮先审计；随后低风险小修已完成：[[03_使用路径与任务路由#五种入口|五种入口]] 标题修正，且 [[03_使用路径与任务路由#我在设计人与 AI 的协作制度|SIT-19 人机协作制度设计入口]] 已补齐。
 
 
 
 
-> **执行档位说明**（按本库第一章三判据分派）：🟢 可委托便宜模型（规格明确、工具可机械验收）｜🟡 便宜模型起草/盘点 + 强模型或人验收裁决｜🔴 需强模型主笔（正典设计决策/事实敏感/洗稿风险）。
-> **委托红线**：便宜模型禁改宪法、Laws 定律定义、决策系统正典（03/04）、README 与总图的数字；每批改动后必跑 `_tools/kb_health_check.py`；git 按批提交；新增数字一律带"经验量级/编排值"标注。
+> **执行档位说明**（按本库第一章三判据分派）：🟢 可委托便宜模型（规格明确、工具可机械验收）｜🟡 便宜模型起草/盘点 + 强模型或人验收裁决｜🔴 需强模型主笔（核心定义设计决策/事实敏感/洗稿风险）。
+> **委托红线**：便宜模型禁改宪法、Laws 定律定义、决策系统核心定义（03/04）、README 与总图的数字；每批改动后必跑 `_tools/kb_health_check.py`；git 按批提交；新增数字一律带"经验量级/编排值"标注。
 > **队列规则**：治理快照可以提出建议，但不能另立活队列。后续 Agent 开工时先看本清单；做完一项后在这里勾选，并在相关快照处只补状态 note 或回链。
 
 **内容增量**
+- [x] 🔴 P1-A《从零到 AI Agent 专家》关键章实验包——✅ 已完成（2026-07-10 至 2026-07-12）：第 2/5/7 章试点后，第 9/10/12 章继续补齐版本评测门禁、安全发布证据与毕业项目审计；六套实验包统一包含环境自检、可运行 Starter、分步任务、预期产物、故障排查、机械验收、100 分 rubric 与参考实现，参考代码均已从 Markdown 抽取并实际运行。课程 INDEX 与六章均已接入。技术可执行性已验证；真实零基础学习者试读因用户暂无时间未执行，教学有效性仍待后验观察。详见 [[_governance/content/BOOK_EXPANSION_PRIORITY_AUDIT|十五本书扩写优先级审计]]。
+- [x] 🔴 P1-B《The Evaluation of AI Systems》端到端样板——✅ 已完成（2026-07-12）：新增 [[evaluation-of-ai-systems/08_端到端评价工程样板|实践附录]]，用研究助理 Agent 串联评价规格、开发/冻结数据、规则/Judge/人工评分器、Judge 校准、重复运行、发布门禁、生产回流与元评价；证据包审计器 5 项测试与样例集成验证通过。原七个理论 Part 保持不变。
+- [x] 🔴 P1-C《Agent 圣经》五个能力契约样板——✅ 已完成（2026-07-12）：按 [[_governance/content/AGENT_BIBLE_P1C_SCOPE_AUDIT|立项审计]]分四批实施。收窄 INDEX 的“直接进生产”承诺；新增 [[agent-bible/contracts/00_INDEX|能力契约层]]与共享 schema；研究取证、独立事实核查、架构取舍、根因诊断、标准化评审共 5 个契约，含 50 个契约测试用例定义和 5 条终态 trace 样例；Markdown 严格编译到单一 machine JSON，体检接入同步、权限、ADS ID 与语义校验。当前未连接真实模型运行时，不把 fixture 校验表述成行为测试已通过。未新增 Agent/ADS 编号，未扩写其余十六个角色。
 - [x] 🟡 案例库双层结构维护——✅ 已完成（2026-07-09）：保持 100 案广覆盖精简层，升级 20 个深度样板（十类各 2 个；清单见 [[ai-engineering-case-library/00_INDEX|案例库总索引]] 与 [[_governance/ads-case/CASE_LIBRARY_DOUBLE_LAYER_MAINTENANCE_AUDIT|候选审计]]）。未全量深度化，剩余 80 个案例保持快读层。
 - [x] 🔴 M3《Multimodal Systems》新书——✅ 已完成（2026-07-09，Fable 5）：6 章 + INDEX，按立项审计边界执行（模态扩展层、编号纪律、止损判据自检通过）
 - [x] 🟡 SIT-21（多模态输入情境）评估与实施——✅ 已完成（2026-07-10）：新增 [[agent-decision-system/01_SITUATION-ROUTER#SIT-21 · 我在做多模态输入 / 截图 / 语音 / 视频驱动的 Agent|SIT-21]]，编译器与交叉校验口径同步到 21 个情境
@@ -247,4 +250,4 @@ Foundation 提出了"技巧<方法<原则<规律<元规律"五层，这是整个
 - [x] 🟢 使用路径 Dogfood 小修——✅ 已完成（2026-07-09）：根据 [[_governance/usage-router/USAGE_ROUTER_DOGFOOD_AUDIT|Dogfood Audit]]，已把 [[03_使用路径与任务路由#五种入口|“五种入口”]] 标题修正，并在“常见任务的一键入口”补 [[agent-decision-system/01_SITUATION-ROUTER#SIT-19 · 我在设计人与 AI 的协作制度|SIT-19 人机协作制度设计]]；体检通过。
 - [x] 🟡（可选）风险排序的外部引用核验——✅ 已完成（2026-07-10）：在既有 23 条基础上新增核验 18 条高影响非 Core Law，全库去重覆盖 **41/102**；15 条正典收窄、3 条保留正文，集中 citation 与下游主动转述同步。剩余 61 条为季度候选池，不机械清零；详见 [[_governance/laws/NON_CORE_LAWS_RISK_RANKED_EXTERNAL_AUDIT|风险排序核验]]。
 
-维护方式：任何结构改动后运行 `python3 _tools/kb_health_check.py`；决策系统 md 改动后运行 `python3 _tools/compile_decision_system.py` 同步机器格式。
+维护方式：任何结构改动后运行 `python3 _tools/kb_health_check.py`；决策系统 Markdown 改动后运行 `python3 _tools/compile_decision_system.py`，同步自动生成的 YAML 文件。
diff --git a/02_学习路径与未来扩展.md b/02_学习路径与未来扩展.md
@@ -131,12 +131,12 @@ tags: [AI工程, 学习路径, 概念依赖, 未来扩展]
 ### 第三优先：成熟化领域
 
 - **M6/M7 已完成立项裁决，当前不分别写两本书**：未来若出现明确组织场景，合并为《AI Governance & Organizational Adoption》组织级运行层；稳定正文写台账、风险分级、决策权、生命周期证据与规模化机制，具体法域/行业规则放带日期的 profile。触发条件和边界见 [M6–M8 立项与 v1.0 收束审计](_governance/content/M6_M8_SCOPE_AND_VERSION_READINESS_REVIEW.md)。
-- **M8 工具与 benchmark 继续排除在正典之外**：只有具体课程或项目需要时才做带 `as_of / versions / review_by` 的 dated snapshot，过期即标 stale / archived。
+- **M8 工具与 benchmark 继续排除在长期维护的核心内容之外**：只有具体课程或项目需要时才做带 `as_of / versions / review_by` 的 dated snapshot，过期即标 stale / archived。
 
 ### 持续维护：让知识库自己活下去
 
 - ~~**抽象层标注**~~（[H3](01_编辑审计.md)）——✅ 已落地（2026-07-07）：158/158 文件全覆盖；Laws 全书另试点 `stability` 字段。
-- ~~**正典指定 / Law System 口径**~~（[R1/R2](01_编辑审计.md)）——✅ 已落地并升级（2026-07-08）：Laws INDEX 已从“七条核心定律正典”升级为 Law System 入口，包含 [Core Laws](laws-of-ai-engineering/00_CORE-LAWS.md)、[Law Relation Graph](laws-of-ai-engineering/00_LAW-RELATION-GRAPH.md)、[Reference Policy](laws-of-ai-engineering/00_REFERENCE-POLICY.md) 与全 102 条 metadata schema。
+- ~~**定义归属 / Law System 口径**~~（[R1/R2](01_编辑审计.md)）——✅ 已落地并升级（2026-07-08）：Laws INDEX 已从“七条核心定律的统一定义”升级为 Law System 入口，包含 [Core Laws](laws-of-ai-engineering/00_CORE-LAWS.md)、[Law Relation Graph](laws-of-ai-engineering/00_LAW-RELATION-GRAPH.md)、[Reference Policy](laws-of-ai-engineering/00_REFERENCE-POLICY.md) 与全 102 条 metadata schema。
 - ~~**INDEX 消歧**~~（[H1](01_编辑审计.md)）——✅ 已落地（2026-07-07）：353 处歧义链接全部改为路径式，14 个 INDEX 补 aliases，未采用物理重命名。
 - ~~**演化说明**~~——✅ 已落地：CoT 条目"三重口径"callout、教材第 6 章 RAG 边界两面。新方法入库时继续沿用此纪律。
 - **定期重估**（唯一保持开放的维护项）：按 [模式重洗定律](llm-design-patterns/00_INDEX.md)，每隔一段时间用"如果模型强 100 倍，这条还成立吗"重新审视全库，把过时的方法移入"历史"区，把新的补上。**一个活的知识库，应该像它教的系统一样——持续评价、持续演化、诚实面对自己的退化。**

diff --git a/03_使用路径与任务路由.md b/03_使用路径与任务路由.md
@@ -107,7 +107,7 @@ tags: [AI工程, 使用路径, 任务路由, 学习路径, AgentDecisionSystem]
 适合场景：
 
 - 修链接、改元数据、更新 README；
-- 改 Laws / ADS / Case Library 的正典内容；
+- 改 Laws / ADS / Case Library 的核心定义；
 - 判断某个任务是不是活任务。
 
 维护者不要从历史审阅文件直接开工。活任务以 [编辑审计](01_编辑审计.md) 待办清单为准。
@@ -259,7 +259,7 @@ ADS 是机器可调用投影。人可以读，但它的最佳用途是：**把
 4. **回查理论**：只读相关 Law / Pattern / Anti-Pattern / Evaluation，不线性读全书。
 5. **做出设计决策**：写出方案、取舍、边界、不做什么。
 6. **设定验收标准**：用 [Eval Checklist](agent-decision-system/05_EVAL-CHECKLIST.md) 或 [Constitution 十问](The-Constitution-of-AI-Engineering.md) 检查。
-7. **沉淀经验**：如果这是新类型问题，补案例或维护路由；如果只是一次性任务，不要污染正典。
+7. **沉淀经验**：如果这是新类型问题，补案例或维护路由；如果只是一次性任务，不要写进长期维护的核心内容。
 
 ---
 

diff --git a/AGENTS.md b/AGENTS.md
@@ -81,4 +81,4 @@ python3 _tools/check_ads_case_crossrefs.py
 - [ADS Antipattern Detectors](agent-decision-system/03_ANTIPATTERN-DETECTORS.md)
 - [ADS Law Invariants](agent-decision-system/04_LAW-INVARIANTS.md)
 
-能机械修的结构问题可以修；正典判断、整本书立项、外部 citation 全量扩展需要先提案。
+能机械修的结构问题可以修；涉及核心定义的判断、整本书立项、外部 citation 全量扩展需要先提案。
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -21,7 +21,7 @@ tags: [AI工程, KnowledgeBase, GitHub, 协作, 维护]
 | 治理文档 | 审计、计划、收束记录 | 可以新增，但不能另开活任务队列 |
 | 工具脚本 | `_tools/*.py` | 必须本地验证 |
 | ADS / Case Library | 情境路由、案例直达、机器 YAML | 改 Markdown 后按规则编译/检查 |
-| 正典层 | Constitution、Laws 定义、ADS invariant / detector | 高风险，先提案再改 |
+| 核心规则层 | Constitution、Laws 定义、ADS invariant / detector | 高风险，先提案再改 |
 
 ## 2. 活任务只看一个地方
 
@@ -46,7 +46,7 @@ tags: [AI工程, KnowledgeBase, GitHub, 协作, 维护]
 python3 _tools/kb_health_check.py
 ```
 
-如果改动涉及 `agent-decision-system/` 的正典 Markdown，还要运行：
+如果改动涉及 `agent-decision-system/` 中作为定义来源的 Markdown，还要运行：
 
 ```bash
 python3 _tools/compile_decision_system.py
@@ -98,7 +98,7 @@ CI 只是结构护栏，不替代主编判断。它能发现断链、歧义、
 - [ADS Antipattern Detectors](agent-decision-system/03_ANTIPATTERN-DETECTORS.md)
 - [ADS Law Invariants](agent-decision-system/04_LAW-INVARIANTS.md)
 
-可以修链接、元数据、明显格式问题；不要顺手改正典含义。
+可以修链接、元数据、明显格式问题；不要顺手改变核心定义的含义。
 
 ## 8. 贡献的许可证