准备并发布本地技能到 ClawHub 与 GitHub，使用保持本地发布目录整洁的工作流。当用户想要...
发布到 ClawHub
功能概述
发布到 ClawHub是一项面向实际任务的技能，主要用于当本地技能应该更新、发布并备份到一个干净的可重复的工作流程时使用此技能；类型请求 : 1；
核心要点
- “ 将此技能写入 ClawHub ”；
- 帮助我将此项技能放入。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用与执行
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
结果检查与注意事项
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
发布到 ClawHub
当需要更新、发布并备份本地技能（skill）时，请使用此技能，以确保整个流程清晰、可重复且可维护。
典型请求示例：
- “将此技能发布到 ClawHub。”
- “帮我把这项技能同步到 GitHub 和 ClawHub。”
- “优化这项技能，发布后同步至 GitHub。”
- “保持本地技能文件夹干净，但仍在 GitHub 上展示 README。”
安全第一
该工作流可能涉及以下操作：
- 对技能本身进行结构性修改
- GitHub 身份认证
- 向公开远程仓库执行
git push - 使用 ClawHub CLI 进行发布
安全规则：
- 除非别无更安全的选择，否则绝不要要求用户在聊天中粘贴长期有效的令牌（token）
- 优先使用浏览器登录、凭据管理器或 SSH 认证方式
- 绝不在任何文件中存储凭据
- 未经用户明确确认，绝不执行强制推送（
git push --force） - 若用户希望本地发布目录保持精简，应优先生成临时 GitHub README，而非在本地发布目录中保留
README.md
前置条件
发布前请确认以下事项均已满足：
- 技能已存在于本地
SKILL.md文件存在- 如需备份或展示用途的 GitHub 仓库同步，则目标仓库地址已知
- 如需发布至 ClawHub，则 ClawHub CLI 已安装且已成功登录
详细检查项参见 references/publish-checklist.md。
工作流
1. 首先检查并优化技能
检查技能文件夹内容，重点关注：
- 应国际化（i18n）的非英文内容
- 私有或专有名称/引用
- 与用户个人环境强绑定的文件路径
- 不应发布的密钥、邮箱或占位符
- 结构不清晰或说明已过时的技能文档
检查 SKILL.md、脚本、参考资料、Notebook 及可选元数据。
若技能本身需清理，请先完成优化再发布。对于重大修订，建议先验证技能结构合理性，再发布修订后的版本，而非直接发布已知尚不完善的初稿。
2. 标准化可发布的技能内容
发布前需完成以下标准化操作：
- 若面向更广泛受众发布，将技能描述与使用说明统一转换为清晰、规范的英文
- 必要时，将专有名称替换为通用占位符
- 移除所有密钥、个人联系方式及私有标识信息
- 确保示例对第三方用户具备可理解性
- 保持本地发布目录最小化，仅包含核心技能相关文件
SKILL.md 应聚焦于 AI 如何使用该技能，而非记录项目历史。
3. 优先发布至 ClawHub
当用户核心诉求是更新技能本身时，应在创建或恢复 GitHub README 前，先将本地技能发布至 ClawHub。
发布前请执行：
- 运行
clawhub whoami验证登录状态 - 确定下一个语义化版本号（Semantic Version）
- 撰写简明变更日志（changelog），真实反映本次技能更新内容
- 从本地技能根目录执行发布命令
发布完成后请确认：
- 返回的版本号或包标识符是否正确
- 如有需要，验证 ClawHub 上技能列表是否已更新
4. 添加临时 GitHub README
若需 GitHub 备份或公开展示，请执行：
- 创建一份简洁的
README.md，面向人类读者说明该技能的功能与用途 - 保持
SKILL.md作为 AI 使用的主文档，README.md作为 GitHub 展示专用文档 - 若用户倾向“纯本地技能目录”模式，则将本地发布目录中的
README.md视为临时文件
5. 同步至 GitHub
尽可能使用 SSH 或本地凭据助手（credential helper）进行认证。
推荐同步流程：
- 克隆或更新一个干净的 GitHub 工作副本
- 将最新技能文件及临时 README 复制进去
- 预览即将提交的变更内容
- 使用含义清晰的提交信息执行
git commit - 推送到目标仓库
此方式可使本地发布目录与 GitHub 同步目录各司其职、互不干扰。
6. 若用户倾向“纯技能文件夹”，则删除本地 README
待 GitHub 推送成功后：
- 若用户偏好“本地精简、GitHub 丰富”的工作流，则从本地发布目录中删除
README.md - 确保 GitHub 仓库中的 README 保持完整可用
7. 汇报执行结果
清晰总结以下内容：
- 哪些文件被清理或修改
- ClawHub 发布是否成功
- GitHub 推送是否成功
- 本地 README 是否按需被移除
- 用户还需完成哪些后续操作
决策规则
- 若技能仍处于私有状态，或含有敏感信息，应立即中止发布流程。
- 若用户仅需 GitHub 备份，则跳过 ClawHub 发布步骤。
- 若用户采用“本地目录精简”工作流，则必须先完成 ClawHub 发布，再添加 README。
- 若未安装 ClawHub CLI，需明确告知阻塞原因；仅在仍有帮助的前提下，继续执行 GitHub 准备步骤。
- 若远程仓库中已存在冲突的初始文件（starter files），应谨慎处理，避免盲目覆盖。
- 若重命名仓库、slug 或已发布技能可能导致现有链接失效，须暂停操作并获得用户确认后再执行改名。
常见失败场景
详见 references/publish-checklist.md，其中涵盖：
- 发布前检查清单
- 常见错误类型
- 安全凭据使用指南
- 推荐命令列表
- “本地精简 / GitHub 展示”工作流详解
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
2026.10.28
0
16
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
2026.10.28
0
15
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
2026.10.28
0
10
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.5万人学习
最新文章