illegalCreed

中文

English

中文

English

Appearance

参考 ​

基于 obra/superpowers 主分支编写。完整 skill 列表见 GitHub 仓库。

完整 Skill 列表 ​

Core workflow skills ​

Skill强度触发
using-superpowersmandatory每次对话开始
brainstormingmandatory新需求 / 设计问题
writing-plansmandatory多步任务
executing-plansmandatory计划批准后
verification-before-completionmandatory声称完工前
test-driven-developmentmandatory写代码前
systematic-debuggingmandatory调试场景

Subagent / parallel skills ​

Skill触发
subagent-driven-development大型任务派子代理
dispatching-parallel-agents多个无依赖任务
dispatching-investigative-subagent调研型子任务
dispatching-research-subagent文献 / 资料调研

Git / workflow skills ​

Skill触发
using-git-worktrees风险大改动隔离
finishing-a-development-branch完工后流程
requesting-code-review提交 review
receiving-code-review收到 review 评论
using-git通用 git 操作

Code quality skills ​

Skill触发
writing-tests写测试场景
writing-skills创建新 skill 时
refactoring重构场景
condition-based-waiting异步代码涉及等待
defensive-programming边界处理

Meta skills ​

Skill作用
using-superpowers入口，强制 skill-first 流程
evaluating-skill-fit判断哪个 skill 适合当前任务
composing-skills多个 skill 组合使用

列表持续更新

上游 skill 数会随版本变化。准确列表用 /skills 或看 ~/.claude/plugins/superpowers/skills/。

SKILL.md frontmatter 完整字段 ​

md
---
name: my-skill
description: |
  Use when [触发场景描述]
  Example: "用户问 X" / "需要做 Y 前"
strength: mandatory | recommended | optional
applies-to:
  - claude-code
  - codex
  - gemini-cli
  - cursor
  - copilot-cli
related-skills:
  - test-driven-development
  - verification-before-completion
references:
  - title: "Some Reference"
    url: "https://..."
---
字段必需说明
name✓skill 名（也是 /<name> 命令）
description✓何时触发——Agent 据此自动调用
strength-mandatory / recommended / optional
applies-to-适用 Agent 平台（无字段 = 全适用）
related-skills-关联 skill（供 Agent 链式调用）
references-外部参考链接

mandatory 与 recommended 的差别：

  • mandatory：Agent 必须走这个流程，跳过需用户显式同意
  • recommended：Agent 优先用但可灵活判断
  • optional：仅手动调用

Plugin 配置 ​

启用 / 禁用 ​

json
// ~/.claude/settings.json
{
  "plugins": {
    "superpowers": {
      "enabled": true,
      "disabledSkills": ["brainstorming"],
      "disabledMandatorySkills": []
    }
  }
}

项目级覆盖 ​

json
// <project>/.claude/settings.json
{
  "plugins": {
    "superpowers": {
      "disabledSkills": ["using-git-worktrees"]
    }
  }
}

项目内禁用某 skill（合并：用户级 + 项目级 disabledSkills 取并集）。

文件结构 ​

~/.claude/plugins/superpowers/        # plugin 安装位置
├── skills/
│   ├── using-superpowers/
│   │   └── SKILL.md
│   ├── brainstorming/
│   │   └── SKILL.md
│   ├── test-driven-development/
│   │   ├── SKILL.md
│   │   └── references/
│   │       └── test-anti-patterns.md
│   └── ...
├── plugin.json                       # plugin 元数据
└── README.md

plugin.json:

json
{
  "name": "superpowers",
  "version": "1.x.x",
  "author": "Jesse Vincent (Prime Radiant)",
  "description": "...",
  "skills": [
    {
      "name": "using-superpowers",
      "path": "skills/using-superpowers/SKILL.md"
    },
    ...
  ]
}

CLI 命令 ​

Marketplace 操作 ​

bash
# 列出可用 plugin
/plugin list --available

# 装
/plugin install superpowers@claude-plugins-official
/plugin install superpowers@1.5.0   # 指定版本

# 升级
/plugin update superpowers

# 卸载
/plugin uninstall superpowers

# 查看 plugin 详情
/plugin info superpowers

# 临时禁用（不删）
/plugin disable superpowers
/plugin enable superpowers

Skill 操作 ​

bash
/skills                           # 列当前生效 skill
/skills --plugin superpowers      # 仅 superpowers 的 skill
/skills <name>                    # 看某 skill 详情
/superpowers:<name>               # 手动触发

命名空间约定 ​

来源命名规则例子
用户自写（~/.claude/skills/）无前缀my-team-style
项目自写（<proj>/.claude/skills/）无前缀cypress-skill
Plugin 安装<plugin-name>:<skill>superpowers:brainstorming
Anthropic 内置claude-code:<skill>（罕见）

冲突优先级：项目 > 用户 > plugin > 内置（具体 > 通用）。

跨平台兼容性 ​

Skill 字段Claude CodeCodexGemini CLICursorCopilot
name / description✓✓✓✓✓
Skill tool 加载✓✓ (skill)activate_skillUI 触发✓
strength: mandatory✓✓部分✓✓
项目级 skill✓✓✓✓✓
Hooks 配合✓部分部分-✓

详见 superpowers 仓库 references/copilot-tools.md / references/codex-tools.md / references/gemini-tools.md 等平台适配说明。

与其它 skill 框架对比 ​

框架范围特点
superpowers软件开发全流程mandatory workflow，强制 skill-first
Easy Claude Code (ECC)Claude Code 使用辅助降低使用门槛，简化命令
awesome-claude-code 列表工具索引不是 skill 框架，是清单
自家 SKILL.md项目内规范团队 / 个人定制

参考：ECC / awesome-claude-code。

调试 skill 加载 ​

bash
# 详细日志看 skill 加载顺序
CLAUDE_LOG_LEVEL=debug claude

# 查看当前会话注入的 skill
/skills --active

调试 frontmatter 解析错：

bash
# skill 文件加载失败时 stderr 输出
claude --debug 2>&1 | grep "skill"

反模式 ​

反模式问题
写 100 行的 descriptionAgent 读不完，建议 < 200 字
description 太宽（"用于编码"）没法精准触发，建议「Use when 用户问 X 类问题」
步骤含「考虑性能」「保证质量」等空话不具体可执行 → 改成「用 console.time 测时长」「跑 lint --max-warnings=0」
skill 之间循环引用A → B → A 无限递归
mandatory skill 太多Agent 每次都走全流程，慢且烦
中文 skill 配中文 Agent跨平台时英文 Agent 看不懂

资源链接 ​