mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
按「我们只是翻译上游 + 增加更多工具支持」这个定位做逐层核查,结果发现
4 处偏离**不属于增量,而是缺失或漏同步**。核查方法与结论都记在下面。
## 核查方法
1. 文件级:上游 skills/ 与我们逐文件比对,分出「仅上游有」「仅我们有」
2. 内容级:14 个翻译 skill 各自比对标题数(排除代码围栏)、表格行数、列表项数
3. 逐个追查每处差异的来源:是声明过的 fork 增量,还是漏译/漏同步
## 修掉的 4 处
① antigravity-tools.md 上游有、我们没有
而 installer 里明明支持 Antigravity —— 该工具用户拿不到任何工具映射。
影响是实质的:Antigravity 没有 todo 工具(manage_task 管的是后台进程),
没这份映射,所有说「创建待办」的 skill 在它上面都会走偏。
已翻译补入,并在 using-superpowers 的平台适配清单里按上游同序列出。
② finishing-a-development-branch 漏同步 3 个 commit
C 块时我的 commit 清单不全,漏了 fbb6dba / bcfe798 / 9dff1a9。其中
9dff1a9 是**行为变更**:上游把菜单从 4 个选项减为 3 个,删掉了「丢弃这份
工作」这一项,丢弃改为只在人类伙伴明确提出时才走的独立小节;基础分支
判定也从盲跑 merge-base 改为「先确认,合并到错分支代价很高」。
我们的文件已把 D 块修复织进旧结构,故照上游当前状态整体重译 ——
上游 main 已含全部 4 个 commit,一次到位。已断言 D 块修复完整保留
(WORKTREE_PATH 仅在步骤 2 计算一次 + 那条显式警告)。
③ writing-plans 漏译整节
上游有 Task Right-Sizing 与 Bite-Sized Task Granularity 两节,我们只有后者。
缺的那节讲的是任务边界怎么划(能独立承载一轮测试循环、值得一个全新
审查者把关的最小单元),已补译为「任务粒度定界」。
④ writing-skills 三个问题
- 漏译 H2 整节 Match the Form to the Failure(让形式匹配失败类型)——
内容是「哪类基线失败该用哪种形式」,含禁令在塑形类问题上会反噬的实测结论
- 漏译 H3 Micro-Test Wording Before Full Scenarios(先做措辞微型测试)
- 编号缺陷:两个连续小节都编号为 4(应为 4、5)
- 节名仍是过时的「Claude 搜索优化(CSO)」,上游早已改名
Skill Discovery Optimization (SDO),正文两处引用一并同步
## 核查后的定位现状
纯增量部分(符合定位):
- 6 个 fork 专属 skill:chinese-* ×4 + mcp-builder + workflow-runner
- 3 个 fork 专属 references:copilot / hermes / qoder(我们支持的 harness,上游不支持或已删)
- using-superpowers 的「中国特色技能路由」一节
14 个翻译 skill 的标题数现在 13 个与上游精确一致,唯一例外是
using-superpowers(+1,即上面那节声明过的增量)。
## 仍存在、需维护者决定的一处(本提交未动)
executing-plans 有一个 fork 自加的「步骤 3:处理常见异常」(上游只有 3 步,
我们是 4 步),内容是测试失败三分诊断、依赖缺失、指令不清的处理;
另外 Remember 多一条「每个任务单独提交,commit message 引用任务编号」。
这两处是内容层面的自主增补,不在「翻译 + 工具支持」的定位之内。它们本身
有用,但会让每次上游改动该节都要人工调和。留给维护者判断是保留(并在
README 里声明)还是回归上游。
验证:audit.sh 152 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 0 fail