Agent Skills
返回列表
💻

技能审计与发布

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_7fbe8d41/skill-audit-publish。

技能介绍

要先解决什么问题

把 clawhub publish 当成一步上传,等于把本地目录原样暴露到公共 registry:README 里的姓名邮箱、测试用的 API key、写死的 Claude / GPT-4 专属引用、内网路径与工具配置,会一起公之于众。这类发布很难干净回滚——事后修正只能重发版,而且痕迹已经留下。另一个坑藏在 slug 里:CLI 从发布目录名推导 slug,而不是从 SKILL.md 的元数据读,目录名一改,报文就会落到错误的 slug 上。

工作方式:五阶段管线

  • Understand:先输出一段「这个技能做什么、给谁用」的摘要,由使用者确认保留什么、砍掉什么。
  • Transform:按 GEO 规则重写 description(首句说明是什么 + 给谁用、列出具体能力、引用用户原话触发短语、前置命名工具、加 When to use、结尾中文摘要),并展示 diff。
  • Sanitize:跑 sanitize.md 清单,逐项标记 PII / 凭证 / 模型专属引用 / 内部路径 / 危险模式是删除还是泛化,每个保留项都写清理由。
  • Verify:汇总 slug、name、version、描述与文件清单的清洗状态,等一句明确确认。
  • Publish + install-check:带 --slug 发布,再用临时目录把发布产物装回来核对,确认与本地一致。

需要留意的地方

  • 原始文件全程只读,改动只发生在独立的 publish-folder/,确认后才动 registry。
  • 审计不能跳过,边界项默认删或泛化。slug 在 ClawHub 上可改、旧 slug 保留 301 跳转,但定稿仍要在 verify 阶段完成。
  • 版本语义:1.0.0 首版、1.0.x 文案修订、1.x.0 新内容、2.0.0 大重构;每次发布——包括修个错字——都会生成审批提示。
  • 不适用:编辑技能内容、从 ClawHub 读取或列出已装技能,这些请交给对应工具。

使用场景

  • 准备公开发布本地 skill 前,想系统排查 PII、API key 与模型专属引用。
  • 改写 SKILL.md 的 description 和 frontmatter,让 ChatGPT / Claude 等模型更容易命中。
  • 想在执行 clawhub publish 前看到完整文件清单、slug、版本,并逐项确认。
  • 团队内部 skill 打算对外分享,又不想改动或破坏原始仓库文件。

适合人员

  • 编写并发布 OpenClaw skills 的开发者,需要本地技能在发布前完成安全审计。
  • 维护内部工具库的团队工程师,想在不影响源文件的情况下产出 publish-ready 版本。
  • 关注 PII 与凭证泄露风险的开源维护者,希望发布流程有明确的检查清单和确认环节。
  • 需要按 GEO 规则优化 SKILL.md 描述的作者,希望提升技能在生成式模型中的可见度。