mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
43a46f7912
按维护者决定：保留翻译 skill 内的 fork 增量，但必须做到「不影响上游部分」。 原来的做法做不到这一点 —— 增量是**插在上游步骤序列中间**的。 ## 问题 executing-plans 把「处理常见异常」插成了步骤 3，于是上游的 Step 3: Complete Development 被挤成了我们的「步骤 4」。这就不是「不影响上游」， 而是改了上游的结构编号；Remember 也被多加了一条，从上游的 6 条变成 7 条。 ## 改法：外挂式 - 「处理常见异常」移出步骤序列，改为独立小节，挂在「何时停下来求助」之后 （它本就是那一节里「缺少依赖、测试失败、指令不清」三种情形的展开） - 步骤编号恢复为 1/2/3，与上游逐条对应 - Remember 恢复为上游的 6 条；被多加的「每个任务单独提交」并入外挂节 - 节内首行显式标注：本节是 superpowers-zh 的增量内容，上游没有 using-superpowers 的「中国特色技能路由」同样加上该标注。 现在 14 个翻译 skill 里，上游各节全部逐节对应；多出的 2 节都带标注。 ## 让纪律可执行：audit 新增 3c-bis 光靠 README 声明会漂移。新增检查：翻译 skill 的标题数必须等于 「上游标题数 + 本文件里带标注的增量节数」。标注与内容同处一文件，不会各自漂移。 未标注就多出章节 = 隐性分叉，下次同步会被误当成漏译 —— 直接 FAIL。 已双向验证：给 brainstorming 偷偷加一节会被拦下并给出可操作提示， 加上标注后放行。 ## 修掉一个让守卫从未生效的 bug（我自己写的） 3c-bis 第一次测试没拦住。查出原因：`grep -c` 匹配到 0 个时输出 "0" 但 **退出码为 1**，写成 `$(grep -c ... || echo 0)` 会拼出 "0\n0"，后续整数比较 直接报错、检查静默失效。改用 `; true` 只吞退出码。 全仓扫同一模式，发现测试辅助里也有 3 处（上游同样有这个 bug）： - tests/claude-code/test-helpers.sh:77 assert_count 的实际值 - test-subagent-driven-development-integration.sh 的 task_count / todo_count 这个 bug 的后果是断言**永远无法正常失败** —— 模式没匹配到时比较报错而非判定失败。 三处一并修掉并加注释说明原因。（tests/ 不进 npm 包，仅开发使用。） 修复后 audit 由 154 升到 166 pass —— 因为 3c-bis 现在真的对 14 个 skill 都跑了。 ## README 简繁对比表新增一行「翻译 skill 内的增量」，写明仅 2 处、都带标注、 上游各节不被改动、audit 会强制未标注的增量报错。 验证：audit.sh 166 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 0 fail
4.4 KiB
4.4 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-zh 的增量内容，上游 obra/superpowers 没有。 用于把中文场景路由到本 fork 原创的 chinese-* 系列 skill。其余各节均为逐节翻译。
当检测到以下场景时，必须优先调用对应的中国特色技能：
| 场景 | 调用技能 |
|---|---|
| 代码审查且团队使用中文沟通 | 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 等、直接请求）优先于技能，技能又优先于默认行为。只有当你的人类伙伴明确告诉你跳过时，才能跳过技能工作流或指令。