chore: 跟上游 v5.1.0 对齐 — 补缺失文件、清已废弃流程、修 cursor-plugin dangling - #22
Merged
Conversation
补齐上游漏的根级文件: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 段。
7 tasks
theSept
added a commit
to theSept/superpowers-zh
that referenced
this pull request
May 10, 2026
chore: 跟上游 v5.1.0 对齐 (jnMetaCode#22)
7 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
中文 fork 跟上游
obra/superpowersv5.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.svgtests/*.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.json、scripts/bump-version.shassets/、4 个 tests/清理
git rm -r commands/+git rm -r agents/bin/superpowers-zh.js删 install 时复制 agents/ 的代码;保留 uninstall 时的清理逻辑(hardcodedLEGACY_AGENT_FILENAMES = ['code-reviewer.md']).github/workflows/ci.yml删 "Validate agents" 段package.jsonfiles 字段移除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-builder、workflow-runner、README.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 --checkbin + scripts 语法 OKnpm pack --dry-run:90 文件 228KB,agents/commands 残留 0 条sync-plugin-version.js干跑 OK后续动作(不卡本 PR)
向上游 obra/superpowers 开一条 issue,提醒
.cursor-plugin/plugin.jsondangling 引用(已 search 过没人提过;blame 锁定到 commit 772ec9f)。