Kinema's Skill Making Pipeline

核心定位

Kinema's Skill Making Pipeline 是 KinemaClaw 生态的官方开发规范，为 skill 创建、版本管理和发布提供标准化流程。适用于 Claude Code 插件开发者和 KinemaClaw 平台用户。

核心用法

首次配置：必须先读取 references/ONBOARDING.md 完成环境配置。

开发流程三步走：
1. 创建仓库：projects/<skill-name>/ 目录，包含 .claude-plugin/plugin.json、SKILL.md、references/ONBOARDING.md
2. 开发规范：遵循 Git First、Atomic Commits、语义化版本号（SemVer）
3. 发布流程：外置到 references/release-process.md，按 Step 1→9 顺序执行，包括 Git tag、GitHub Release、ClawHub 发布、版本校验

关键判断：发版前需判断是否为"全新 skill 首发"（需更新 marketplace 索引）还是"版本更新"（仅常规流程）。

显著优点

• 流程完备：从环境配置到五地同步（projects repo、ClawHub cache、GitHub Release、ClawHub、Claude Code Marketplace）全覆盖
• 版本管控严格：强制 SKILL.md、plugin.json、Git tag 三处版本一致，提供自动化校验脚本
• 安全设计：禁止包含个人敏感信息，区分缓存文件与源码（.claude-plugin/ 必须纳入 Git）
• 降级策略：Onboarding 文档要求每步骤提供多种安装方案，适配不同环境
• AI 友好：结构化文档（检测→安装→验证→故障排除）便于 Agent 自动执行

潜在缺点与局限性

• 学习成本：规范条目繁多，新手需完整阅读 ONBOARDING.md 才能开始
• 工具链依赖：强依赖 ClawHub CLI、Git、特定目录结构，迁移成本较高
• 版本同步负担：五地同步机制增加发布复杂度，任一环节失败需排查
• 平台锁定：主要为 KinemaClaw/Claude Code 生态设计，通用性有限

适合人群

• KinemaClaw/Claude Code 插件开发者
• 需要规范化管理 AI skill 版本的团队
• 追求 Git 原生工作流、语义化版本管理的开发者

常规风险

| 风险类型 | 说明 |

|---------|------|

| 版本不一致 | SKILL.md、plugin.json、Git tag 未同步导致发布失败 |

| 敏感信息泄露 | 误将 token/密码提交到 Git，违反 Prohibited Content 条款 |

| 缓存污染 | `.gitignore` 配置不当导致缓存文件入仓 |

| 发版失败 | ClawHub API 502 错误（备用方案见 `references/clawhub-api-fallback.md`） |

| 环境不可用 | 未执行 ONBOARDING 直接调用 skill 导致依赖缺失 |

核心用法

Kinema Skill Making Pipeline 是一套面向 Claude Code 生态的 Skill 开发规范文档，本身并非可执行工具，而是指导开发者如何正确创建、管理和发布 Skill 的完整标准。使用时需先阅读 references/ONBOARDING.md 完成环境配置，然后遵循文档中的目录结构、命名规范、版本管理规则进行 Skill 开发。核心流程包括：创建标准化目录结构 → 编写 SKILL.md 与 plugin.json → 遵循 Git First 原则进行原子提交 → 通过语义化版本管理 → 执行五步同步发布流程。

显著优点

1. 标准化程度高：定义了完整的 Skill 开发生命周期，从初始化到发布的每个环节都有明确规范，大幅降低协作成本。

2. 安全性设计完善：强制要求 Private 仓库、禁止敏感信息硬编码、明确缓存文件排除规则，从源头减少安全风险。

3. 版本管理严谨：采用 SemVer 规范，配套 version-check.sh 工具确保 SKILL.md、plugin.json、Git tag 三处版本号一致，避免发布事故。

4. Onboarding 机制成熟：每个 Skill 必须包含详细的安装配置指南，采用检测→安装→验证的降级策略设计，适配不同环境。

5. 生态兼容性强：支持向 ClawHub、Claude Code Marketplace 等多平台同步发布，提供完整的 marketplace 索引更新指引。

潜在缺点与局限性

1. 学习成本较高：规范文档超过 1500 行，包含大量必须遵守的规则和可选的推荐实践，新开发者需要一定时间适应。

2. 工具链依赖较重：需要 Git、GitHub CLI、ClawHub CLI 等多种工具协同，环境配置失败时排查链路较长。

3. 发布流程繁琐：五步同步机制虽然保障了版本一致性，但每次发布需要执行 9 个步骤，对于快速迭代的实验性 Skill 可能显得笨重。

4. 约束过于严格：如强制要求 Private 仓库、禁止原位发布等规则，可能与部分开发者的习惯或特定场景需求冲突。

5. 纯文档类 Skill：本身不提供自动化执行能力，开发者仍需手动完成大部分操作，Agent 只能按指导辅助执行。

适合的目标群体

• Claude Code Skill 开发者：需要向 KinemaClaw 或 Claude Code Marketplace 发布 Skill 的开发者
• 技术团队负责人：需要为团队制定 Skill 开发标准、规范交付流程的工程管理者
• 开源项目维护者：希望 Skill 项目具备良好可维护性、版本管理规范性的维护者
• AI Agent 工作流设计者：需要理解 Skill 开发最佳实践以设计更可靠 Agent 系统的架构师

常规使用风险

1. 环境配置风险：首次使用时若未完整执行 ONBOARDING.md 的步骤，可能导致后续发布失败或版本不一致。

2. 版本同步遗漏：五步同步机制中任一步骤失败或遗漏，可能导致 marketplace、缓存、GitHub Release 等版本信息不一致，造成用户获取错误版本。

3. 敏感信息泄露：虽然规范明确禁止，但开发者仍可能误将 token、密码等提交至仓库，需严格执行 .gitignore 规则和发布前审查。

4. 发布操作风险：clawhub publish 等操作涉及实际平台交互，错误参数可能导致意外覆盖或发布失败，建议先在测试环境验证。

5. 依赖工具故障：GitHub API 变更、ClawHub 服务异常（如文档提到的 502 错误）可能中断发布流程，需熟悉备用方案。