把"能用的 Skill"打磨成"能被理解、能被安装、能被传播、能被验证、能持续进化"的公共资产——并走完出厂流程把它发布出去。
很多 Skill 自己能用,但别人看不懂、装不上、传播不开。这个 Skill 补的就是这段:从"能跑通"到"能被陌生人一分钟装上、三分钟跑出看得见的结果"。
克隆或复制到你的 agent 技能目录即可(无第三方依赖):
# Claude Code / 大多数 SKILL.md 兼容 runtime
git clone https://github.com/kool18/skill-productization.git ~/.claude/skills/skill-productization
# 或 WorkBuddy
git clone https://github.com/kool18/skill-productization.git /root/.codebuddy/skills/skill-productization装好后说「skill商品化」或「打磨我的 skill」即可触发。
| 动作 | 干什么 |
|---|---|
| 初审 | 先挑战这个 Skill 值不值得做,不成立就不做,直接给调整方向 |
| 调研 | 联网找同类,看清自己在生态里站什么位置(≥5 个候选,全部带 URL) |
| 评分 | 活体检查 + 九维 100 分制,静默失败比文档烂致命——绿色的 CI 会撒谎 |
| 改写 | 冻结原版做基线,改动过不了验证门就回退,不为凑分堆冗余 |
| 迭代 | 留对标观察清单与下一轮入口,发布不是终点 |
| 出厂 | 静态扫描过门禁 → 打包 → 认证降级推送 → 推送后逐文件比对 blob SHA |
- "skill商品化"
- "打磨我的 skill" / "升级我的 skill" / "优化这个 skill"
- "skill 体检" / "skill 评估" / "skill 审计"
- "这个 skill 怎么发布" / "打包 skill" / "发布 skill" / "上传 GitHub"
- "对标一下同类 skill" / "为什么我的 skill 没人装"
- "帮我看看怎么改"(丢来一个 Skill 目录或一段 SKILL.md 也算)
- 一份《Skill 商品化报告》(13 节,含评分证据与差距清单)
- 通过验证门的可直接替换改写片段
- 一张可截图传播的"合格证"结果卡
- 可直接推送的规范仓库与分发包
skill-productization/
├── SKILL.md # 技能本体:六动作 + 九维评分 + 出厂流程
├── README.md # 本文件
├── references/
│ ├── birth-checklist.md # 出生证清单(发布前必备件)
│ ├── house-style.md # README 模板与十条风格铁律
│ └── github-rest-publish.md # 受限网络下的 REST API 发布兜底
├── tools/
│ ├── vet_check.py # 出厂门禁(含三层降噪,见下)
│ ├── check-skill-repo.sh # 九维结构体检
│ └── scaffold-skill.sh # 生成出生即合规的仓库骨架
└── examples/
└── ai-news-radar-case.md # 完整实战案例(真实仓库、真实数字)
仓库根目录另有一份严格版 tools/vet_check.py(8 必填字段、红旗无降噪)。本 Skill 自带这份是降噪增强版,多做了三件事:
- Markdown 按 ``` 围栏区分「代码块内的可执行指令」与「散文里的文档性提及」
- 脚本先剥离注释与文档字符串——不执行的东西不算违规
- 红旗词落在引号内则降级——
re.compile(r"\bsudo\b")是检测规则,不是提权
原因很实在:本 Skill 第十步要教网络诊断,内容里必然出现 curl https://...、sudo、198.18.0.0/15 这类教学性提及。无降噪的扫描器会把这些判成违规——扫描器自己扫自己时产生了 6 个误报,加完三层降噪后归零。
用法:
python3 tools/vet_check.py <skill目录> [<skill目录2> ...] # 多目录时额外检查跨 Skill 触发词冲突退出码 0 = 通过,1 = 存在 FAIL。静态扫描管底线,九维评分管上限,两者配合用。
- 不擅自对外发布:发布去向、仓库命名、可见性必须用户确认
- 不覆盖远端-only 内容:推送前先
git fetch对账,无共同祖先时停下来逐项列出远端-only 文件交用户确认 - 强推一律带 lease:
--force-with-lease=<ref>:<expected-sha>,拿"失败"换"不误伤" - 凭据不落地:Token/密钥不落盘、不回显、不进 git config 与日志,用完即吊销
- 平台无关:产物不硬编码具体仓库名、账号、真实 IP,环境相关值一律占位
合并了两处实战沉淀,补上了原版最大的空白——发布动作本身:
- 新增「第十步:出厂——打包与发布」(门禁 → 打包 → 认证降级 → 推送后验证 → 强推 lease → 历史整合代价)
- 网络故障排除新增第 7 条 REST API 兜底:git 与 SSH 全不可达时的最后一条路(实测靠它在 git 主机被完全拦截的环境里发布了 10 个文件 + 157KB 二进制 + tag)
- 出厂门禁工具落地,并加三层降噪