v2.1.3 · 说明书收口：装上之后往哪放、遇到红旗别去找一个不存在的脚本

v2.1.3（2026-09-26）

这一轮修的全是「说明书」，不是分析能力。

上一轮那个外部工具（另一个编辑器的 agent）自己装上、自己分析、自己交付，把活干完了——
然后回来说了两件它踩到的事。两件都是说明书的坑。

一、SKILL.md 的红旗清单里，有一条指向包里没有的脚本

原文是「本地→开源包同步之后，没有跑 skill_audit.py 回潮检测就宣布完成」——
skill_audit.py 是验收方的工具，不在这个仓库里；而且这条场景（本地包 ↔ 开源包双线）
对使用者根本不适用。一个外人读到红旗清单，会以为要去找这个脚本。

已改成两种读者都成立的措辞：「改完内容/发布之后，没有跑独立于本次改动的回归检查就宣布完成」。

二、安装说明只列了三个工具名

原文写「适用于 WorkBuddy / Claude Code / Cursor」——那个工具自己推断出自己的 skills 目录在哪。
不在名单上的读者就都得靠猜。

现在写的是能通用的那条：

• 装的是整个文件夹，不是单个文件（它要读 references/ 里的卡库）
• 三条找目录的办法：① 查你所用工具的文档 ② 找不到就放进项目目录，然后对 AI 说「读 SKILL.md，按它干活」——一样能跑 ③ 装完开个新会话才会被发现（最后这条是那个工具实际踩到的）

三、USER-GUIDE.md 升级：之前公开版是旧的

顺手发现这本使用说明有两份：本地那份已经长到 123 行（开头更清楚、有完整的三步投喂法），
公开版还是 9-02 的 85 行简版。原因和之前几处缺陷同源 —— 它不在任何同步清单里，别的东西在动、它没动。
现在进清单了。

升级时还修掉 3 处指向包外文件的引用：原来写「打开 reading-analysis-SHARE.md」、
「解压 reading-analysis-完整包-*.zip」——这两个都在本地 dist/ 下，不在仓库里，
读者照着做会找不到。

新增机制：门禁 10 扩射程

原来第十道门禁只认两种写法（反引号包裹、带目录前缀），而上面那处 skill_audit.py
两种都不是（它是裸写的）→ 一直没被查到。现在补上第三种：裸写的脚本名。

• 只认 .py/.js/.json（.md 裸写太常见，不纳入——喊狼来了比没有门禁更坏）
• 两包实测零假阳性；反证过（把原案还原 → 门禁报「悬空」）
• 顺带修：这道门禁的自测夹具此前复制了一遍判据（与实现不同源，实现改了它也发现不了）
  → 抽出 _docref_scan_text()，主逻辑与夹具共用

安装（三种，任选）

1. 网页对话：复制 SKILL.md 全文（约 1.6 万字符）粘进任何 AI 对话框，然后发题。每次新对话要重粘
2. 装成 Skill（推荐）：把整个仓库放进你所用工具的 skills 目录。
   不确定放哪 → 放进项目目录，对 AI 说「读 SKILL.md，按它干活」。装完开新会话
3. RAG / API：references/cards/（127 张卡）挂知识库，SKILL.md 作 system prompt

装上之后，直接发一道题就行：「分析这道题」+ 原文和题目；喂错题时最好连你当时为什么选错一起给。

Full Changelog: v2.1.2...v2.1.3