核心用途
本规范是 KinemaClaw 生态的 skill 开发标准，为开发者提供从仓库创建、版本管理到多端发布的完整流水线定义。适用于 AI Agent 执行 skill 创建、迭代发版及环境配置场景。
显著优点
1. Git-First 强制约束：所有修改必须原子化提交，杜绝无版本管理的"黑箱"开发
2. 四地同步机制：projects 仓库、本地 skills、GitHub Release、ClawHub 四端版本强制对齐，避免版本漂移
3. ONBOARDING 强制嵌入：每个 skill 必须携带结构化引导文档，AI Agent 可按场景（首次使用/环境故障/版本升级）自动触发配置流程
4. 降级策略完备：ClawHub CLI 502 错误时提供 Node.js API Fallback，保障发布可靠性
5. 语义化版本严格：MAJOR/MINOR/PATCH 规则与 Git tag 强制绑定，changelog 必填
潜在局限
- 学习成本较高：新开发者需同时掌握 Git 工作流、ClawHub CLI、Node.js Fallback 三套机制
- 环境依赖固定：强制要求
~/.openclaw/workspace目录结构，非标准路径需手动适配 - 无图形化工具：全流程命令行操作，对不熟悉终端的用户不够友好
- API Token 管理风险：Fallback 脚本需读取本地配置文件，存在权限泄露隐患
适合人群
- KinemaClaw/ClawHub 生态的 skill 开发者
- 需要为 AI Agent 构建标准化工具的工程团队
- 熟悉 Git 工作流、追求版本可追溯的自动化工程师
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 版本不一致 | 四地同步遗漏导致 skill 行为差异 | 强制执行发版检查清单（7 项） |
| 配置泄露 | ONBOARDING 硬编码敏感信息 | 明确禁止密码/token 入档 |
| 发布失败 | ClawHub 服务异常 | 内置 Node.js Fallback 方案 |
| 环境漂移 | 本地 skills 未同步更新 | `clawhub update` 或手动 cp 同步 |
使用建议
首次使用务必按 ⚠️ 警告区块读取 ONBOARDING.md 完成环境配置；发版时严格遵循检查清单，优先使用 CLI 工具，502 错误再降级至 API Fallback。