using-superpowers

jnMetaCode/superpowers-zh · Agent Skill

此技能確保 AI 代理在響應或執行操作之前始終首先搜尋並使用相關工具。

總覽

發布者	jnMetaCode社群
儲存庫	jnMetaCode/superpowers-zh ↗
技能資料夾	`using-superpowers`
星	8,021
附帶檔案	1
授權	MIT
最近更新	2026年9月6日
連結	技能原始碼 ↗ · 儲存庫 ↗

Mozgi 檢查

我們在技能檔案中發現的內容。詳細資訊需訂閱。

安全性

低風險 · 未發現明顯風險 — 完整報告會顯示細節

相容性

僅含說明 — 適用於多數代理

相似技能

找到 51 個相似技能

訂閱另含

安裝

技能就是一個含 SKILL.md 的資料夾。選擇你的代理，在專案根目錄的終端機（macOS、Linux 或 Windows 的 Git Bash）執行指令。

把提示貼到 Claude、Codex 或其他助理：它會自行檢查並安裝技能。

Install the “using-superpowers” skill from mozgi.io (https://mozgi.io/skills/using-superpowers-jnmetacode/) for me.

1. Download the archive: https://mozgi.io/skills/using-superpowers-jnmetacode/download
   If it fails, take the skill folder from the source: https://github.com/jnMetaCode/superpowers-zh/tree/main/skills/using-superpowers
2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me.
3. Put the “using-superpowers” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.).
4. Make sure <skills folder>/using-superpowers/SKILL.md exists.
5. Briefly tell me what this skill does and offer to try it on my task.

If you cannot do a step yourself, tell me what to click or type.

git clone --depth 1 --branch main https://github.com/jnMetaCode/superpowers-zh.git /tmp/superpowers-zh
mkdir -p .claude/skills
cp -r /tmp/superpowers-zh/skills/using-superpowers .claude/skills/using-superpowers

重新啟動 Claude Code — 技能就會出現在清單中，手動呼叫：/using-superpowers。要套用到所有專案，請放在 ~/.claude/skills。

git clone --depth 1 --branch main https://github.com/jnMetaCode/superpowers-zh.git /tmp/superpowers-zh
mkdir -p .agents/skills
cp -r /tmp/superpowers-zh/skills/using-superpowers .agents/skills/using-superpowers

Codex 會從目前資料夾往上到儲存庫根目錄，在 .agents/skills 中尋找技能；用 /skills 或 $using-superpowers 呼叫。所有專案：~/.agents/skills。

git clone --depth 1 --branch main https://github.com/jnMetaCode/superpowers-zh.git /tmp/superpowers-zh
mkdir -p .cursor/skills
cp -r /tmp/superpowers-zh/skills/using-superpowers .cursor/skills/using-superpowers

Cursor 啟動時會載入技能；在 Agent 聊天輸入「/」呼叫。Cursor 也會讀取 .claude/skills 與 .agents/skills。所有專案：~/.cursor/skills。

git clone --depth 1 --branch main https://github.com/jnMetaCode/superpowers-zh.git /tmp/superpowers-zh
mkdir -p .gemini/skills
cp -r /tmp/superpowers-zh/skills/using-superpowers .gemini/skills/using-superpowers

任務符合時，Gemini CLI 會提議啟用技能，由你確認。所有專案：~/.gemini/skills。

技能檔案

1 個檔案下載 ZIP

安裝前請先檢視 SKILL.md 與相關檔案。點擊檔案即可預覽。

SKILL.md 內容

作者原文 · 唯讀

<SUBAGENT-STOP>

如果你是作为子智能体被分派来执行特定任务的，忽略此技能。

</SUBAGENT-STOP>

<EXTREMELY-IMPORTANT>

如果你认为哪怕只有 1% 的可能性某个技能适用于你正在做的事情，你绝对必须调用该技能。

如果一个技能适用于你的任务，你没有选择。你必须使用它。

这不可协商。你不能通过合理化来逃避。

</EXTREMELY-IMPORTANT>

规则

在任何响应或操作之前调用相关或被请求的技能——包括澄清性问题、探索代码库、或查看文件之前。如果调用后发现技能不适合当前情况，你不需要使用它。

在进入 EnterPlanMode 之前： 如果你还没有头脑风暴过，先调用头脑风暴技能。

然后宣布"使用 [技能] 来 [目的]"，并严格遵循该技能。如果它有检查清单，为每个条目创建一个待办。

技能优先级

当多个技能都适用时，流程技能优先——它们决定处理方式，然后由实现技能（前端设计等）负责执行。头脑风暴和系统化调试是 Superpowers 中最常见的流程技能，但这条规则适用于任何流程技能。

"让我们构建 X" → 先用 brainstorming，再用实现技能。
"修复这个 bug" → 先用 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 何时使用。其余各节均为逐节翻译。

这 4 个 chinese-* 是参考资料，不是工作流 —— 话术模板、排版约定、平台配置差异。

它们只在用户显式调用时才加载，不要根据上下文自动触发：上下文里多一份排版参考

不会让你写得更好，只会挤掉真正需要的内容。

| 用户显式说 | 加载技能 | 里面是什么 |

|------|---------|---------|

| /chinese-code-review | chinese-code-review | 中文 review 话术模板、分级标注、国内团队常见反模式应对 |

| /chinese-git-workflow | chinese-git-workflow | Gitee / Coding.net / 极狐 GitLab / CNB 的 SSH、凭据、CI 接入差异 |

| /chinese-documentation | chinese-documentation | 中英文空格、全半角标点、术语保留、中文文案排版指北约定 |

| /chinese-commit-conventions | chinese-commit-conventions | Conventional Commits 中文适配、commitlint / husky 中文模板 |

用户没点名就不要主动拉进来。反过来，用户点名了就照它执行，不要因为"看起来只是格式问题"

而跳过。

它们与翻译技能叠加使用，不互斥：用户要求做中文 review 时，是

requesting-code-review（流程）加上 chinese-code-review（风格），不是二选一。

> 这个「只在显式调用时加载」是刻意决定，不是漏写（见 commit 392ff75）。改动它需要

> eval 证据 —— 参见 PR #123 与本仓 CLAUDE.md「Skill 改动需要 eval」。

用户指令

用户指令（CLAUDE.md、AGENTS.md、GEMINI.md 等、直接请求）优先于技能，技能又优先于默认行为。只有当你的人类伙伴明确告诉你跳过时，才能跳过技能工作流或指令。

常見問題

using-superpowers 技能有什麼用途？

此技能確保 AI 代理在響應或執行操作之前始終首先搜尋並使用相關工具。

如何安裝 using-superpowers？

打開本頁的「安裝」區塊並選擇你的代理 — Claude Code、Codex、Cursor 或 Gemini CLI：那裡有把技能資料夾複製到正確位置的現成指令。也可以複製「透過助理」分頁中的提示，讓助理自行檢查並安裝技能。

using-superpowers 適用哪些 AI 模型？

技能是純 Markdown 指示（Agent Skills 格式），因此 using-superpowers 適用任何讀取 SKILL.md 的代理：Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 等。只有在任務符合技能描述時，模型才會載入指示。

using-superpowers 是免費的嗎？

此技能由 jnMetaCode 公開發布，採用 MIT 授權。技能本身免費 — 你只需向 AI 供應商支付實際使用的 token 費用。

安裝技能安全嗎？

技能是代理會遵循的指示，安裝前請閱讀 SKILL.md 及相關檔案。技能資料夾中的腳本只有在代理執行時才會運行 — 留意它的動作，不要授予多餘權限。

技能和 MCP 伺服器或外掛有何不同？

MCP 伺服器或外掛為模型提供新工具 — 會執行並回傳結果的程式碼。技能提供的是知識與流程：如何處理任務、要遵循哪些步驟、好的成果長什麼樣子。它不需要伺服器或 API 金鑰。

總覽