SuperAPI AI 工具集

publish-repo

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:把本仓库部署到 skills.sh 生态。该生态没有发布 API,部署等于「公开且可安装的仓库 + 一次首次安装以播种目录遥测」。此技能把这一流程变得有章可循。只能通过斜杠命令调用,因为它会切换仓库可见性,而该操作在社会意义上难以撤销(任何曾推送的内容都会公开)。

不适用场景:编写或修复技能应使用 add-skill;skills/ 下没有任何技能时应先构建,绝不发布空目录;向已公开仓库的日常推送用普通 git 即可。

工作流:

  1. 预检(硬性门槛,任一失败即停止):工作区必须干净且由所有者推送完成——此技能从不运行 git commit 或 git push;有未提交更改就停下并把清单交给所有者。检查命令:git status --porcelain(必须为空)、make check(必须以 0 error(s) 结束)、npx skills add . --list(skills/ 下每个技能都被发现)、gh skill publish --dry-run(规范校验,需 gh >= 2.90,公开预览)、python3 -c "import json; json.load(open('skills.sh.json'))"。逐一处理 gh skill 的每项警告:补上缺失的 license: MIT frontmatter;.claude/skills/ 警告在此处属预期(随附的第一方开发技能,有意提交,非第三方内容)。同时核实 README 目录、CHANGELOG 是否为最新;每个技能描述都应以收益为导向(它就是列表文案);最新提交的 CI 为绿色。
  2. 人工阻塞项——需用户明确确认,绝不自行假定:已做全历史密钥扫描(gitleaks/trufflehog);已完成个人/私密文件审查(所有曾提交内容都会公开)。若 $ARGUMENTS 中有 --dry-run,则在此停止并报告就绪状态。
  3. 分组:确保 skills.sh.json 把每个技能恰好列在一个分组中,每组一句有吸引力的描述(见 docs/deploying.md)。
  4. 切换可见性(切换前需立即与用户确认):gh repo edit <owner>/<repo> --visibility public --accept-visibility-change-consequences
  5. 保护措施(公开仓库后解锁):gh api repos/<owner>/<repo>/private-vulnerability-reporting --method PUT;添加默认分支规则集,单人维护者默认只阻止强制推送和删除(require-PR 规则会阻塞所有者的直接推送工作流),有外部贡献者后升级为 require-PR + code-owner 审查 + validate 检查;再为 v* 添加标签规则集(阻止更新与删除),使已发布版本不可变。
  6. 发布:切出与 .claude-plugin/plugin.json 匹配的版本化 GitHub release:gh skill publish --tag v<version>。它会重新校验、在缺失时添加 agent-skills 主题,并用自动生成的说明创建 release。同时添加 skills-sh 主题:gh repo edit <owner>/<repo> --add-topic skills-sh。
  7. 以消费者身份验证并播种目录(本地运行,不要在 CI 中运行——CI 中遥测被禁用,首次真实安装才会列出该仓库):npx skills add <owner>/<repo> --list;mkdir -p /tmp/skills-verify && cd /tmp/skills-verify;npx skills add <owner>/<repo> --skill '*' -a claude-code -y;npx skills list -a claude-code。
  8. 打磨:README 带上 skills.sh 徽章(默认已生成);设置 homepage(gh repo edit --homepage,例如 https://skills.sh/<owner>/<repo>);提醒社交预览图为手动 UI 步骤。
  9. 报告:仓库 URL、skills.sh 页面 URL、安装命令、release 标签、已应用的保护措施、被跳过的项(及解锁条件),并说明 skills.sh 页面在遥测处理播种安装后才会出现(页面有缓存)。

输出规范:公开仓库可通过 npx skills add <owner>/<repo> 安装(以真实安装验证),PVR 已启用,规则集生效,skills.sh.json 有效且每个技能已分组,播种安装已执行,并明确告知用户接下来会发生什么。

注意事项:可见性切换是历史的不可逆点,因此第 4 步要求明确确认,绝不自我认证。npx skills add . --list 报 "No skills found" 意味着 frontmatter 或目录结构有问题——依据 make check 输出修复,不要盲目重构。排行榜/仓库页面会滞后于播种安装,几分钟后仍未出现属正常,不是失败。不要在直接向 main 推送工作流的单人仓库上启用 require-PR 规则集,它会阻塞所有者;使用第 5 步的分阶段默认值。