mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
3f6ffd5d4d
按「我们只是翻译上游 + 增加更多工具支持」这个定位做逐层核查，结果发现
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
4.2 KiB
4.2 KiB
name, description, version, license, metadata
| name | description | version | license | metadata | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| using-superpowers | 在开始任何对话时使用——确立如何查找和使用技能，要求在任何响应（包括澄清性问题）之前调用 Skill 工具 | 1.0.0 | MIT |
|
如果一个技能适用于你的任务，你没有选择。你必须使用它。
这不可协商。你不能通过合理化来逃避。
规则
在任何响应或操作之前调用相关或被请求的技能——包括澄清性问题、探索代码库、或查看文件之前。如果调用后发现技能不适合当前情况，你不需要使用它。
在进入 EnterPlanMode 之前： 如果你还没有头脑风暴过，先调用头脑风暴技能。
然后宣布"使用 [技能] 来 [目的]"，并严格遵循该技能。如果它有检查清单，为每个条目创建一个待办。
技能优先级
当多个技能都适用时，流程技能优先——它们决定处理方式，然后由实现技能（前端设计等）负责执行。头脑风暴和系统化调试是 Superpowers 中最常见的流程技能，但这条规则适用于任何流程技能。
- "让我们构建 X" → 先用 superpowers:brainstorming，再用实现技能。
- "修复这个 bug" → 先用 superpowers:systematic-debugging，再用领域技能。
红线
这些想法意味着停下——你在合理化：
| 想法 | 现实 |
|---|---|
| "这只是一个简单的问题" | 问题就是任务。检查技能。 |
| "我需要先了解更多上下文" | 技能检查在澄清性问题之前。 |
| "让我先探索一下代码库" | 技能告诉你如何探索。先检查。 |
| "我可以快速查一下 git/文件" | 文件缺少对话上下文。检查技能。 |
| "让我先收集信息" | 技能告诉你如何收集信息。 |
| "这不需要正式的技能" | 如果技能存在，就使用它。 |
| "我记得这个技能" | 技能会迭代更新。阅读当前版本。 |
| "这不算一个任务" | 行动 = 任务。检查技能。 |
| "技能太小题大做了" | 简单的事会变复杂。使用它。 |
| "让我先做这一件事" | 在做任何事之前先检查。 |
| "这样做感觉很高效" | 无纪律的行动浪费时间。技能防止这一点。 |
| "我知道那是什么意思" | 知道概念 ≠ 使用技能。调用它。 |
平台适配
如果你的运行环境在下面列出，请阅读对应的参考文件获取特殊说明：
- Codex：
references/codex-tools.md - Pi：
references/pi-tools.md - Antigravity：
references/antigravity-tools.md - Copilot CLI：
references/copilot-tools.md - Hermes Agent：
references/hermes-tools.md - Qoder：
references/qoder-tools.md
Gemini CLI 用户通过 GEMINI.md 自动获得 references/gemini-tools.md 的工具映射。
中国特色技能路由
当检测到以下场景时，必须优先调用对应的中国特色技能：
| 场景 | 调用技能 |
|---|---|
| 代码审查且团队使用中文沟通 | superpowers:chinese-code-review |
| 使用 Gitee/Coding/极狐 GitLab | superpowers:chinese-git-workflow |
| 编写中文技术文档或 README | superpowers:chinese-documentation |
| 编写 git commit message（中文项目） | superpowers:chinese-commit-conventions |
| 构建 MCP 服务器/工具 | superpowers:mcp-builder |
判断依据：
- 项目中有中文注释、中文 README、或 .gitee 目录 → 启用中文系列技能
- commit 历史中有中文 → 使用中文提交规范
- 用户用中文交流 → 所有输出使用中文，优先考虑中国特色技能
中国特色技能与翻译技能叠加使用，不互斥。例如：做代码审查时，同时使用 requesting-code-review（流程）+ chinese-code-review（风格）。
用户指令
用户指令（CLAUDE.md、AGENTS.md、GEMINI.md 等、直接请求）优先于技能，技能又优先于默认行为。只有当你的人类伙伴明确告诉你跳过时，才能跳过技能工作流或指令。