SuperAPI AI 工具集

sharing-skills

智能体与模型

查看项目

更新于 10-16 03:47

技能介绍

用途:将本地分支中的 skills 贡献回上游仓库,标准流程为“分支 → 编辑或创建 skill → 提交 → 推送 → PR”。

主要能力:判断何时应分享(技能具有通用性、他人可受益、已测试并有文档、遵循 writing-skills 规范)与何时应保留为个人使用(项目或组织专用、实验性或不稳定、含敏感信息、过于小众)。给出同步、建分支、提交、推送和用 gh CLI 创建 PR 的具体命令。

使用方式:前置条件为已安装并认证 gh CLI、工作目录为 ~/.config/superpowers/skills/,且技能已测试。先 git checkout main、git pull upstream main、git push origin main;再用 git checkout -b "add-${skill_name}-skill" 建分支;在 skills/category/skill-name/SKILL.md 编辑;git add 与 git commit 后 git push -u origin 分支;最后用 gh pr create --repo upstream-org/upstream-repo 创建 PR。PR 合并后同步 main 并删除分支。

限制:多个技能不要放在同一个 PR,每个技能应有独立分支与 PR。跨客户端适用于 GitHub Copilot、Claude Code、Codex,Codex 可安装到 $CODEX_HOME/skills/sharing-skills 并在大改后重启。无需 MCP;不应声称使用了当前宿主未暴露的 MCP,应以本地文件、测试、日志或截图作为证据。常见问题包括 gh 未安装、SSH 权限、技能重名和合并冲突,可用 git fetch upstream && git rebase upstream/main、git push -f 处理。