| name | insight-public-post |
| version | 1.1 |
| description | 把知识库(D:\AIGC工作站\知识库)新沉淀的内核档改写成面向所有用户的「公开版」对外帖,B 站 AI 开发者小站首发:按 08_对外分发体例写成独立成篇的白话稿,归档、登记索引、提交推送,并交付可直接粘贴发帖的成稿;发布后回收作者终稿微调,保持库内版与线上版一致。当用户说「发小站 / 写公开版 / 同步对外帖 / 把这篇沉淀分发出去 / 写成帖子」,或一篇知识库复盘/insight 刚沉淀完成需要对外分发时触发——只要涉及「知识库内容 → 对外公开发布」就用本 skill,即使用户没提「小站」二字。 |
知识库 insight → 公开版对外帖(B 站 AI 开发者小站)
把一篇知识库内核档(含双链、面向自己的复盘)改写成任何陌生人都能冷读的公开帖。分发链路:内核档 → 公开版(本 skill 产出)→ 用户手动发 B 站小站 → 发布后回收终稿(本 skill 收尾)。发帖动作永远由用户手动完成,本 skill 交付到「可整篇粘贴的成稿」为止,并在发布后负责把作者的平台端微调回写库内。
第 0 步:定位内核档
- 默认取本次会话刚沉淀/刚讨论的那篇内核档;没有明确对象时问用户要路径。
- 内核档还没写时,先完成内核沉淀(进知识库对应栏目 + 索引/MOC 登记),再回来做公开版——顺序不能反,公开版的每个事实都要能溯源到内核档。
- 动笔前先读两份参照:
- 内核档全文(事实来源,公开版不得新增内核档里没有的事实);
- 黄金样例
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 步:归档、登记、推送
- 成稿写入
08_对外分发/;
- 在
08_对外分发索引.md 的「已分发清单」表格登记一行:| 文件名(B站AI开发者小站首发) | 对应内核文档路径 | 主题一句话 |——溯源关系写在索引里,正文保持零双链;
- 内核档文末加一行指向对外版(裸路径,不用双链,对外稿不进图谱);
- 按知识库 CLAUDE.md 惯例一并 commit 并 push(提交信息用「分发:…」或「对外分发:…」前缀),push 即触发官网同步;
- 回复用户:给出成稿文件链接,说明可整篇粘贴发小站,并提示已做的脱敏处理(如模型名已匿名,想点名可还原)。
第 3 步:发布后回收终稿(v1.1 新增)
作者几乎总会在小站编辑器里做最后微调(拆段调节奏、删分隔线、改个别措辞)。发布不是终点,库内版 = 线上版才是终点:
- 用户给出已发布的 opus 链接后,抓取线上正文(浏览器取页面文本即可);
- 与库内成稿逐段比对,把作者的微调回写到库内文件——注意线上抓取会丢失加粗/代码块等格式,只回写内容与分段差异,不动库内已有的 Markdown 格式;
- 可在索引该行补记发布链接;
- 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。