概述
Kinema's Skill Making Pipeline 是 KinemaClaw 生态系统的官方技能开发与发布规范,由 LeeShunEE 主导维护。该规范为 Claude Code 插件(skill)提供从创建、开发到发布的完整标准化流程,确保跨平台一致性和可维护性。
核心用法
规范定义了完整的开发工作流:
- Git First 原则:所有修改必须在 Git 仓库中管理
- 原子化提交:每次 commit 必须是独立的、有意义的变更
- 语义化版本:遵循 SemVer(MAJOR.MINOR.PATCH)
- 五地同步:发布后在 projects 仓库、ClawHub 缓存、GitHub Release、ClawHub、Claude Code Marketplace 同步版本
开发流程包含:创建仓库结构(必需 SKILL.md、references/ONBOARDING.md、.claude-plugin/plugin.json)→ 开发提交 → 打 Git tag → 创建 GitHub Release → 发布到 ClawHub → 更新 marketplace 索引(仅首发)。
显著优点
1. 标准化程度高:提供详细的目录结构、文件命名、版本号规则,降低协作成本
2. AI 友好设计:ONBOARDING.md 专为 AI Agent 设计,包含检测→安装→验证的 step-by-step 流程,支持降级策略和故障排查
3. 完整发布链路:从本地开发到 marketplace 分发的完整自动化路径,含 502 错误 fallback 机制
4. 安全合规:明确禁止个人敏感信息,强制私有仓库默认,缓存文件排除
潜在缺点与局限性
1. 生态绑定强:专为 KinemaClaw/ClawHub 设计,迁移到其他平台需大量调整
2. 复杂度较高:五地同步、临时文件夹发布模式等概念对新手有学习曲线
3. 工具链依赖:依赖 clawhub CLI、rsync、GitHub CLI 等工具,环境配置门槛不低
4. 版本同步脆弱:plugin.json 与 SKILL.md version 必须手动保持同步,易遗漏
适合人群
- KinemaClaw/Claude Code 生态的 skill 开发者
- 需要规范团队协作流程的技术负责人
- 希望将内部工具发布到 Claude Code Marketplace 的组织
常规风险
- 版本不一致风险:五地同步任一环节失败会导致用户获取版本混乱
- marketplace 索引遗漏:首发时若忘记更新 marketplace 索引,skill 无法被用户发现
- ClawHub 误判:.claude-plugin/ 目录会导致 ClawHub 将 skill 识别为 plugin,必须使用临时文件夹模式发布
- 隐私泄露:开发者可能误将个人网站、Token 等写入代码,需严格遵守禁止内容清单