chore: 同步上游 v6.1.0/v6.1.1 bootstrap 精简 + Codex 插件清单修复#94
Open
jnMetaCode wants to merge 1 commit into
Open
Conversation
对齐上游中与我们架构相关的部分:
- using-superpowers/SKILL.md:翻译合并上游更精简的每会话 bootstrap
重写(去掉 dot 流程图与重复章节),保留我们 fork 特有的中国特色
技能路由和已删档上游文档的平台适配指引(Copilot/Hermes/Qoder 等)
- .codex-plugin/plugin.json:补 "hooks": {} 阻止 Codex 在清单缺少
hooks 字段时 fallback 扫描到我们仓库里 Claude 专用的
hooks/hooks.json,误给 Codex 用户弹注册信任提示;category 改为
上游修正后的 "Developer Tools"
- references/codex-tools.md:修正过期工具名 wait -> wait_agent,
补充子 agent 用完应 close_agent 的提示
- 版本 1.6.0 -> 1.6.1
Gemini CLI 移除(上游这两版改动面最大的一项)评估后判定为独立决策,
牵涉我们自己的"18 款工具"宣传口径和安装器逻辑,本次不包含。
pi-tools.md 的裁剪经测试验证会复现上游自己的一个测试回归(其
tests/pi/test-pi-extension.mjs 断言的字符串被裁掉),本次不跟进。
详见 RELEASE-NOTES.zh.md v1.6.1 条目。
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.
你要解决什么问题?
上游
obra/superpowers自我们上次同步的 v6.0.3 之后又发了 v6.1.0 和 v6.1.1,需要评估是否跟进、跟进哪些部分。逐项 diff(git diff v6.0.3 v6.1.1)后确认这两版包含:bootstrap 精简、Gemini CLI 移除、Codex hooks 重做+官方 marketplace 打包基础设施、若干工具映射文档裁剪。这个 PR 做了什么改变?
只同步与我们 fork 架构相关、且经测试验证不会引入回归的部分:
using-superpowers/SKILL.md翻译合并上游更精简的 bootstrap 重写,同时保留我们 fork 独有的中国特色技能路由和上游已删档但我们仍维护的平台适配文档指引(Copilot/Hermes/Qoder).codex-plugin/plugin.json补"hooks": {}—— 修复一个真实 bug:Codex 在清单缺hooks字段时会 fallback 扫描到我们仓库里 Claude Code 专用的hooks/hooks.json,导致 Codex 用户安装时被错误注册一个不属于它的 SessionStart hook 并弹出信任提示;category同步上游修正为"Developer Tools"references/codex-tools.md修正一处过期工具名wait→wait_agent,补充close_agent使用提示RELEASE-NOTES.zh.md补条目这个改变适合放在核心库中吗?
是。这是维护我们已有的多工具 skill 翻译内容与上游对齐、并修复一个真实的 Codex 安装体验 bug,不是新领域/新工具的功能扩展。
你考虑了哪些替代方案?
scripts/package-codex-plugin.sh、.agents/plugins/marketplace.json、tests/codex/):我们的分发方式是npx superpowers-zh,不走这条上游官方安装通道,跟进这部分没有实际收益,故跳过。references/pi-tools.md的精简:最初打算跟进(删掉与 Pi 原生工具同名的自证性映射行),但实测发现上游自己这版裁剪后的文件会让他们自己的tests/pi/test-pi-extension.mjs(断言文件含 write/edit/bash 字样)测试失败——这是上游未捕获的回归。为避免把这个 bug 一起带进来,本 PR 保留了原有更完整的 pi-tools.md,未做改动。这个 PR 是否包含多个不相关的改变?
否,全部改动都围绕"同步上游 v6.1 中适用于我们架构的部分"这一个主题,互相之间是同一批次评估产出。
已有的 PR
测试环境
评估
这不是新 skill 内容的原创性行为塑造改动,而是把上游已经发布(即已经过上游自己验证)的 bootstrap 重写翻译港进来,因此没有走
superpowers:writing-skills的对抗性压力测试全流程。实际做的验证:bash scripts/audit.sh(完整版,含 18 款工具装/卸载/幂等回归):120 PASS / 0 FAIL.github/workflows/audit.yml和ci.yml里的每一步检查tests/pi/run-tests.sh、tests/kimi/run-tests.sh全绿references/*.md路径是否真实存在(过程中确实抓到一处我自己引入的坏引用——错误保留了 Antigravity 的指引但我们没有antigravity-tools.md,已修正)git stash对照确认了几个跑不过的测试(opencode/claude-code 相关)是本机环境预置问题,与本次改动无关严格性
superpowers:writing-skills并完成了对抗性压力测试(在下方粘贴结果)—— 未执行,理由见上方"评估"部分:这是翻译港进上游已发布内容,不是原创行为塑造改动人工审核