用途:sharing-skills 用于指导开发者将本地开发完成的 skill 贡献回上游仓库,核心流程为分支 → 编辑/创建 skill → 提交 → 推送 → 拉取请求(PR)。
何时分享:当 skill 具有广泛适用性、非特定项目、模式或技术对他人有价值、经过充分测试与文档化,并遵循 writing-skills 指南时适合分享。反之,项目或组织专用、实验性或不稳定、含敏感信息、过于细分的 skill 应保持个人使用。
前置条件:已安装并认证 gh CLI;工作目录为本地克隆 ~/.config/superpowers/skills/;skill 必须已按 writing-skills 的 TDD 流程测试。
主要流程:先切换 main 并同步(git checkout main、git pull upstream main、git push origin main),再创建分支(git checkout -b "add-${skill_name}-skill"),在 skills/ 目录创建或编辑 skill(路径形如 skills/category/skill-name/SKILL.md),然后提交、推送并用 gh pr create 向上游创建 PR。合并后需同步 main、删除特性分支。多个 skill 不应合并在同一个 PR,每个 skill 应独立分支与 PR。
限制与说明:资料仅给出流程与命令示例,未提供具体仓库地址、具体命名规范之外的约束、审核时限或权限细节;故障处理涵盖 gh 未安装、SSH 权限、skill 已存在及合并冲突等情形的处理方向。