自研系统变教学内容（Self-Built System to Teachable Content）
一句话：把你已跑通、但只有自己懂的东西，批量变成"能拿去教别人、能卖"的内容。 输入是你某个自研系统/工作流/本地工具，输出是两篇能发的文章（轻量篇+完整篇，形状刻意错开）+ 一份带实据的详解 + 自动存档。
普通做法：你搭了个牛逼系统，粉丝问"怎么弄的"，你凭记忆口述或现写两篇——结果数字瞎编、两篇长得一样、忘了存档、发平台搞错形态。这个 skill 把"这次怎么把系统写成文章的打法"固化成标准作业流程，每次一句话触发、质量一致。
适用场景
- 你搭了个自研工具/流水线/方法论（本地脚本、AI 工作流、笔记系统、运营 SOP……），只在自己脑子+聊天里，没沉淀成可教内容
- 想把它变成小报童/公众号/知识星球/课程素材，但直接写容易凭记忆编、两篇重样、数字虚高
- 你有一堆"只有自己懂"的资产，想批量"翻译"成内容进变现闭环
不适用 / 边界
- 不是"教人从零搭系统"的通用教程生成器（那是另一个范畴：本地工具搭建法，输入是空白环境）
- 输入必须是"已跑通"的东西——它包装你已有的系统，不替你写系统
- 不代发无 API 的平台（如小报童需手动贴）；有 API/CLI 的平台按你点名才发
- 它管"系统怎么变成内容"，不管"内容写得好不好"（那是通用写作规范的事）
首次配置（必做——去人设化）
把下面这些改成你自己的，否则存档/分发会落到示例值：
| 配置项 | 改成什么 |
|---|---|
NOTE_LIB_ID |
你存成品备份的笔记库（如得到大脑某库 topic_id） |
LIGHT_CHANNEL |
轻量篇发布渠道：小报童 / 公众号 / 其他（无 API 的你手动贴） |
HEAVY_CHANNEL |
完整篇发布渠道：知识星球 group_id + 形态规则（主题 topic 还是 公开笔记 note） |
RED_LINES |
你自己的内容红线（如：开头不写背景、结尾不引其他平台、同素材不重样） |
TOOL_SPECS |
若你的系统依赖特定本地工具（如本地语义检索引擎），把路径/模型做成可替换变量，别写死机器路径 |
> 不改也能跑通方法论，但分发会落到示例值。建议首次就填，后面每次触发自动用。
工作流（5 步 + 诚实计量）
① 实查（不凭记忆——这是内容不虚高的根）
- 读源码/配置：找到系统真实文件，读实际实现，不靠印象
- 跑真实命令：执行系统相关命令，抓取真实输出当证据（贴进详解）
- 对真实数字：用跑出来的数字，不写"覆盖92%"之类记忆值
- 自己纠错：发现错标（数量/覆盖率不符）当场纠正，并在详解里记一笔"纠错记录"
产出：带实据的「实现详解」草稿
② 写详解
- 机制分层讲清楚（如 引擎层/模型层/索引层/一次检索几步）
- 附真实命令 + 真实输出片段
- 附"诚实账"：覆盖率缺口、利用率低都明说
③ 拆两篇（形状错开，不重样）
- 轻量篇：为什么有用 + 入门三步，给读者马上能试（对应小报童/公众号）
- 完整篇：从零搭建 + 排错表 + 诚实账，给想照做的人完整 SOP（对应星球主题）
- 同素材不重样：两篇切入点/深度/结构刻意错开，符合内容红线
④ 分发（按配置）
- 存档：存进 NOTE_LIB_ID（没有就先建专库，见坑3）
- 发平台：轻量篇你手动贴；完整篇按你点名走 topic/note
- 红线：结尾不引直播间/不引别的平台/不代发无授权内容
⑤ 回流记录
- 把这次系统的真实落点（库ID/文章链接/topic_id）记一笔，下次取料能溯源
诚实计量红线（别删——这是内容不虚高的根）
- 数字必须来自实跑，不来自记忆：覆盖率/利用率/数量有缺口就明说，不写"全自动""全覆盖"
- 两篇必须形状不同：轻量篇 ≠ 完整篇的缩写，否则读者觉得重复、白看
- 第一人称只用于你亲身经历：他人系统/案例只能署名转述，拿不准不用"我"
- 分发合规：不引竞品平台、不代发无授权内容、形态（topic/note）按点名走
避坑清单（来自实战——必读）
> 维护原则：发现新坑立刻加，别憋到下次出问题。
- 坑1：CLI 是 bash 脚本，Python 子进程直调找不到命令 → 正文含反引号/双引号时，在 Bash 里用
$(cat 临时文件)把全文喂给--text，文本只在 cat 输出里、不触发 shell 二次解析；或先用 Python 把正文写临时文件再读 - 坑2：笔记 note/update 不能只改库 → 挪库得 save 新库 + delete 旧库，不能只传 topic_id（update 必带 title/content）
- 坑3：建专库接口 →
POST /resource/knowledge/create{name,description}建库，返回 topic_id；首次存档前先确认库存在 - 坑4：本地检索覆盖率会波动 → 索引被重扫后向量可能丢一大截，需跑 embed_loop 补满，不能写死某百分比当永久值
- 坑5：把"精选取料菜单"当"总量" → 统计卡片/笔记数时区分"精选子集"和"全量台账"，别误读数量（如 49 张精选 ≠ 387 张全量）
依赖
- 能读你系统的源码/配置/运行命令（本地文件系统或同步源）
- 至少 1 个笔记库（存档） + 至少 1 个发布渠道
- 可选：本地 CLI（如 zsxq-cli）用于自动发平台
最小可跑
只要你说得出"把 XX 写成教学内容"且 XX 是你已跑通的东西，①②③ 就能产出详解+两篇；④⑤ 在你填好首次配置后自动走。
反馈与共建
用着卡壳、有改进点子 → 反馈作者，跟进更新。
