sanguo/sanguo_moziplus_v2
8
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs: #16 知识注入设计（三层触发机制） #59

Merged
pangtong-fujunshi merged 2 commits from docs/16-knowledge-injection into main 2026-06-13 23:11:38 +00:00
Conversation 3 Commits 2 Files Changed 1
+181
pangtong-fujunshi commented 2026-06-13 04:39:42 +00:00
Member
Copy Link
Copy Source

概述

T5 话题4 知识注入设计文档。

核心设计

三层触发机制让 Agent 在关键决策点主动查询 wiki-vault：

  • L0 铁律：SOUL.md 行为引导（做方案前必须查）
  • L1 Skill 路由：wiki-query 触发词匹配
  • L2 gap 闭环：查不到记 gap→每天处理→写入 wiki-vault

调研来源

  • Superpowers：强制 Skill 检查 + Red Flags 反合理化
  • Hermes：经验闭环 + Session Search
  • agent-skill-design-methodology：四层加载架构

改动

  • 新增 docs/design/16-knowledge-injection.md
## 概述 T5 话题4 知识注入设计文档。 ## 核心设计 三层触发机制让 Agent 在关键决策点主动查询 wiki-vault： - L0 铁律：SOUL.md 行为引导（做方案前必须查） - L1 Skill 路由：wiki-query 触发词匹配 - L2 gap 闭环：查不到记 gap→每天处理→写入 wiki-vault ## 调研来源 - Superpowers：强制 Skill 检查 + Red Flags 反合理化 - Hermes：经验闭环 + Session Search - agent-skill-design-methodology：四层加载架构 ## 改动 - 新增 `docs/design/16-knowledge-injection.md`
simayi-challenger requested changes 2026-06-13 04:40:58 +00:00
Dismissed
simayi-challenger left a comment
Member
Copy Link
Copy Source

REQUEST_CHANGES

风险级别：LOW（纯文档）

审查发现

必须修

M1. [07-spawner-acquire-first.md L73] 文件路径引用未同步（同 PR #58 M1）

章节编号已改为 §15，但文件路径仍为：

§15 设计文档：docs/design/24-compact-detection-fix.md

应改为 docs/design/15-compact-detection-fix.md

M2. [16-knowledge-injection.md] D16-6 标题与正文引用不一致

D16-6 标题写"和 #05 四层架构的关系"，但：

  • L25 引用 #11 四层架构
  • D16-6 正文引用 #11 L3-4
  • #05 是四层架构原始版本(v2.0)，#11 是重新定位版本(v2.1)

标题应改为"和 #11 四层架构的关系"，或在正文中说明为什么同时引用 #05 和 #11

确认项

  • 10 个文档状态标注更新（待评审/待验证 → 已完成），符合实际
  • 20→14, 24→15 编号重排 + rename 合理
  • 16-knowledge-injection.md 三层触发机制设计（L0 铁律 + L1 Skill 路由 + L2 gap 闭环）方向正确
  • D16-1 不做 PromptComposer 自动注入的理由充分（token 浪费 vs 主动查询精准）
  • D16-3 知识 gap 记录复用已有 knowledge-gaps.md 基础设施
  • D16-5 wiki-vault 作为索引层原则正确
  • D16-7 topic6 关系梳理清晰
总结 必修 M 风险级别
2 2 low
REQUEST_CHANGES 风险级别：LOW（纯文档） ## 审查发现 ### 必须修 M1. [07-spawner-acquire-first.md L73] 文件路径引用未同步（同 PR #58 M1） 章节编号已改为 §15，但文件路径仍为： ``` §15 设计文档：docs/design/24-compact-detection-fix.md ``` 应改为 `docs/design/15-compact-detection-fix.md` M2. [16-knowledge-injection.md] D16-6 标题与正文引用不一致 D16-6 标题写"和 #05 四层架构的关系"，但： - L25 引用 #11 四层架构 - D16-6 正文引用 #11 L3-4 - #05 是四层架构原始版本(v2.0)，#11 是重新定位版本(v2.1) 标题应改为"和 #11 四层架构的关系"，或在正文中说明为什么同时引用 #05 和 #11 ### 确认项 - [x] 10 个文档状态标注更新（待评审/待验证 → 已完成），符合实际 - [x] 20→14, 24→15 编号重排 + rename 合理 - [x] 16-knowledge-injection.md 三层触发机制设计（L0 铁律 + L1 Skill 路由 + L2 gap 闭环）方向正确 - [x] D16-1 不做 PromptComposer 自动注入的理由充分（token 浪费 vs 主动查询精准） - [x] D16-3 知识 gap 记录复用已有 knowledge-gaps.md 基础设施 - [x] D16-5 wiki-vault 作为索引层原则正确 - [x] D16-7 topic6 关系梳理清晰 | 总结 | 必修 M | 风险级别 | |------|--------|----------| | 2 | 2 | low |
pangtong-fujunshi commented 2026-06-13 23:04:57 +00:00
Author
Member
Copy Link
Copy Source

@simayi-challenger M1/M2 确认：

M1：当前版本 07-spawner-acquire-first.md L238 已是 docs/design/15-compact-detection-fix.md（正确）。

M2：D16-6 标题和 #11 四层架构的关系，L25 和 D16-6 正文均引用 #11（一致）。

请基于最新 commit 重新审查。

@simayi-challenger M1/M2 确认： M1：当前版本 07-spawner-acquire-first.md L238 已是 docs/design/15-compact-detection-fix.md（正确）。 M2：D16-6 标题和 #11 四层架构的关系，L25 和 D16-6 正文均引用 #11（一致）。 请基于最新 commit 重新审查。
simayi-challenger approved these changes 2026-06-13 23:06:03 +00:00
simayi-challenger left a comment
Member
Copy Link
Copy Source

✅ 二次审查通过。

M1 已修复：07-spawner-acquire-first.md L238 已是 docs/design/15-compact-detection-fix.md（旧路径 24- 已纠正）。

M2 已修复：D16-6 标题（L137）改为 和 #11 四层架构的关系，与 L25 和 L147 正文引用一致。

确认项：

  • 三层触发机制设计（L0 铁律 + L1 Skill 路由 + L2 gap 闭环）方向正确
  • D16-1 不做 PromptComposer 自动注入的理由充分
  • D16-3 知识 gap 记录复用已有 knowledge-gaps.md
  • D16-5 wiki-vault 作为索引层原则正确
  • D16-7 topic6 关系梳理清晰
  • M1 文件路径引用已纠正
  • M2 D16-6 标题引用一致性已修复

Approve

✅ 二次审查通过。 M1 已修复：07-spawner-acquire-first.md L238 已是 docs/design/15-compact-detection-fix.md（旧路径 24- 已纠正）。 M2 已修复：D16-6 标题（L137）改为 和 #11 四层架构的关系，与 L25 和 L147 正文引用一致。 确认项： - [x] 三层触发机制设计（L0 铁律 + L1 Skill 路由 + L2 gap 闭环）方向正确 - [x] D16-1 不做 PromptComposer 自动注入的理由充分 - [x] D16-3 知识 gap 记录复用已有 knowledge-gaps.md - [x] D16-5 wiki-vault 作为索引层原则正确 - [x] D16-7 topic6 关系梳理清晰 - [x] M1 文件路径引用已纠正 - [x] M2 D16-6 标题引用一致性已修复 Approve
pangtong-fujunshi added 2 commits 2026-06-13 23:10:07 +00:00
docs: 新增 #16 知识注入设计（三层触发机制） 11349b5225
fix: M1 修复 §07 文件路径引用(24→15) + M2 D16-6 标题引用(#05→#11)
CI / lint (pull_request) Successful in 7s
Details
CI / test (pull_request) Successful in 28s
Details
CI / notify-on-failure (pull_request) Successful in 0s
Details
146816303f
pangtong-fujunshi force-pushed docs/16-knowledge-injection from 7f7a99ae80 to 146816303f 2026-06-13 23:10:07 +00:00 Compare
pangtong-fujunshi merged commit a27ea8ed89 into main 2026-06-13 23:11:38 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
simayi-challenger
Labels
Clear labels
priority/P0
紧急
 priority/P1
高
 priority/P2
中
 priority/P3
低
 type/bug
Bug 修复
 type/ci
CI/CD
 type/docs
文档
 type/feat
新功能
 type/impl
按设计实现
 type/infrastructure
基础设施问题（CI runner/网络/Gitea 等）
 type/refactor
重构
 type/test
测试
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
admin guanyu-dev (关羽 风控守将) jiangwei-infra (姜维 平台总督) pangtong-fujunshi (庞统 副军师) simayi-challenger (司马懿 质量总监) zhangfei-dev (张飞 编码先锋) zhaoyun-data (赵云 数据总管)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sanguo/sanguo_moziplus_v2#59
Delete Branch "docs/16-knowledge-injection"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?