Files
superpowers-zh/skills/finishing-a-development-branch
AI不止语 3f6ffd5d4d fix(skills): 定位核查 —— 补回 4 处「不是增量」的对上游偏离
按「我们只是翻译上游 + 增加更多工具支持」这个定位做逐层核查,结果发现
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
2026-08-08 07:03:52 +08:00
..