skill存档

知识库 insight → 公开版对外帖（B 站 AI 开发者小站）

把一篇知识库内核档（含双链、面向自己的复盘）改写成任何陌生人都能冷读的公开帖。分发链路：内核档 → 公开版（本 skill 产出）→ 用户手动发 B 站小站 → 发布后回收终稿（本 skill 收尾）。发帖动作永远由用户手动完成，本 skill 交付到「可整篇粘贴的成稿」为止，并在发布后负责把作者的平台端微调回写库内。

第 0 步：定位内核档

• 默认取本次会话刚沉淀/刚讨论的那篇内核档；没有明确对象时问用户要路径。
• 内核档还没写时，先完成内核沉淀（进知识库对应栏目 + 索引/MOC 登记），再回来做公开版——顺序不能反，公开版的每个事实都要能溯源到内核档。
• 动笔前先读两份参照：
  1. 内核档全文（事实来源，公开版不得新增内核档里没有的事实）；
  2. 黄金样例 D:\AIGC工作站\知识库\08_对外分发\AI日报全绿却停更_云端定时任务连环翻车复盘_公开版.md（语气、结构、脱敏尺度的基准）；【踩坑记录】tag 类可另参照 08_对外分发/B站Toy发布后更新不动了_三环断裂排障复盘_公开版.md。

第 1 步：写公开版

体例硬规则（08_对外分发的既有规范）

• 独立成篇：正文零 [[双链]]、零库内引用、零「见另一篇」，陌生人冷读无障碍；
• 名词小抄：正文用到的、不懂就跟不上主线的术语，在首次出现附近集中白话解释。排版用加粗标题「名词小抄」+ 普通无序列表——禁止引用块内嵌列表（> - xxx），B 站小站等渲染器会把引用符和列表拆开显示（2026-07-12 实测翻车，v1.0 的「用引用块」规则由此废弃）；
• 全角标点 + 程序化校验：正文中文标点一律全角（，。：；（）“”），但不能靠手写保证——生成/手写混排必漏（实测一篇漏 47 处）。成稿后必须跑一遍程序化校验与转换：
  • 扫描目标：正文中残留的半角 , ; : ( ) ! ? 与成对英文引号；
  • 保护区：代码围栏（``` 块）与行内反引号片段整体跳过——这些是要被读者复制执行的内容（URL、配置、代码），必须保持半角原样；
  • 转换脚本里的全角字符用 Unicode 码点指定（0xFF0C ，/ 0xFF1A ：/ 0xFF1B ；/ 0xFF08 （ / 0xFF09 ）），不要写字面字符——生成端自身会半/全角混淆，码点才是确定的；
  • 转换后再扫一遍,直到 0 残留才交付。
• 段落宜短：移动端阅读密度高，一段一个意思；--- 水平分隔线在小站编辑器无渲染价值，不要用（作者终稿实测会删）；
• 文件命名：{口语化标题}_公开版.md，存入 D:\AIGC工作站\知识库\08_对外分发\。

语气（B 站人设：技术向 + 整活自黑）

• 短句，皮，不要官方腔：禁止「本文将介绍」「综上所述」这类开场收场；
• 叙事优先于说教：有事故就从事故现场讲起（“打开一看：绿的，全是绿的”），钩子放在方法论前面；
• 自黑是好素材：自己被自己写的代码骗了、白烧了 API 钱，这类桥段照实写，比装专家可信；
• 「可直接抄走」的资产是传播点：配置速抄代码块、排查口诀、结尾清单——读者为这个转发；
• 结尾给一段可以直接抄走的清单（心得/口诀/步骤），最后一句收个皮的。

内容改写要点

• 只做翻译不做创作：把内核档的事实翻译成白话，可以删细节、不可以编事实；内核档里标注「未验证/待观察」的结论，公开版同样要留诚实边界或干脆不写；
• 叙事数字零虚构：凡是描述「这次发生了什么」的数字（耗时、次数、金额、轮数）都必须能在内核档里指认出处——读者会把「排查了三小时」当真事传播，被扒就是公信力事故；没有出处就用定性表达（「折腾了半天」可以，「3 小时」不行）。建议句里的惯用语（「花一分钟自查」「十秒就能验」）不算叙事数字，可以用，但别密集堆。写完在交付说明里列出全部叙事数字及各自出处——用可验的清单，别写「未虚构任何数据」这类不可验的绝对声明；
• 名词小抄以「跟不上主线」为线：判断标准不是「所有术语都解释」，而是「读者不懂这个词就无法理解本文主线」——这类词必须解释（实测最容易漏的恰是 iframe、CI 这种「感觉大家都懂」的词），修饰性长尾术语（懒加载、节流之类顺带提到的）可以不解释。写完做一次回扫：把正文首现术语列成清单逐个判断该不该解释，凭印象扫会稳定漏词；
• 脱敏（发布前逐项过一遍）：
  • 匿名化供应商与账户：中转站/代理商写成「API 中转站」，模型名视内容敏感度决定是否点名（默认匿名成「贵的/便宜的」，用户可要求还原）；
  • 抹掉能定位到账户或机器的信息：本机路径、服务器 IP、仓库 secret 名、余额截图式精确数字（保留量级即可）；
  • 内核档里的真实标识符不得原样出现：仓库名/base 路径（如 /above-the-web）、域名、项目代号——发布前拿内核档里的专有字符串在成稿里搜一遍，命中的一律换成示例值（/my-site 这类）；判断标准是「读者拿这个串能不能搜到你」。例外：内容本身就是该项目的公开复盘、且作者已在帖中自认作品时，项目名与公开可见的平台 ID 可保留（如 Toy 复盘里的 toy_id——它本来就印在线上外壳页里）；
  • 可复用的数据点（成本对比、轮数、耗时）保留，这是帖子的传播点；
• 长度：1500-2500 字为宜，超了就砍过程细节、保住坑和结论。

第 2 步：归档、登记、推送

1. 成稿写入 08_对外分发/；
2. 在 08_对外分发索引.md 的「已分发清单」表格登记一行：| 文件名（B站AI开发者小站首发） | 对应内核文档路径 | 主题一句话 |——溯源关系写在索引里，正文保持零双链;
3. 内核档文末加一行指向对外版（裸路径，不用双链，对外稿不进图谱）；
4. 按知识库 CLAUDE.md 惯例一并 commit 并 push（提交信息用「分发:…」或「对外分发:…」前缀），push 即触发官网同步；
5. 回复用户：给出成稿文件链接，说明可整篇粘贴发小站，并提示已做的脱敏处理（如模型名已匿名，想点名可还原）。

第 3 步：发布后回收终稿（v1.1 新增）

作者几乎总会在小站编辑器里做最后微调（拆段调节奏、删分隔线、改个别措辞）。发布不是终点，库内版 = 线上版才是终点：

1. 用户给出已发布的 opus 链接后，抓取线上正文（浏览器取页面文本即可）；
2. 与库内成稿逐段比对，把作者的微调回写到库内文件——注意线上抓取会丢失加粗/代码块等格式，只回写内容与分段差异，不动库内已有的 Markdown 格式；
3. 可在索引该行补记发布链接；
4. commit（「修订:…同步线上终稿」前缀）并 push。

边界

• 不替用户登录/发帖，不操作浏览器发布（回收终稿时读已发布页面除外）；
• 内核档之外的事实缺口（比如用户想补的新数据）→ 问用户，不要脑补；
• 如果内容涉及公司（鲸海拾贝）内部信息，先提醒用户确认可公开再动笔。

版本记录

• v1.1（2026-07-12）：源自【踩坑记录】B站Toy复盘帖实战——① 名词小抄改「加粗标题+普通列表」，废弃引用块内嵌列表（渲染器拆开实测翻车）；② 全角标点从「体例要求」升级为「程序化校验流程」（保护代码区/码点替换/0 残留才交付）；③ 新增第 3 步「发布后回收终稿」；④ 脱敏规则补「公开复盘自认作品时项目名与公开平台 ID 可保留」例外；⑤ 补「段落宜短/不用 --- 分隔线」「可抄资产是传播点」。
• v1.0（2026-07-05）：skill-creator 2 轮评测封装（with/without 对照），确立三层闭环/脱敏三层/叙事数字零虚构。原文保留于 07_skill存档/insight-public-post_v1.0_SKILL.md。