项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 8521
使用教程
环境要求
- 已安装 Node.js,命令行可执行 npx
- 一个可写的项目目录(项目级安装不要在用户主目录 ~ 下执行)
- 已安装目标 AI 编程工具(如 Claude Code / Cursor / Windsurf / Gemini CLI 等)
- 能访问 npm 源;手动安装方式需本地已有 superpowers-zh 仓库副本
安装与启动步骤
-
1进入项目目录
先切到你要安装 skills 的项目根目录,不要在主目录 ~ 下跑项目级安装,v1.2.1 起会直接拒绝。
cd /your/project -
2一键 npm 安装
默认是项目级安装,会把 skills 复制、生成 bootstrap 引导文件并配置 hooks,一键完成。
npx superpowers-zh -
3全局安装(可选)
维护多个项目时用全局安装,装到用户级目录一次生效;不带 --tool 会自动检测已装工具。
npx superpowers-zh --global npx superpowers-zh --global --tool claude -
4手动安装备选
仅在 npx 不可用(极端无网络)时使用。只复制 skills,不配 hooks、不生成 bootstrap,属低保版安装。
cp -r superpowers-zh/skills /your/project/.claude/skills cp -r superpowers-zh/skills /your/project/.cursor/skills cp -r superpowers-zh/skills /your/project/.windsurf/skills -
5确认引用配置
在工具对应的配置文件中引用 skills,例如 Claude Code 用项目根目录的 CLAUDE.md;部分工具安装时自动生成。
-
6卸载或清理误装
项目级卸载用 --uninstall,全局安装加 --global;若曾误装到主目录,需按此清理。
npx superpowers-zh --uninstall npx superpowers-zh --global --uninstall
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
CLAUDE.md | 是 | Claude Code / Copilot CLI 项目根目录的 bootstrap 引导文件 | /your/project/CLAUDE.md |
.cursor/rules/*.md | 否 | Cursor 项目级规则目录,用于引用 skills | /your/project/.cursor/rules/superpowers-zh.md |
.kiro/steering/superpowers-zh.md | 否 | Kiro 的 steering 索引,需设为 inclusion: always | inclusion: always |
.github/copilot-instructions.md | 否 | VS Code Copilot 自定义指令文件 | /your/project/.github/copilot-instructions.md |
skills/custom/*/SKILL.md | 否 | DeerFlow 2.0 自定义 skills 目录,会被自动发现 | /your/project/skills/custom/my-skill/SKILL.md |
QWEN.md | 否 | Qwen Code 官方分层记忆的默认上下文文件 | /your/project/QWEN.md |
如何确认成功
查看项目内是否生成 .claude/skills 等 skills 目录,以及 CLAUDE.md 等 bootstrap 引导文件;npx 方式还会配置好 hooks。
常见问题
Q:项目级安装报错或提示不能用主目录?
A:README 明确项目级安装不要在主目录 ~ 下执行,v1.2.1 起会拒绝。想让所有项目可用请改用 npx superpowers-zh --global 全局安装。
Q:项目级和全局安装能同时存在吗?
A:可以共存,规则是项目级优先、全局兜底。全局安装把 skills 放到用户级目录,所有项目自动可用,更新时只需重装一次。
Q:为什么 Cursor 等工具用 --global 会被提示改用项目级?
A:Cursor、Kiro、Trae、Aider、DeerFlow、VS Code、Claw、Cline、Kilo Code 的规则是项目级或存于应用内设置;Gemini CLI 和 Antigravity 有各自专属的全局方式,见对应 docs。
Q:手动 cp -r skills 后 AI 不会自动调用 skill?
A:手动复制只搬了 skills 目录,不会配置 hooks 和 bootstrap 引导,需要每次手动喊 “use brainstorming skill” 之类,强烈建议改用 npx superpowers-zh。
注意事项
- 项目级安装不要在主目录 ~ 下运行,老版本可能把 skills 和 CLAUDE.md 写到 home 目录污染所有项目。
- 优先使用 npx superpowers-zh 一键安装,手动 cp -r skills 仅为极端无网络时的低准备好备选。
- 全局安装仅部分工具支持;Gemini CLI、Crush 等的全局路径各不相同,详见 docs 下对应文档。
- 卸载:项目级用 npx superpowers-zh --uninstall,全局用 npx superpowers-zh --global --uninstall。
核心亮点
- 完整汉化 superpowers 项目并新增 6 个中国原创 skills,降低中文用户使用门槛
- 适配 16 款主流 AI 编程工具(Claude Code、Cursor、Gemini CLI 等),覆盖面广
- 基于 116k+ 星标的 superpowers 进行增强,功能可靠且持续迭代
不足之处
- 文档/社区待观察
适用场景
- 中文开发者使用 AI 编程工具时希望获得本地化技能增强
- 团队需要统一 AI 编程工作流并快速上手(汉化降低学习成本)
- 多工具环境下(如同时使用 Claude Code 和 Cursor)需要一致的技能支持
替代项目
superpowers、awesome-claude-code、cursor-tools
同类项目推荐
carboncode
开源
用 DeepSeek 在终端自动拆任务、写代码,成本省 90%
Carbon Code 是一款类似 Claude Code 的代码开发工具,也是中国第一个基于 DeepSeek 的代码···
vibe-code-stack-for-ceos
开源
一份手册,让所有AI写出统一的生产级代码
AI-first Turborepo monorepo where Claude Code, Cursor, Copilot, Gemini CLI, Kiro & W···
lobe-cli-toolbox
开源
让 Git 提交和翻译自动化,告别手写 commit 和语言文件
Lobe CLI Toolbox - AI CLI Toolbox, enhancing git commit and i18n workflow efficiency
go-modern-guidelines
开源
给 AI 代理装上 Go 现代编码规范,生成代码更地道
Help AI coding agents write modern Go
elephant-goldfish-model
开源
让 AI 写代码前先写规范,少返工
Open-source plugin for designing and reviewing software with agents
fast-request
开源
IDE 里直接调接口,省去手写请求和切工具
IntelliJ IDEA plugin Fast Request
OpenCovibe
开源
本地管理 AI 编码会话,让代理工作透明可控
Local-first desktop app for AI coding agents (Claude Code, Codex). Built with Tauri ···
metis
开源
给 AI 编程加个项目经理,任务拆解+自动测试,代码一次过
Metis is a coding agent that boosts AI/LLM coding performance by 50% QQ群: 801193315
skills
开源
给 AI 装上 Vue 3 最佳实践,写代码不再用老写法
Agent skills for Vue 3 development
