ClawHub CLI 是官方命令行工具，用于搜索、安装、更新和发布智能体技能，支持语义化版本管理与批量同步。
说明：
## 核心用法
ClawHub CLI 是 ClawHub 生态的官方命令行管理工具，面向开发者与智能体运维人员。其核心功能覆盖技能的完整生命周期：
– **搜索发现**：`clawhub search ` 支持关键词模糊匹配，帮助用户在海量技能库中快速定位所需能力。
– **安装管理**：`clawhub install ` 支持指定版本（`–version `），并生成锁文件确保环境一致性。
– **状态查询**：`clawhub list` 查看已安装技能及其版本，便于审计与依赖追踪。
– **更新同步**：`clawhub update –all` 批量更新或针对单技能精准升级，支持语义化版本控制。
– **发布分发**：`clawhub publish` 将本地技能打包上传，`clawhub sync –all` 实现多技能批量同步，适合团队 CI/CD 流水线集成。
## 显著优点
1. **官方背书，生态完整**：作为 ClawHub 官方 CLI，与云端技能市场深度整合，确保技能来源可信、版本管理规范。
2. **跨平台兼容**：支持 Linux、macOS、Windows（Win32）三大操作系统，通过 npm 全局安装即可使用。
3. **语义化版本**：强制遵循 SemVer 规范（`–bump patch|minor|major`），降低依赖冲突风险。
4. **安全优先设计**：内置发布前检查清单（`PUBLISHING-CHECKLIST.md`），主动提醒排除 `.env`、凭证、私钥等敏感信息；支持 `–dry-run` 预演批量操作。
5. **丰富的本地参考文档**：提供命令速查、安全规范、故障排查、版本策略等结构化文档，降低学习成本。
## 潜在缺点与局限性
– **依赖 Node.js 生态**：需预装 npm/pnpm，对非 Node 环境用户存在额外依赖成本。
– **学习曲线**：涉及 slug 命名、标签策略、版本 bumps 等概念，新手需阅读参考文档才能避免常见错误。
– **CLI 版本差异**：部分命令参数（如 `install` 的目标路径）可能随版本变动，需依赖 `–help` 动态确认，缺乏绝对稳定性保证。
– **令牌管理**：API Token 需手动传递或登录缓存，多团队协作时需额外设计密钥轮转机制。
## 适合人群
– **智能体开发者**：构建并发布自定义技能至团队或公开市场。
– **DevOps/平台工程师**：在 CI/CD 中批量同步、版本化管理技能集。
– **技术型运维人员**：快速检索、安装、更新生产环境所需的 ClawHub 技能。
## 常规风险
– **凭证泄露风险**：发布前若未清理 `.env` 或硬编码密钥，可能导致敏感信息上传至公共仓库。
– **版本冲突**：强制更新（`–all`）可能引入破坏性变更，建议先在隔离环境验证。
– **权限管理**：共享登录态或长期 Token 可能扩大攻击面，建议定期轮换并配合最小权限原则。
– **网络依赖**：所有操作需连接 ClawHub 服务，离线环境无法使用。
