course-factory/30-技能/_index.md

技能索引

技能是"方法"，不是"代码"。每个技能是一份可执行的作业指导书。 客观事实交给 90-工具/kb.py，语义判断交给技能。

管库（kb-*）

技能	何时用	核心产出
course-factory	任何与本库相关的操作，先过它	诊断 + 分流
kb-sync	有新增/变更/删除/移动	差异处理完毕
kb-ingest	单个文件怎么拆页、怎么命名	原子化页面
kb-query	查东西	带出处的答案
kb-lint	体检、修腐化	健康报告 + 修复
kb-index	索引不对、要合并/拆页	索引正确

做课（course-*）

技能	何时用	核心产出
course-outline	从零做一门课	需求确认 + 大纲 + 模块详案 + 缺口
course-slides	大纲要变课件	讲师版 PPT + 备注

调用关系

course-factory  ←  所有请求从这里进
    ├─ 要看库  → kb-query
    ├─ 要更新  → kb-sync ──(单个文件)──▶ kb-ingest
    ├─ 要维护  → kb-lint / kb-index
    └─ 要做课  → course-outline ──▶ course-slides

加一个新技能

1. 在 30-技能/ 下建目录 xxx/，写 SKILL.md（frontmatter 必须有 name 和 description，description 里带触发词）
2. 在 90-工具/register_skills.py 的 SKILLS 列表里加名字
3. 跑 python 90-工具/register_skills.py
4. 在 course-factory/SKILL.md 的分流表里加一行
5. 在上面的表格里加一行

判断一个技能该不该建：如果它做的事能用一段话讲清且不需要重复讲，就写进 course-factory 而不是建技能。技能是给"会反复执行、且有固定招式"的流程用的。