【免费下载链接】luban-skill
鲁班 | Luban — 把'能用的Skill'打磨成'能被装、能传播、能验证、能进化'的公共资产。Agent skill-polishing workshop: 验料·访行·过尺·慢刨·回炉
Luban（鲁班，luban-skill）是一个开源的Skill 打磨工坊，它把"能用的 Skill"打磨成"能被安装、能被传播、能被验证、能持续进化"的公共资产。这篇文章整理它沉淀的README 十条风格铁律与vhs 可复现 Showcase方法，帮你用 10 秒让第一次见到你 Skill 的陌生人想点击安装。
读完你可以带走三样东西：
- 一张可直接对照执行的README 十条风格铁律清单；
- 一套"录制脚本入库"的vhs 可复现 Showcase 做法；
- 一份发布前的出生证清单，避免先发版再回炉补课。
它是什么：Skill 打磨工坊 Luban
想象一下：你写了个 Skill，自己用着挺好。然后呢？
- 发到仓库，没人装——别人看不懂它是干嘛的；
- README 像工程说明书，没有第一屏钩子，没有能截图的产物；
- 你说"效果不错"，却拿不出一个能复现的证据。
鲁班的做法不是"帮我润色一下"，而是把它当作品收进工坊，走五个动作 🪚：
| 动作 | 干什么 | 一句狠话 |
|---|---|---|
| 验料 | 先挑战这个 Skill 的前提是否成立 | 朽木不可雕也，不值得就直说 |
| 访行 | 找同类 Skill，看清生态位 | 闭门造车出不了好工具 |
| 过尺 | 结构、实测、活体三把尺量分 | 绿色的 CI 会撒谎，要拉真实产物对账 |
| 慢刨 | 冻结基线，改动过验证门才保留 | 量不过就回刀，绝不为显得干了活而多刨 |
| 回炉 | 发布后留对标观察清单，从反馈进 | 交活不是终点 |
完整工作流见 skills/luban/SKILL.md，包括九个步骤、强制停手点和出师验收单。
首屏10秒：陌生人在哪里决定装不装
陌生人给你 10 秒：名字眼熟吗？一句话说清它替我省掉什么痛苦了吗？有能看的产物吗？
这 10 秒决定了 90% 的转化。十条铁律正是为这 10 秒而生的，下面逐条讲。
十条README风格铁律：第一屏对照清单
这十条从多个万星级 README 和自家实战中提炼，完整出处在 skills/luban/references/house-style.md。
| # | 铁律 | 一句话解释 |
|---|---|---|
| 1 | 钩子是一句引语，不是功能清单 | 标题下用一句"让人停下来的话"，讲它替用户省掉什么痛苦 |
| 2 | 首屏 10 秒讲清价值 | hero 区只放名字、引语、徽章、一行加粗价值陈述、锚点导航 |
| 3 | 人感开场 | 正文像跟朋友说话，用第二人称戳痛点，不用产品文档腔 |
| 4 | 产物前置 | GIF / 截图 / 真实输出放在安装命令之前——先让人想要，再告诉怎么装 |
| 5 | 一行安装，30秒上手 | 一条命令装完，"装完第一句话"直接给可复制的 prompt |
| 6 | 每个数字可点击查证 | 战绩、回放条数全挂链接；给不出链接的数字不写 |
| 7 | 模块化分节 | 每节只干一件事，锚点导航串起全文，读者跳着读不迷路 |
| 8 | 不写大词 | "支持一切""全自动"禁用；对比同行用表格、不攻击 |
| 9 | 零 API 底色 | 能零 Key 就零 Key；做不到就在显眼处写清成本 |
| 10 | 双语策略 | 中文为主，有外部受众时配英文版，首行互链 |
给新 Skill 开料时不用手写，直接跑脚手架自动生成出生即合规的骨架：
bash skills/luban/tools/scaffold-skill.sh <skill-name> "<一句话定位>"发布前还可以一键体检，把 README 结构缺项直接转成差距清单：
bash skills/luban/tools/check-skill-repo.sh <目标路径>vhs可复现Showcase：录制脚本入库
铁律第 4 条说"产物前置"，但只放 GIF 还不够——GIF 得能被任何人重新录出来。这就是鲁班工位纪律里的一条硬规矩："Showcase 必须可复现，demo 的录制脚本（如 vhs tape）、数据脚本与产物一起入库，任何人随时可重录。"（见 skills/luban/SKILL.md）
鲁班自己的仓库就是样板：
- assets/demo.gif —— 首屏展示的最终产物；
- assets/demo.tape —— vhs 录制脚本：分辨率、主题色、每一步打字与停顿都写死，是 GIF 的"配方"；
- assets/demo.sh —— 回放用的真实案例脚本，演示输出全部来自真实打磨回放，不是摆拍。
🎬 这个组合意味着：GIF 不是截屏 P 出来的"剧照"，而是一次可验证的真实运行。陌生人看完 30 秒演示，再翻到demo.tape发现每一步都能重放——信任感就是这么来的。
Showcase 的补充优先级（来自"亮活"步骤）：GIF 30 秒内展示从输入到结果 → 截图 → 真实运行产物 → 打磨前后对比 → 结果卡片。
出生证清单：发布前逐项打勾
十条铁律管"好看"，出生证清单管"齐全"。skills/luban/references/birth-checklist.md 列了新 Skill 仓库公开发布前必须带齐的件，缺一项不发布：
- ✅ frontmatter 齐全（做什么 / 何时触发 / 负触发）；
- ✅ README 按 house 模板：引语钩子、人感开场、产物前置、锚点导航；
- ✅ 一行安装实测可装，贴输出；
- ✅ demo GIF + 可复现录制脚本（vhs tape 入库）；
- ✅ 真实示例，每个数字挂链接；
- ✅ 安全边界节：不会做什么、何时停手问用户。
它的目标是：每个项目只打磨一遍——出生即合规，不要先发布再回炉补课。发布后 24 小时内还要用真实渲染检查 README，因为"本地预览会撒谎，徽章、视频、相对链接最容易翻车"。
实战战绩：数字全部可查证
铁律第 6 条"每个数字可点击查证"，在鲁班的第一单活里是这么执行的：把约 1k 星的 ai-news-radar 从 v0.6 打磨到 v0.7.0，一个对话内完成、4 个 PR 全部合并：
- 活体检查揪出 Actions 全绿之下静默停更 8 天的数据链路；
- 评分修复用83,725 条历史数据回放验证：清除327 条假 AI、零误伤；
- 精选区单一信源占比 15/20 → 4/20；首屏渲染 806 → 523 卡，页高 -30%；
- 验证手段沉淀为仓库工具，并立下"动评分必须附 ≥14 天回放"的项目规矩。
全程记录（含事故与教训）见 skills/luban/examples/ai-news-radar-case.md。
安装与验收：一句话把你的Skill送进工坊
安装只要一行：
npx skills add LearnPrompt/luban-skill -g或手动 clone（仓库是只读的，装到本地任意目录即可使用）：
git clone https://gitcode.com/gh_mirrors/lu/luban-skill装完对 Agent 说：
让鲁班看看我这个skill：[你的Skill目录 / 仓库链接 / SKILL.md内容]合格的表现是：它先输出验料挑战和带来源的同行对标，给三个打磨方向并停手等你选——在你选方向之前，它不会动你一行字。想验收是否装好，README 里给了一句标准测试语（见 README.md）。
小结：十条铁律 + 一个可复现的Showcase
| 问题 | 解法 | 在哪 |
|---|---|---|
| 首屏没人停 | 钩子引语 + 10 秒价值陈述 | 铁律 1、2 |
| 想要了但没信任 | 真实产物前置 + vhs 录制脚本入库 | 铁律 4 + 可复现 Showcase |
| 发布前心里没底 | 出生证清单逐项打勾 | birth-checklist.md |
学手艺，不偷皮 📏。把你的 Skill 拿到班门前，让祖师爷重新打磨一遍。
【免费下载链接】luban-skill
鲁班 | Luban — 把'能用的Skill'打磨成'能被装、能传播、能验证、能进化'的公共资产。Agent skill-polishing workshop: 验料·访行·过尺·慢刨·回炉
相关推荐
为什么你的Agent Skill发到GitHub没人装？鲁班luban-skill打磨工坊完全指南
为什么你的Agent Skill发到GitHub没人装？鲁班luban skill打磨工坊完全指南 Agent Skill 写得很顺手，发到 GitHub 却没
生产级 SKILL.md 的 7 条铁律：从 Cloudflare 文档 Linter 到 replica-skill 的共性
生产级 SKILL.md 的 7 条铁律：从 Cloudflare 文档 Linter 到 replica skill 的共性 2026 年初，一篇深度解析 C
生产级 SKILL.md 的 7 条铁律：从 Cloudflare 文档 Linter 到 replica-skill 的共性
生产级 SKILL.md 的 7 条铁律：从 Cloudflare 文档 Linter 到 replica skill 的共性 最近科技圈有个新词越来越火： S
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
