代理上下文审计：当您自己的治理成为问题——以及如何在不失去任何东西的情况下修复它

wc -l AGENT.adoc AGENT_MODUS_OPERANDI.adoc PROMPT_REPRISE.adoc \
  .agents/INDEX.adoc .agents/SESSIONS_HISTORY.adoc \
  .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc

  287 AGENT.adoc
  627 AGENT_MODUS_OPERANDI.adoc
   51 PROMPT_REPRISE.adoc
  218 .agents/INDEX.adoc
   18 .agents/SESSIONS_HISTORY.adoc
  213 .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc
 1414 total

@startuml
skinparam backgroundColor #FEFEFE

title 上下文 EAGER — 1414 行
rectangle "AGENT_MODUS_OPERANDI\n**627 行 (44%)**" as MOD #FFCDD2
rectangle "AGENT.adoc\n287 行 (20%)" as AG #BBDEFB
rectangle "INDEX.adoc\n218 行 (15%)" as IDX #C8E6C9
rectangle "COMPLETED_TASKS\n213 行 (15%)" as ARC #FFF9C4
rectangle "PROMPT_REPRISE\n51 行 (4%)" as PRO #E1BEE7
rectangle "SESSIONS_HISTORY\n18 行 (1%)" as HIS #FFE0B2

note bottom of MOD
记录该方法的文件已成为最大的一笔开支
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title 审计 AGENT_MODUS_OPERANDI.adoc — 627 行
left to right direction

rectangle "🟡 **重复项**\n167 行 (27%)" as DUP #FFF9C4 {
  card "P3 — 绝对规则\n(34 行)" as D1
  card "P4 — 生命周期\n(133 行)" as D2
  card "P9 — 参考\n(30 行)" as D3
}

rectangle "🔴 **未查看**\n215 行 (34%)" as JAM #FFCDD2 {
  card "P5 — 指标\n(49 行)" as J1
  card "P6 — 检测\n(72 行)" as J2
  card "P7 — 改进\n(39 行)" as J3
  card "P8 — Bootstrap\n(13 行)" as J4
  card "附录 — 词汇表\n(42 行)" as J5
}

rectangle "🟢 **唯一知识**\n161 行 (26%)" as UNI #C8E6C9 {
  card "P1 — 概览\n(64 行)" as U1
  card "P2 — 文件结构\n(97 行)" as U2
}

note bottom of UNI
这就是必须保存在 EAGER 中的。
其余 → 冷存储。
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title 百科拆分 — AGENT_MODUS_OPERANDI
left to right direction

rectangle "**AGENT_MODUS_OPERANDI.adoc**\n627 行\n(拆分前)" as BEFORE #FFCDD2 {
}

rectangle " " as ARROW1
rectangle " " as ARROW2

rectangle "**LAZY_EAGER_ESSENTIALS.adoc**\n**~50 行 — EAGER**" as ESS #C8E6C9 {
  card "P1 精简\n(15 行)" as E1
  card "P2 精简\n(35 行)" as E2
}

rectangle "**.agents/encyclopedies/**\n**LAZY_EAGER_ENCYCLOPEDIE.adoc**\n627 行 — COLD" as ENC #BBDEFB {
  card "P1 至 附件\n(int完整, 未更改)" as C1
}

BEFORE -[#4CAF50]-> ESS : "提取\n关键知识"
BEFORE -[#2196F3]-> ENC : "保留 int完整\n的工程"

note bottom of ESS
在会话开始时自动加载
→ 代理理解词汇
end note

note bottom of ENC
永不自动加载
可供人类查看
用于未来蒸馏的原始材料
end note

@enduml

= Stratégie LAZY/EAGER — Principes Essentiels

[abstract]
Ce fichier définit la stratégie de gestion du contexte agent.
Chargé automatiquement (EAGER) en début de session.

== Principes

|===
| EAGER | LAZY
| Tableau de bord | Manuel du propriétaire
| Chargé automatiquement | Chargé sur demande
| <= 100 lignes, <= 10k tokens | Illimité, détaillé
| Règles absolues, mission courante | Archives, historique, références
|===

== Politique de Chargement

|===
| Fichier | Type | Quand charger
| PROMPT_REPRISE.adoc | EAGER | Début session (auto)
| *_ESSENTIALS.adoc | EAGER | Début session si EPIC active
| .agents/INDEX.adoc | EAGER | Début session (auto)
| *_REFERENCE.adoc | LAZY | Sur besoin (détails architecture)
| .agents/sessions/N-*.adoc | LAZY | Sur demande (détails session)
| .agents/encyclopedies/*.adoc | COLD | Jamais auto (humain seulement)
|===

== Comment l'Agent Sait Quoi Charger

Début session → PROMPT_REPRISE + INDEX + ESSENTIALS actifs.
Besoin de détails → charger les *_REFERENCE et sessions/ en LAZY.
Connaissance froide → encyclopedies/, jamais automatique.

 287 AGENT.adoc
 627 AGENT_MODUS_OPERANDI.adoc
  51 PROMPT_REPRISE.adoc
 218 .agents/INDEX.adoc
  18 .agents/SESSIONS_HISTORY.adoc
 213 .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc
1414 total

 287 AGENT.adoc
  50 LAZY_EAGER_ESSENTIALS.adoc       ← remplace 627 lignes
  51 PROMPT_REPRISE.adoc
 218 .agents/INDEX.adoc
  18 .agents/SESSIONS_HISTORY.adoc
 213 .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc
 837 total                              ← -41%

@startuml
skinparam backgroundColor #FEFEFE

title 上下文 EAGER 在百科分割后 — 837 行 (-41%)
rectangle "AGENT.adoc\n287 行 (34%)" as AG #BBDEFB
rectangle "INDEX.adoc\n218 行 (26%)" as IDX #C8E6C9
rectangle "COMPLETED_TASKS\n213 行 (25%)" as ARC #FFF9C4
rectangle "PROMPT_REPRISE\n51 行 (6%)" as PRO #E1BEE7
rectangle "ESSENTIALS\n50 行 (6%)" as ESS #A5D6A7
rectangle "SESSIONS_HISTORY\n18 行 (2%)" as HIS #FFE0B2

note bottom of ESS
从 627 → 50 行
577 行工程
保存在冷存储中
没有任何丢失。全部已重新定位。
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 220

title 代理治理三部曲
left to right direction

package "📖 **Article 0108**\nEager 策略/Lazy" as A1 #E8F5E9 {
  card "代理记忆\n在会话之间" as M1
  card "文件 EAGER\n(自动加载)" as M2
  card "文件 LAZY\n(按需)" as M3
  card "6 步骤流程" as M4
}

package "🧊 **Article 0110**\nHot 机制/Warm/Cold" as A2 #FFF9C4 {
  card "老化\n上下文" as V1
  card "滑动窗口\n10 会话" as V2
  card "冷波\n相同" as V3
  card "传感器\n双触发器" as V4
}

package "🔍 **Article 0111**\n审计 + 百科解决方案" as A3 #BBDEFB {
  card "文件审计\nEAGER" as E1
  card "识别\n浪费" as E2
  card "拆分\nESSENTIALS/encyclopédie" as E3
  card "保留\n工程" as E4
}

A1 --> A2 : "记忆增长\n→ 需要一个机制\n老化"
A2 --> A3 : "老化不足\n→ 需要审计哪些\n值得被放在 EAGER"

note bottom of A3
✅ 三层已就位
在6个活跃项目中
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title 代理上下文审计程序 — 5 步骤
start

:1. **测量**\n`wc -l *.adoc .agents/*.adoc`;

if (Total > 1000 lignes ?) then (oui)
  :上下文过于沉重;
else (non)
  :✅ Contexte OK;
  stop
endif

:2. **识别嫌疑人**\n文件 > 20% 的总计;

:3. **逐段审计**\n对于每个章节 :\n• 已在其他地方 ? → 重复\n• 从未使用 ? → 死亡\n• 唯一信息 ? → 关键;

:4. **Classifier**\n🟡 重复项 → 从 EAGER\n中移除🔴 从未使用 → 冷存储\n🟢 唯一知识 → 保留;

:5. **拆分器**\n🟢 → ESSENTIALS（~50 行，EAGER）\n🟡🔴 → encyclopedies/（冷存储）;

:✅ 优化的上下文 \n，无工程损失;

stop

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam nodeBackgroundColor #E3F2FD

title 针对上下文饱和的深度防御
node "**代理上下文**\n~800 行\n健康" as CTX #C8E6C9

node "层 1\n**EAGER / LAZY**" as C1 #BBDEFB
node "层 2\n**HOT / WARM / COLD**" as C2 #BBDEFB
node "第3层\n**ESSENTIALS / ENCYCLOPÉDIE**" as C3 #BBDEFB

CTX --> C1 : "结构按\n**可用性**"
CTX --> C2 : "结构 par\n**新鲜度**"
CTX --> C3 : "结构 按\n**密度**"

note bottom of C3
这三层是必需的。单独任何一层都不够。
end note

@enduml