v1.3.0 (2026年05月10日)

跟上游对齐 (v5.1.0)

• 同步上游 v5.1.0 的目录变更:上游主动删除了 commands/(3 个 deprecated stub)和 agents/code-reviewer.md(已上升进 requesting-code-review skill)。中文 fork 跟随删除以与上游意图对齐。详见上游 #1188 与 PR #1299。
• bin/superpowers-zh.js 移除安装时复制 agents/ 到 .claude/agents/ 的逻辑,保留 uninstall 时的清理逻辑(用于已装用户清理残留 code-reviewer.md,防止双 source of truth)。
• .github/workflows/ci.yml 删除 "Validate agents" 验证段(agents/ 已删,验证空目录无意义)。

补齐上游遗漏的根级文件

• CLAUDE.md —— 上游 contributor 指南(含 anti-slop-PR 规则)的中文翻译,末尾追加中文 fork 自己的 PR 流程说明。
• AGENTS.md —— 软链接 → CLAUDE.md(mode 120000,跟上游一致)。Codex CLI 等工具从 AGENTS.md 自动加载等同读取 CLAUDE.md。
  • Known limitation:npm pack 默认不跟随 symlink,因此 npm publish 出来的 tarball 不包含 AGENTS.md。这不影响实际使用:AGENTS.md 是 Codex CLI 在用户自己项目目录读的文件,不是从 superpowers-zh 安装包读的;通过 git clone 拿到仓库的贡献者会正确解析 symlink。
• RELEASE-NOTES.md —— 上游 release notes 原样保留(英文版,1180 行)。
• RELEASE-NOTES.zh.md —— 本文件,中文 fork 自身 release 记录。
• .codex-plugin/plugin.json —— Codex CLI plugin manifest(中文版本地化:name/description/displayName 改为中文版,URL 指向 jnMetaCode/superpowers-zh)。
• .version-bump.json —— 上游版本管理配置文件。
• scripts/bump-version.sh —— 上游版本同步脚本(含 --check 漂移检测、--audit 仓库审计)。中文版 npm version 钩子继续用 scripts/sync-plugin-version.js,bump-version.sh 作为补充工具引入。
• assets/app-icon.png + assets/superpowers-small.svg —— Codex marketplace 需要的图标资产。
• 4 个新增上游测试:tests/claude-code/test-requesting-code-review.sh、tests/claude-code/test-worktree-native-preference.sh、tests/opencode/test-bootstrap-caching.{mjs,sh}。

主动修复上游 v5.1.0 的疏忽

• .cursor-plugin/plugin.json 删除 dangling 的 "agents": "./agents/" 和 "commands": "./commands/" 两行。上游 v5.1.0 删了目录但忘了同步清理 manifest(git blame 显示这两行从 2026年02月13日 加入后从未更新)。中文 fork 主动修掉(向上游开 issue 是后续动作)。

修中文版自己的老漂移(PR #23)

• .claude-plugin/marketplace.json 的 plugins[0].version 卡在 1.1.8 的老漂移修复(追上其他 4 个 manifest,1.3.0 release 时统一升到 1.3.0)。原因是中文版简化版 sync-plugin-version.js 之前只 match 顶层 "version": 字段,跳过嵌套位置;导致 Claude Code marketplace 用户看到的 plugin 版本一直停在 1.1.8,跟 npm 包真实版本不同步。
• scripts/sync-plugin-version.js 增强为支持嵌套字段路径(plugins.0.version)。TARGETS 改为对象数组 { path, field },对齐上游 .version-bump.json 格式。仍使用 regex 替换而非 JSON re-stringify,保留原文件格式(缩进、行内/多行数组等不被破坏)。

不引入

• 上游 scripts/sync-to-codex-plugin.sh(推 OpenAI Codex marketplace 用,硬编码 prime-radiant-inc/openai-codex-plugins,中文版用不上)
• 配套测试 tests/codex-plugin-sync/test-sync-to-codex-plugin.sh

不动(中文版叠加层全部保留)

bin/ + npx 流程、docs/ 中文工具文档、4 个 chinese-* skill、mcp-builder、workflow-runner、README.md 主推 npx 路径、.codex/INSTALL.md、.opencode/INSTALL.md、.gemini/、scripts/sync-plugin-version.js —— 这些是符合"保持上游主流程不变 + 中文版叠加新增"原则的中文 fork 沉淀,全部保留。

修复 #17 报告的两个 bug,同时新增数据安全的卸载子命令。

升级

npx superpowers-zh@latest # 安装 / 升级
npx superpowers-zh@latest --uninstall # 卸载(含误装清理)

新增

• --uninstall 子命令 — 一条命令清理当前目录下的 superpowers-zh 安装:删除装过的 skill 目录、独立 bootstrap 文件(.trae/rules/superpowers-zh.md、.antigravity/rules.md),并清理追加到 CLAUDE.md / HERMES.md / GEMINI.md / CONVENTIONS.md 里的 superpowers-zh 段,保留用户原有内容。
• --force 参数 — 在用户主目录强制安装(默认拒绝)。
• 哨兵注释机制 — 安装时把 bootstrap 内容用 <!-- superpowers-zh:begin/end --> 包裹,卸载按哨兵精确切除,杜绝段尾误判导致的数据丢失。

修复

• 主目录污染(#17) — 之前在 ~ 直接跑 npx superpowers-zh 会把所有工具的 skills 和 bootstrap 文件写进用户主目录。v1.2.1 默认拒绝,提示加 --force 或 cd 到项目目录。
• 计数显示叠加(#17) — 多工具安装时显示 "Trae: 101 个 skills"(实际源只有 20 个),原因是 countDirs(dest) 把目标目录已有的子目录也算进去了。改为始终显示源数量。
• .DS_Store 散播 — copyDirSync 会把源里的 macOS 元数据复制到所有用户目录,现已跳过。
• 段尾识别不可靠的数据丢失风险 — v1.2.0(pre-release,未发布到 npm,仅 git tag)的 cleanBootstrapSection 在 superpowers 段后只有 ## 二级标题时会误删整个文件。v1.2.1 引入哨兵 + 保守 fallback:识别不可靠时跳过文件并打印警告。

内部改进

• scripts/sync-plugin-version.js + npm version 钩子:bump 后自动同步 .claude-plugin/plugin.json 和 .cursor-plugin/plugin.json 的 version 字段,从此不会再漏。
• 两个 plugin manifest 一次性从 1.1.8 修到 1.2.1。

兼容性

• 装过 v1.1.x 的用户跑 --uninstall 没问题,会用末尾固定句子做兜底识别。
• 只有遇到极端编辑场景(superpowers 段被人工搬到文件开头且后面只有 ## 二级标题)才会触发"跳过 + 警告",此时按提示手动编辑文件即可,不会丢数据。

文档

• README 加主目录警告 + 完整的「卸载 / 误装清理」小节
• docs/README.trae.md 加误装清理指引

已知后续工作

#19 tracking 上游 v5.0.6 / v5.1.0 的 skill 内容同步(brainstorming / writing-plans 移除 subagent review loop、worktree 重写、code-review 整合等),不影响 v1.2.1 的卸载和安装功能。