用途:为 superpower-writing 打一次带标签的公开 Release。流程为版本号提升、发布前门禁、提交、打标签、推送、创建 GitHub Release;门禁全绿才说明标签可安全发布。该技能与通用插件发布流程有两处差异:仓库中没有 release.sh,所有步骤需手动执行;本地分支是 master 但跟踪 origin/main,推送需用显式 refspec。
版本来源需三处一致(同一 X.Y.Z):.claude-plugin/plugin.json 的 version、.claude-plugin/marketplace.json 的 plugins[0].version、Git 标签 vX.Y.Z。marketplace.json 常滞后,需同时读取并一起修改。
发布前门禁(打标签前运行,须全部退出码为 0,首个非零即停止并修复): bash tests/smoke.sh 覆盖目录初始化、依赖与 Zotero 凭据提示、清单 JSON 有效性、各技能/命令/代理文件存在性及删除审计,并会调用后两项检查。 python3 scripts/lint_skills.py 对 skills//SKILL.md 及其旁 references/.md 做棘轮式检查(frontmatter 名称、描述词数与第三人称、破折号用法、正文长度、引用文件结构);既有违规记录在 scripts/lint_skills_baseline.txt 中,新违规即退出 1,应修文件而非改基线。如需为无法本轮合规的文件重生成基线,需先 git add skills/ 再运行 python3 scripts/lint_skills.py --update-baseline。 python3 tests/eval-harness/run.py --check-fixtures 检查场景与好坏夹具评级是否符合预期,不调用模型。
主要步骤:用 git log 查看上次标签以来的提交,按 semver 决定版本;按 Keep a Changelog 更新 CHANGELOG.md(带日期标题与 Added/Changed/Fixed 分组,条目写用户可见效果);同步提升两个清单并回读确认;把最终版本号与完整变更日志展示给用户,取得明确批准后发布(不可自主发布);随后 git add -A、git commit、git tag vX.Y.Z、git push origin master:main --tags、gh release create vX.Y.Z --title ... --notes ...,master:main 的 refspec 是必需的。不要在 ~/.claude/plugins/marketplaces/superpower-writing/ 的克隆中发布,该副本仅由插件加载器获取更新。
恢复处理:门禁失败先修复再重跑;无先前标签时 git describe 失败属首次发布,自选初始版本并从完整日志撰写日志;gh 未认证需让用户执行 gh auth login;推送报 refspec 错误改用 master:main;标签已推送但 release create 失败时不要重新打标签。常见错误包括漏改 marketplace.json、门禁未跑或未通过就打标签、用基线压制新 linter 错误、先打标签后推提交、变更日志漏提交、从 marketplace 克隆发布。上述检查具体覆盖范围与失败判定均以资料描述为准,其余细节暂未提供。