learn-topic — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited learn-topic (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
按 5 步认知爬升结构讲一个新主题，让读者在 7-10 分钟内达到 Bloom Apply 层级（能在新场景应用该知识，不只是理解）。
学习科学锚定（详见 references/methodology.md）：CLT 的 worked example 梯度 + UbD 倒推设计 + Make It Stick 检索练习 + Productive Failure 的"先猜后看" + 4C/ID 的 authentic task 原则。
| 何时读 | 读哪个 |
|---|---|
| 第一次用，或写得不顺 | references/example.md（沉没成本完整带旁注样例） |
| 写每一步前需要详细模板 | references/templates.md |
| 想知道某个规则的"为什么" | references/methodology.md |
| 红旗触发但拿不准要不要修 | references/self-checks.md |
⚠️ 禁用 `@` 链接——会强制加载烧 context。让 Claude 按需读。
跨领域成熟读者：在自己领域是高手，但对该主题陌生。
1. Hook + 终点告知 (120-300 字)
2. 演示 I-do (400-700 字)
3. 拆解 (300-600 字)
4. 半练 We-do (300-500 字)
5. 独挑 You-do + 自检 (300-500 字)
主体总量：1500-2600 字
附录区 ：0-500 字（条件触发）💡 先想 30 秒 + --- 分隔线 + "答案" 标题💡 先想 1-2 分钟 + --- 分隔线 + "问题 N 参考答案" 标题| 附录 | 触发条件 |
|---|---|
| A 全景图（mermaid） | 多角色时序 / 状态机 / ≥5 节点 ≥7 边 / 历史脉络（4 选 1） |
| B 术语速查表 | 主题含 ≥5 新术语 |
| C 5W2H 速查 | 复合方法论（如 OAuth 流、限流体系） |
不触发就完全不写标题，不留空段。详细规则见 references/templates.md。
{cwd}/learn-topic_outputs/{YYYY-MM-DD}_{学习主题}.md_v2、_v3 后缀| 🚩 红旗 | 修复 |
|---|---|
| 第 1 步终点用"理解/掌握"而不是"能 [动作]" | 改成动作动词 |
| 第 1 句不是"小张做..."这种命名主角，而是"假设/你有没有..." | 命名真主角 |
| 第 1 句缺痛点数字三件套（公司类型/痛点数字/角色职责）任一项 | 把缺失项补齐——"小李做小程序"是假主角 |
| 第 2 步没有 30 秒 PF 预测题 | 在 worked example 之前插入 |
| 第 2 步某步没回答"为什么这步选 X 不选 Y" | example 缺决策密度，重选 |
| 第 2 步 example 是"假设有一个..."而非真职业/真场景 | 违反 authenticity，重选 |
| 第 3 步引入了第 2 步没出现过的新案例 | 严格反向，删 |
| 第 3 步所有边界都是纯术语描述（"流量平稳时"、"内部服务调用时"），无 1 条用第 2 步类比关键词 | 至少把 1 条边界翻译回类比，让边界条件可视化 |
| 第 3 步从头到尾用类比，无 1 句明示"类比在 X 处失效" | 加一句类比破点声明（沉默不算，必须 explicit） |
第 4/5 步答案没和问题视觉分隔（缺 💡 先想 + ---） | 加上分隔三件套（提示+分隔线+答案标题） |
| 第 4 步答案块没"经验法则"句 | 加上 |
| 第 5 步还在用小张/老李 | 切换到"你" |
| 类比中途换了 | 全文一个比喻，重写 |
| 第 4/5 步答案区没显式出现类比关键词（隐含/延伸不算） | 加 1 句把类比关键词写进答案 |
| 出图但没过 4 条触发门槛 | 删图，改用表格 |
| 文档里出现"自检通过"等元注释 | 全删 |
任一命中：停 → 修 → 重跑红旗。
详细原理（每个红旗为什么是错）见 references/self-checks.md。
□ 第 1 步：120-300 字
□ 第 2 步：400-700 字（建议 ≤ 600，决策步骤 ≤ 4 时不要逼近 700）
□ 第 3 步：300-600 字
□ 第 4 步：300-500 字
□ 第 5 步：300-500 字（建议 ≤ 450，给迁移题留余地）
□ 主体总量目标区间 **1500-2200**（硬上限 2600）。超过 2200 必须证明每节都已压缩过——否则找字数最大那节砍
□ 类比关键词在第 3/4/5 步答案区各**显式**出现 ≥1 次（隐含/延伸不算，必须 grep 得到）
□ Worked example 过 4 条筛选（典型/决策/可压缩/真实）
□ 不需要的附录完全没出现不通过 = 已修，不是只标记。修完重跑 Red Flags + 量化自检，全过才输出。
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.