核心用法
publisher 是一个面向 Clawdbot 技能开发者的专业文档与发布工具。只需在技能目录下运行 skill-publisher 命令,即可完整自动化以下流程:
1. 智能文档生成:读取 SKILL.md 内容,运用三种经验证的文案模式(持续收益/痛点消除/自动化)生成三选一的一句话描述
2. README 自动撰写:遵循 GitHub 官方文档最佳实践,采用问题-解决方案前置、倒金字塔结构、Emoji 标题等可读性优化策略
3. 双平台发布:自动创建 GitHub 仓库(如不存在)、推送代码,并同步发布到 ClawdHub 市场
显著优点
- 零配置:完全从现有文件(SKILL.md、VERSION、scripts/)自动提取信息,无需手动填写元数据
- 专业文案:内置三种经过验证的 One-Liner 公式(Keep/Without/Automatically 模式),显著提升技能的市场吸引力
- 一站式工作流:将原本分散的文档撰写、版本管理、双平台发布整合为单次交互
- 符合平台规范:README 结构严格遵循 GitHub 文档团队的最佳实践,包含问题陈述、解决方案、结果优先的特征描述
潜在局限
- 依赖栈较重:需要同时安装
jq、ghCLI、clawdhubCLI 和 git,对新手环境配置有一定门槛 - 模板固定:README 结构由
~/clawd/templates/README-template.md决定,高度定制化需求可能受限 - 无安全扫描:认证报告显示仅作占位用途,未执行实际安全审计,发布前需自行审查代码
适合人群
- 需要频繁发布/迭代技能的 Clawdbot 开发者
- 希望提升技能市场曝光率但缺乏专业文案经验的开发者
- 追求文档规范性和发布效率的小型团队
常规风险
- 凭证泄露风险:
ghCLI 和clawdhubCLI 需配置认证令牌,建议在隔离环境中运行 - 版本冲突:工具自动读取 VERSION 文件,多人协作时需确保版本号管理规范
- 平台依赖:ClawdHub 的可用性和 API 稳定性直接影响发布成功率