核心用法
publisher 是 ClawdBot 生态系统的官方技能发布工具,专为解决技能开发者「文档难写、发布繁琐」的痛点而设计。只需在技能目录执行 skill-publisher 命令,即可自动完成:
1. 智能文案生成:基于 SKILL.md 内容,运用三种经过验证的文案公式(持续收益型、痛点消除型、自动化型)生成 3 条备选 one-liner 描述
2. README 自动生成:严格遵循 GitHub 文档最佳实践——问题/解决方案前置、倒金字塔结构、Emoji 标题、粗体关键结果、控制高亮比例低于 15%
3. 一键双平台发布:自动创建 GitHub 仓库、推送代码、同步至 ClawdHub 并自动检测版本号
显著优点
- 零配置上手:自动从 SKILL.md、VERSION 文件、scripts/ 目录提取所有必要信息
- 专业文案输出:内置三种经过验证的 one-liner 生成模式,显著提升技能的市场吸引力
- 标准化流程:强制统一的文档结构,降低用户认知成本,提高技能采用率
- 生态闭环:GitHub + ClawdHub 双平台同步,扩大技能曝光面
潜在局限
- 依赖外部工具链:必须预先安装
ghCLI、clawdhubCLI、jq和 git,任一缺失都会导致流程中断 - 模板化约束:README 结构相对固定,高度定制化需求的开发者可能需要手动调整
- 版本管理依赖:严格要求 VERSION 文件存在,对传统 git-tag 版本管理的项目不够友好
适合人群
- 频繁发布 ClawdBot 技能的开发者/维护者
- 追求文档专业性但缺乏写作时间的独立开发者
- 需要统一团队技能输出标准的技术团队
常规风险
- 权限风险:
gh repo create和clawdhub publish需要相应的平台认证权限,误操作可能导致公开非预期仓库 - 覆盖风险:自动生成 README.md 会覆盖同名文件,未提交的本地修改可能丢失
- 依赖过时:若上游模板
~/clawd/templates/README-template.md更新滞后,生成文档可能不符合最新平台规范