Publisher

核心用法

skill-publisher 是一款面向 Clawdbot 生态的自动化文档与发布工具。用户进入技能目录后执行单一命令，即可完成从 README 生成到双平台（GitHub + ClawdHub）发布的完整工作流。

典型操作流程：
1. 读取 SKILL.md 提取元数据（名称、描述、依赖）
2. 基于三种经过验证的文案模式（持续收益/痛点消除/自动化）生成 3 条 one-liner 选项
3. 用户选择或自定义后，生成符合 GitHub 文档最佳实践的 README：

4. 检测 VERSION 文件，自动创建/推送 GitHub 仓库，调用 clawdhub publish 完成上架

• 问题-方案倒置金字塔结构
• Emoji 标题增强可扫描性
• 加粗关键结果，高亮文本占比 <15%

显著优点

• 零配置：依赖文件（SKILL.md、VERSION、scripts/）自描述，无需额外配置
• 文案工程化：内置三种高转化率 one-liner 模板，解决"如何一句话讲清价值"的难题
• 双平台同步：GitHub 托管源码 + ClawdHub 分发，形成完整发布闭环
• 符合认知习惯：README 采用"结果优先"结构，降低潜在用户理解成本

潜在局限

• 强依赖外部 CLI：必须预装 gh（GitHub CLI）和 clawdhub，且需完成身份认证，新手配置门槛不低
• 模板刚性：README 结构相对固定，高度定制化需求可能受限
• bash/jq 依赖：Windows 环境或精简容器内可能需额外安装依赖
• 版本管理隐式：仅读取 VERSION 文件，不校验语义化版本规范，也不处理版本冲突

适合人群

• 频繁发布 Clawdbot 技能的开发者
• 希望提升技能曝光率但缺乏文案/文档经验的技术用户
• 追求"代码即文档"、减少重复工作的效率导向团队

常规风险

• 认证凭证泄露：gh 与 clawdhub 的 token 若存储在环境变量或脚本中，存在误提交风险
• 自动化副作用：一键创建公开仓库可能意外暴露敏感代码，建议先本地审核 README 预览
• 依赖失效：外部 CLI 升级可能导致 API 不兼容，需持续跟踪工具链版本
• 权限边界：gh repo create 默认行为受本地 git 配置影响，跨组织发布时可能出现权限错误

核心用法

publisher 是一款面向 Clawdbot 技能开发者的专业文档与发布工具。用户只需在项目目录执行 skill-publisher 命令，工具即可自动完成以下流程：

1. 智能解析 SKILL.md —— 提取技能名称、描述、依赖等元数据
2. 生成三种 One-Liner 选项 —— 基于 Continuous Benefit、Elimination、Automation 三种 proven 模式，产出高转化率的技能描述句
3. 自动生成 README.md —— 严格遵循 GitHub 文档最佳实践：倒金字塔结构、问题/解决方案前置、Emoji 标题增强可读性、加粗关键成果、控制高亮文本比例低于 15%
4. 一键双平台发布 —— 自动创建 GitHub 仓库、推送代码、并发布至 ClawdHub（版本号自动从 VERSION 文件读取）

显著优点

• 零配置自动化：完全依赖 SKILL.md 和 VERSION 文件自动检测，无需手动填写任何配置
• 高转化率文案：内置三种经过验证的 one-liner 公式，显著提升技能在 ClawdHub 的点击率和采用率
• 专业文档标准：README 结构符合 GitHub 官方文档最佳实践，提升开发者信任感
• 原子安全操作：文件更新采用临时文件 + mv 替换模式，避免数据丢失
• 依赖透明可控：所有外部调用（gh、git、jq、clawdhub）均提前检测并引导安装

潜在缺点与局限性

• 外部 CLI 强依赖：必须预装 gh、jq、clawdhub、git 四个命令行工具，任一缺失即阻断流程
• 交互式流程限制：大量依赖 read 获取用户确认，难以完全自动化集成到 CI/CD 流水线
• 模板固定性：README 结构基于单一模板，高度定制化需求需手动修改
• 无版本锁定机制：不检查外部 CLI 工具的版本兼容性，可能因 gh CLI 参数变更导致失败
• 社区维护级别：维护者为个人开发者（tunaissacoding），长期更新承诺不明确

适合人群

• Clawdbot 技能开发者：希望快速标准化技能文档并发布
• 开源项目维护者：需要遵循 GitHub 最佳实践生成专业 README
• 技术写作效率追求者：厌烦重复编写相似结构的文档
• CLI 工具爱好者：偏好命令行工作流，接受依赖管理责任

常规风险

• 供应链风险：依赖 gh CLI 和 clawdhub CLI 的安全性，若官方工具被篡改则存在连带风险
• 误操作风险：自动化创建 GitHub 仓库和推送操作可能在错误目录执行，建议始终先 review 生成的 README 预览
• 输入验证不足：自定义 one-liner 输入缺乏长度和特殊字符过滤，存在理论上低危注入风险（实际仅用于文档生成，不直接执行）
• 网络依赖：发布阶段必须连通 github.com 和 clawdhub.com，网络波动导致流程中断