Kinema's Skill Making Pipeline

📋 Claude Code 技能开发标准规范

Claude Code 官方生态技能开发规范,定义标准化流程、版本管理与发布机制,适用于 KinemaClaw 平台开发者。

收藏
2.6k
安装
1k
版本
1.8.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

概述

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 等写入代码,需严格遵守禁止内容清单

Kinema's Skill Making Pipeline 内容

references文件夹
手动下载zip · 27.6 kB
clawhub-api-fallback.mdtext/markdown
请选择文件