出生即合规:鲁班Skill出生证12项清单 + scaffold一键开料,告别发布后回炉补课

原创2026-10-22 13:29:151,328 阅读

出生即合规:鲁班Skill出生证12项清单 + scaffold一键开料,告别发布后回炉补课

你写了一个 Skill,自己用着挺好,随手就发了出去——结果 README 没钩子、装不上一行、没有 demo、没有 LICENSE,被同行碾压,只好回头大改,这就是典型的"发布后回炉补课"。鲁班(luban-skill)是一套 Skill 打磨工坊,它的 出生证清单 把"新 Skill 仓库发布前必须带齐的件"拆成了 12 项硬指标,再配合 scaffold-skill.sh 一键开料脚本,让你新建的 Skill 仓库出生即合规——每个项目只打磨一遍,缺项在发布前就补齐。

鲁班Skill打磨工坊演示:验料·访行·过尺·慢刨·回炉,新仓库scaffold开料与出生证体检全流程回放

为什么"发布后再补课"最贵?

做过 Skill 发布的朋友大概率都踩过这几个坑:

  • 发到 GitHub 没人装——README 像工程说明书,没有第一屏钩子,没有能截图的产物;
  • 别人照着装,一行命令跑不通,直接关页;
  • 想补文档,发现要同时改 README、补徽章、录 demo GIF、补 LICENSE……越补越乱;
  • 更尴尬的是:本地预览一切正常,GitHub 真实渲染下徽章、GIF、相对链接集体翻车。

补课的代价不只是时间,而是信任——用户第一次装不上,就不会有第二次。

鲁班把发布就绪度做成了明文标准:SKILL.md 的"亮活"步骤要求每个新仓库先过 house-style.md 的 README 模板与十条风格铁律(钩子是引语不是功能清单、首屏 10 秒讲清价值、产物前置、一行安装、每个数字可点击查证……),最终对照出生证清单逐项打勾。

出生证 12 项清单:缺一项不发布

完整原文见 birth-checklist.md,必备件共 12 项:

# 必备件 一句话说明
1 SKILL.md frontmatter 齐全 name + 富 description:做什么 / 何时触发 / 触发词清单 / 负触发("不要用于…")
2 README 按 house 模板 引语钩子、人感开场、产物前置、锚点导航
3 一行安装实测可装 npx skills add owner/repo 真跑一遍,贴输出
4 装完第一句话 README 给出装完可直接复制的 prompt
5 demo GIF + 可复现录制脚本 vhs tape 与产物一起入库,真实运行回放、不是摆拍
6 .claude-plugin/marketplace.json plugin marketplace 双通道
7 skills.sh 徽章 skills.sh/b/owner/repo,安装计数自动累积
8 LICENSE 默认 MIT
9 真实示例 examples/ 放真实运行产物,每个数字挂链接
10 安全边界节 不会做什么、何时停手问用户
11 致谢节 方法论来源链接放 README,不进 SKILL.md 正文
12 零API底线 做不到零 Key,就在首屏写清成本与前置条件

⚠️ 清单还规定:4 个发布动作(建仓库、merge、打 tag 发版、注册表发布)每项都要用户祈使句授权——疑问句"都好了吧?"不构成授权。

这份清单的定位很明确:解决转化(来了的人装不装)。而半归档的自用工具不用照单全补,README 加一行维护状态声明即可——证件是给"要长大的孩子"办的。

scaffold 一键开料:新仓库出生即带齐占位

不想从零手搓 12 项?鲁班内置了开料脚本 scaffold-skill.sh,一条命令生成"出生即合规"的仓库骨架:

bash skills/luban/tools/scaffold-skill.sh <skill-name> "<一句话定位>" [target-dir]

它会一次性铺好:

  • skills/<skill-name>/SKILL.md:frontmatter 里预置 name、description 与触发词、负触发的 TODO 占位;
  • README.md:按 house 模板生成引语钩子、徽章(Agent Skills / skills.sh / License)、锚点导航、快速开始、安全边界等完整分节;
  • .claude-plugin/marketplace.json:双通道清单就位;
  • assets/demo.tape:vhs 录制脚本占位,保证 showcase 可复现;
  • LICENSE:默认 MIT。

脚本自带保护:目标目录已存在且非空时直接拒绝,不覆盖任何内容。生成后按提示 grep -rn 'TODO' 逐项补占位即可——你只负责内容,结构合规由骨架保证。

过尺一键体检:check-skill-repo.sh 把清单变成 PASS/WARN/FAIL

存量仓库怎么办?对照清单逐项打勾太慢。鲁班把结构尺固化成了体检脚本 check-skill-repo.sh,支持本地路径或仓库 URL:

bash skills/luban/tools/check-skill-repo.sh <目标路径或仓库地址>

它输出逐项的 PASS / WARN / FAIL 加一段"出生证(birth-checklist)"专检——LICENSE、marketplace.json、demo GIF 与录制脚本、一行安装、skills.sh 徽章是否齐全,最后汇总 PASS/WARN/FAIL 三个计数。FAIL/WARN 直接转成差距清单条目,缺什么一目了然,不用靠肉眼逐项数。SKILL.md 里对过尺的要求就是:先跑这个脚本,再谈九维评分。

发布后:24 小时与两周的两个复查点

出生证不是发布完就锁抽屉,清单还配了两段复查节奏:

📌 发布后 24 小时内

  • npx skills add 从公网再验一遍;
  • GitHub 真实渲染下看一遍 README(本地预览会撒谎,徽章/视频/相对链接最容易翻车);
  • 留一份回炉清单:对标观察点 + 下一轮入口。

📌 发布后两周:看流量再补刀

用仓库的 traffic/views 与 traffic/clones 真实数据按象限行动:

象限 判断 动作
有流量、证件缺 杠杆最大 先补一行安装 + 署名条,把过路流量变成转化
证件全、没流量 问题在发布动作不在产品 该发声导流,不该再打磨
双零 方向本身存疑 回验料,别恋战

这套"出生即合规 + 发布后看数据"的闭环,在鲁班的首个实战 ai-news-radar 案例 里完整走过一轮:活体检查揪出 CI 全绿之下静默停更 8 天的数据链路,评分修复用 83,725 条历史数据回放验证——而"可复现的 demo GIF + vhs tape 入库"正是出生证第 5 项的产物,如今 demo.gif 就躺在本仓库的 assets/ 里随代码一起可重录。

上手三步走

  1. 开料:scaffold-skill.sh 一条命令生成合规骨架(scaffold-skill.sh);
  2. 补内容:按 TODO 逐项填真实定位、真实示例、真实 demo 回放;
  3. 过尺发版:check-skill-repo.sh 全绿后,对照 birth-checklist.md 打勾,逐项授权发布。

学手艺,不偷皮——把 12 项出生证立在发布之前,你的 Skill 从第一天起就站在同行的起跑线上。

登录后查看全文
luban-skill