Skip to content

v1.3.0 — 跟上游 v5.1.0 对齐 + 修 marketplace.json drift

Latest
Latest

Choose a tag to compare

View all tags
@jnMetaCode jnMetaCode released this 10 May 14:57
· 12 commits to main since this release
v1.3.0
6c1fe58

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 沉淀，全部保留。

Assets 2
Loading