Skip to content

chore: 跟上游 v5.1.0 对齐 — 补缺失文件、清已废弃流程、修 cursor-plugin dangling - #22

Merged
jnMetaCode merged 1 commit into
mainfrom
chore/align-upstream-v5.1.0
May 10, 2026
Merged

chore: 跟上游 v5.1.0 对齐 — 补缺失文件、清已废弃流程、修 cursor-plugin dangling#22
jnMetaCode merged 1 commit into
mainfrom
chore/align-upstream-v5.1.0

Conversation

@jnMetaCode

Copy link
Copy Markdown
Owner

Summary

中文 fork 跟上游 obra/superpowers v5.1.0 系统对齐。原则是保持上游主流程不变,中文版只在上面叠加新增手动的

偏离上游清单(实地物理 clone 上游 verify 过)

上游有、我们漏了

  • CLAUDE.md(contributor 反 slop PR 指南,106 行)
  • AGENTS.md(symlink → CLAUDE.md,git mode 120000)
  • RELEASE-NOTES.md(1180 行 release log)
  • .codex-plugin/plugin.json(Codex CLI plugin manifest)
  • .version-bump.json(版本管理配置)
  • scripts/bump-version.sh(含 --check 漂移检测、--audit 仓库审计)
  • assets/app-icon.png + assets/superpowers-small.svg
  • 4 个 tests/*.sh|.mjs 测试文件

我们留着、上游主动删了

  • commands/ 3 个 deprecated stub(上游 PR #1188,commit message 写明 "Remove the deprecated legacy slash commands")
  • agents/code-reviewer.md(上游 PR #1299,"Lift superpowers:code-reviewer agent into the requesting-code-review skill")

上游自己有 dangling bug,我们顺手修

  • .cursor-plugin/plugin.json 仍引用 ./agents/./commands/ 但目录已删(git blame 显示这两行自 2026-02-13 起从未更新;上游 v5.1.0 删目录时漏改 manifest)

改动

补齐

  • CLAUDE.md(翻译 + 末尾追加中文 fork 备注,说明本规则适用于向 obra/superpowers 上游提 PR)
  • AGENTS.md(symlink,git mode 120000 跟上游字节级一致)
  • RELEASE-NOTES.md(上游原样英文,未翻译)
  • RELEASE-NOTES.zh.md新建,中文 fork 自身 release log)
  • .codex-plugin/plugin.json(Codex CLI manifest,本地化为中文版)
  • .version-bump.jsonscripts/bump-version.sh
  • assets/、4 个 tests/

清理

  • git rm -r commands/ + git rm -r agents/
  • bin/superpowers-zh.js 删 install 时复制 agents/ 的代码;保留 uninstall 时的清理逻辑(hardcoded LEGACY_AGENT_FILENAMES = ['code-reviewer.md']
  • .github/workflows/ci.yml 删 "Validate agents" 段
  • package.json files 字段移除 agents/ commands/

修上游疏忽

  • .cursor-plugin/plugin.json 删 dangling 的 "agents" "commands" 两行

配套

  • scripts/sync-plugin-version.js 扩到 .codex-plugin/plugin.json

不引入(用不上)

  • 上游 scripts/sync-to-codex-plugin.sh(硬编码 OpenAI marketplace fork)
  • 配套 tests/codex-plugin-sync/

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

bin/ + npx 流程、docs/、4 个 chinese-* skill、mcp-builderworkflow-runnerREADME.md 主推 npx、各 INSTALL.md、.gemini/scripts/sync-plugin-version.js

Known limitation

npm pack 默认不跟随 symlink,publish 出来的 tarball 不含 AGENTS.md不影响实际使用:AGENTS.md 是 Codex CLI 在用户自己项目目录读的文件,不是从 superpowers-zh 安装包读。已在 RELEASE-NOTES.zh.md 标注。

Test plan

  • node --check bin + scripts 语法 OK
  • 7 个 JSON 文件解析 OK
  • CI validate-skills 本地复跑:20 个 skills 全过
  • 4 个新测试文件语法 OK
  • npm pack --dry-run:90 文件 228KB,agents/commands 残留 0 条
  • ci.yml 是有效 YAML
  • sync-plugin-version.js 干跑 OK
  • CI 跑过
  • merge 后单独 release 1.3.0

后续动作(不卡本 PR)

向上游 obra/superpowers 开一条 issue,提醒 .cursor-plugin/plugin.json dangling 引用(已 search 过没人提过;blame 锁定到 commit 772ec9f)。

补齐上游漏的根级文件:CLAUDE.md(翻译 + 中文 fork 备注)、
AGENTS.md(symlink → CLAUDE.md,跟上游 mode 120000 一致)、
RELEASE-NOTES.md(上游英文原样 1180 行)、RELEASE-NOTES.zh.md
(新建中文 fork 自身 release log)、.codex-plugin/plugin.json
(中文化)、.version-bump.json、scripts/bump-version.sh、
assets/{app-icon.png,superpowers-small.svg}、4 个上游新增测试。

跟上游意图对齐,删上游已废弃流程:
- commands/ 全 3 个 deprecated stub(上游 #1188)
- agents/code-reviewer.md(已上升进 requesting-code-review skill,
  上游 PR #1299)
- bin/superpowers-zh.js 删 install agents 逻辑,保留 uninstall 用
  hardcoded LEGACY_AGENT_FILENAMES 列表清理已装用户残留
- .github/workflows/ci.yml 删 "Validate agents" 段
- package.json files 字段移除 agents/ commands/

主动修上游 v5.1.0 疏忽:
- .cursor-plugin/plugin.json 删 dangling 的 "agents": "./agents/"
  和 "commands": "./commands/"。上游删目录但忘同步 manifest
  (git blame 显示自 2026-02-13 起从未更新)。

配套:
- scripts/sync-plugin-version.js 扩到 .codex-plugin/plugin.json
- npm pack 校验 90 文件 228KB,agents/commands 残留 0 条

中文版"手动新增"叠加层全部保留:bin/ + npx 流程、docs/、
chinese-* skill、mcp-builder、workflow-runner、README 主推 npx、
各 INSTALL.md、.gemini/、sync-plugin-version.js。

详见 RELEASE-NOTES.zh.md v1.3.0 段。
@jnMetaCode
jnMetaCode merged commit a9e02b5 into main May 10, 2026
1 check passed
@jnMetaCode
jnMetaCode deleted the chore/align-upstream-v5.1.0 branch May 10, 2026 14:27
theSept added a commit to theSept/superpowers-zh that referenced this pull request May 10, 2026
chore: 跟上游 v5.1.0 对齐 (jnMetaCode#22)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant