知识三层挂钩引擎

知识孤岛与变更盲区

在多项目并行的研发流程中，知识资产通常散落在 L1 层（YAML/Markdown 文档）、L2 层（Skills）与 L3 层（具体项目）中。当你修改了一个 L1 层的基础概念或约束时，很难立刻追踪到下游有哪些 Skill 或 Project 正在引用它。一旦忽略，就会导致运行环境静默失效。

工作原理与数据流

Knowledge Hook Engine 通过五个模块建立知识图谱，替代了人工维护链接的繁琐：

• scan_three_layers：扫描工作区路径，将 L1/L2/L3 的文件索引生成为 layers_index.json。
• build_entities 与 build_relations：解析索引，为每个 YAML 文件自动建立 entity，并从跨层引用中提取 relation，同步解析出的约束条件存入 constraint 表。
• check_invalidation：当 L1 层发生变更时，自动比对实体与关系，输出 invalidation_alerts.json，精准通知受影响的下游 L2/L3 组件。
• sediment_back：在项目执行遇到教训时，将验证后的规避方案自动回写（sediment）到 L1 层的 YAML 库中。

适用边界

该引擎依赖于清晰的文本引用结构与已有的项目执行流。如果你尚未建立任何 YAML/MD 知识库，或者目前完全没有可运行的 L3 层项目，暂时不需要引入此 Hook。它专为主动管理知识资产流失的团队设计，而非通用的代码静态检查工具。