核心用法
marila-skill-publish 是一份面向 ClawHub 平台技能开发者的发布流程文档，系统梳理了从项目初始化到最终上架的完整工作流。核心操作围绕 clawhub CLI 工具展开，包括：技能目录初始化、必需文件创建（SKILL.md/package.json/README.md/CHANGELOG.md）、Git 仓库管理、版本号同步、GitHub Release 创建，以及最终的 clawhub publish 或 clawhub sync 发布指令。
文档特别强调五步发布顺序的严格性：版本号同步 → 更新 CHANGELOG → 推送代码并创建 GitHub Release → 发布到 ClawHub → 同步到 agent 工作空间。任何顺序错误都可能导致发布失败或版本不一致。
显著优点
1. 流程标准化：提供了可复现的发布清单，降低重复操作失误
2. 元数据规范详细：对 SKILL.md frontmatter 的 requires.env、requires.bins、primaryEnv 等字段有明确说明，帮助通过平台安全审核
3. 问题诊断全面：整理了 5 类常见错误（fetch failed、SKILL.md 缺失、超时、元数据不一致、登录失败）的症状、根因与解决方案
4. 安全实践完备：强调凭证管理、脚本审查、.gitignore 配置等安全要点
5. 版本管理清晰：遵循 semver 规范，配套 CHANGELOG 维护指南
潜在缺点与局限性
- 时效性依赖：ClawHub 平台若更新 CLI 或审核规则，文档可能滞后
- 场景覆盖有限：主要针对 Node.js 环境技能，对其他运行时（Python/Go 等）的适配说明不足
- 网络问题假设：部分解决方案（如
NODE_TLS_REJECT_UNAUTHORIZED=0）属于临时绕过，非根本修复 - 无自动化工具：流程仍为手动步骤，未提供 CI/CD 集成方案
适合人群
- ClawHub 平台的新技能开发者
- 需要规范化发布流程的小团队
- 遇到发布审核失败需排查元数据问题的开发者
常规风险
1. 凭证泄露风险：若未按文档建议将密钥存入环境变量或 mcporter config，可能误提交到 Git
2. 版本漂移风险：SKILL.md 与 package.json 版本号未同步会导致发布混乱
3. 审核拒绝风险：元数据声明与实际代码不符将触发 "metadata mismatch" 审核失败
4. 网络中间人风险：临时禁用 TLS 验证的方案可能暴露于劫持攻击