核心定位
Kinema's Skill Making Pipeline 是 KinemaClaw 生态的官方开发规范,为 skill 创作者提供从仓库创建到四地版本同步的完整工作流。该规范强调 Git First 原则,要求所有 skill 必须通过语义化版本(SemVer)管理,并在发布前完成 Git tag、GitHub Release、ClawHub 四地同步。
显著优点
1. 流程标准化:明确的目录结构(SKILL.md + ONBOARDING.md + scripts/ + references/)降低协作成本
2. 版本强一致:四地同步机制(projects 仓库、本地 skills、GitHub Release、ClawHub)避免版本漂移
3. AI 友好:ONBOARDING.md 专为 AI Agent 设计,含检测→安装→验证三步走结构,支持自动故障排查
4. 降级策略完备:每步提供 ≥2 种安装方案,适配不同环境;附带 ClawHub API Fallback 应对 CLI 故障
5. 安全红线清晰:明确禁止个人网站、密码、真实身份信息等敏感内容
潜在局限
- 学习曲线陡峭:需同时掌握 Git 工作流、语义化版本、ClawHub CLI 三套工具
- 环境依赖重:首次使用必须完成 ONBOARDING.md 全流程,否则命令可能不可用
- 四地同步人工介入:虽提供检查清单,但版本不一致仍需人工排查修复
- 发布流程冗长:从 commit 到 ClawHub 上线涉及 6+ 个手动步骤,缺乏一键自动化
- Node.js Fallback 门槛:API 备用方案要求用户具备 Node.js 和 FormData 知识
适合人群
| 用户类型 | 适用场景 |
|---------|---------|
| KinemaClaw Skill 开发者 | 必须遵循以发布到 ClawHub |
| 开源工具封装者 | 需将 CLI/脚本标准化为可分发 skill |
| 团队协作开发者 | 多人维护同一 skill 时需统一 Git 工作流 |
| CI/CD 集成者 | 需基于规范编写自动化发布流水线 |
常规风险
- 版本号不一致:未同步四地导致用户安装旧版本
- ONBOARDING 缺失:直接发布无配置引导的 skill,用户首次使用失败率高
- 敏感信息泄露:误将个人 token/域名写入 SKILL.md 触发审核失败
- 502 发布失败:ClawHub CLI 偶发故障,需切换 Node.js Fallback 方案
- Git 脏提交:未清空工作区直接打 tag,导致 tag 与预期代码不符