v0.4.0 · 冷启动与锚点行

检索这一环修了三处，都是实测撞出来的。

钩子（零件 3）

• 「动手前」拆成两步：① 冷启动 —— 任务里只有 URL / 仓库链接、还没有任何现象词时，撞墙之前先搜一次；② 撞上现象（原规则）
• 第一次失败后必须回头查一次卡库，再动手修
• 给确切命令，不再只写动词：grep -il "锚点.*<任务词>" 优先，没命中再退全文 grep -il "<任务词>"
• 明令不要用 glob / 列目录挑卡 —— 列名看不到锚点

卡（零件 2）

• 新增 > **锚点**： 行 —— 任务里会原样出现的字（域名 / 命令名 / 扩展名 / 报错原文），5–8 个，中文描述不算
• 锚点层是精确索引：同一个任务词，锚点层命中 1 张；全文层会把正文里偶然提到的无关卡一起带出来

实测与修正

• 冷启动三次对比：直接抓网页（4 次失败）→ 加冷启动（1 次）→ 再收「搜完必须打开第一张、别用 glob」（0 次）
• 反面样本：任务里说「跑一下看看」时，agent 会跳过卡去跑实验，而实验只覆盖它想到的那个变量
• 修正 2026-10-18 的结论：「列目录挑卡更省」只在卡名 ≈ 任务词时成立
• 新增反模式 8：把「搜」写成动词、不给确切命令

升级建议：只改钩子第 1 条 + 给现有卡各补一行锚点，就能复现这套效果，不需要动 tools/ 里的任何脚本。

v0.3.0 · 工具与反模式

机制没变，补齐了「卡攒多之后怎么办」的那一半。

tools 三件套

• procedures-audit.mjs —— 卡库静态体检（结构缺段 / 断链 / 体积 / 触发词覆盖 / 对象失效 / 结论偏旧），只读
• procedures-review.mjs —— 按分层复核期找「久未触发」的卡（fixed 不复核 / env 90 天 / task 180 天）
• scan-sessions.mjs 新增 results 模式 —— 搜工具结果里的报错码（calls 只匹配参数，搜结果类字符串必然 0 命中）

文档

• 反模式 6：把「不被读」的代价摆上台面（0.5 KB 钩子 vs 26 KB 全量注入）
• 反模式 7：入卡也要人审 —— 写卡权限不能整个交给 agent
• 多 agent 环境：每个 agent 都要单独验一遍钩子
• 与记忆插件的关系：只在与「经验沉淀」功能重叠时冲突
• 检索示例补 POSIX（原只有 PowerShell）

v0.2.0 · 索引降级

结构大改：索引不再逐卡登记。

• 索引降级为消歧层（只留几对易混现象），现象词交给卡名 + 卡内触发行承载
• 钩子改为「先搜触发词」而不是「先读索引」
• 成本表更新为实测数据；「全部卡」一行注明为不可达对照线

v0.1.0 · 首次发布

机制 + 模板首次发布。

• 三零件：索引（现象消歧）、卡片（分类-现象.md）、钩子（写进 AGENTS.md）
• 成本结构：钩子常驻约 0.5 KB、卡按需读
• 模板：templates/AGENTS-snippet.md、card-template.md、INDEX.template.md