using-superpowers

$npx mdskill add jnMetaCode/superpowers-zh/using-superpowers

在开始对话时使用技能来查找和使用其他技能

  • 确保在任何响应之前调用相关或被请求的技能,包括澄清性问题、探索代码库或查看文件。
  • 依赖于Skill工具来确定如何查找和使用其他技能。
  • 根据技能优先级流程技能(如头脑风暴和系统化调试)优先于实现技能执行任务。
  • 如果发现技能不适合当前情况,则无需使用它。

SKILL.md

.github/skills/using-superpowersView on GitHub ↗
---
name: using-superpowers
description: 在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具
version: "1.0.0"
license: MIT
metadata:
  hermes:
    tags: [meta, getting-started]
---

<SUBAGENT-STOP>
如果你是作为子智能体被分派来执行特定任务的,忽略此技能。
</SUBAGENT-STOP>

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

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

这不可协商。你不能通过合理化来逃避。
</EXTREMELY-IMPORTANT>

## 规则

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

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

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

## 技能优先级

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

- "让我们构建 X" → 先用 superpowers:brainstorming,再用实现技能。
- "修复这个 bug" → 先用 superpowers:systematic-debugging,再用领域技能。

## 红线

这些想法意味着停下——你在合理化:

| 想法 | 现实 |
|------|------|
| "这只是一个简单的问题" | 问题就是任务。检查技能。 |
| "我需要先了解更多上下文" | 技能检查在澄清性问题之前。 |
| "让我先探索一下代码库" | 技能告诉你如何探索。先检查。 |
| "我可以快速查一下 git/文件" | 文件缺少对话上下文。检查技能。 |
| "让我先收集信息" | 技能告诉你如何收集信息。 |
| "这不需要正式的技能" | 如果技能存在,就使用它。 |
| "我记得这个技能" | 技能会迭代更新。阅读当前版本。 |
| "这不算一个任务" | 行动 = 任务。检查技能。 |
| "技能太小题大做了" | 简单的事会变复杂。使用它。 |
| "让我先做这一件事" | 在做任何事之前先检查。 |
| "这样做感觉很高效" | 无纪律的行动浪费时间。技能防止这一点。 |
| "我知道那是什么意思" | 知道概念 ≠ 使用技能。调用它。 |

## 平台适配

如果你的运行环境在下面列出,请阅读对应的参考文件获取特殊说明:

- Codex:`references/codex-tools.md`
- Pi:`references/pi-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 等、直接请求)优先于技能,技能又优先于默认行为。只有当你的人类伙伴明确告诉你跳过时,才能跳过技能工作流或指令。

More from jnMetaCode/superpowers-zh

SkillDescription
brainstorming在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。
chinese-code-review中文 review 沟通参考——话术模板、分级标注(必须修复/建议修改/仅供参考)、国内团队常见反模式应对。仅在用户显式 /chinese-code-review 时调用,不要根据上下文自动触发。
chinese-commit-conventions中文 commit 与 changelog 配置参考——Conventional Commits 中文适配、commitlint/husky/commitizen 中文模板、conventional-changelog 中文配置。仅在用户显式 /chinese-commit-conventions 时调用,不要根据上下文自动触发。
chinese-documentation中文文档排版参考——中英文空格、全半角标点、术语保留、链接格式、中文文案排版指北约定。仅在用户显式 /chinese-documentation 时调用,不要根据上下文自动触发。
chinese-git-workflow国内 Git 平台配置参考——Gitee、Coding.net、极狐 GitLab、CNB 的 SSH/HTTPS/凭据/CI 接入差异与镜像同步配置。仅在用户显式 /chinese-git-workflow 时调用,不要根据上下文自动触发。
dispatching-parallel-agents当面对 2 个以上可以独立进行、无共享状态或顺序依赖的任务时使用
executing-plans当你有一份书面实现计划需要在单独的会话中执行,并设有审查检查点时使用
finishing-a-development-branch当实现完成、所有测试通过、需要决定如何集成工作时使用——通过提供合并、PR 或清理等结构化选项来引导开发工作的收尾
receiving-code-review收到代码审查反馈后、实施建议之前使用,尤其当反馈不明确或技术上有疑问时——需要技术严谨性和验证,而非敷衍附和或盲目执行
using-git-worktrees当需要开始与当前工作区隔离的功能开发,或在执行实现计划之前使用——通过原生工具或 git worktree 回退机制确保隔离工作区存在