README.gemini-cli.md

Superpowers 中文版 — Gemini CLI 安装指南

在 Gemini CLI 中使用 superpowers-zh 的完整指南。

自动安装

cd /your/project
npx superpowers-zh

安装脚本会自动检测 .gemini/ 目录并将 skills 复制到 .gemini/skills/ 目录。

手动安装

git clone https://github.com/jnMetaCode/superpowers-zh.git
cp -r superpowers-zh/skills /your/project/.gemini/skills

或作为 Gemini 扩展安装（全局）：

mkdir -p ~/.gemini/extensions/superpowers-zh/skills
cp -r superpowers-zh/skills/* ~/.gemini/extensions/superpowers-zh/skills/
cp superpowers-zh/gemini-extension.json ~/.gemini/extensions/superpowers-zh/

通过 GEMINI.md 引用

在项目根目录的 GEMINI.md 中引用 skills：

# 工作方法论

请参考 .gemini/skills/ 目录中的 SKILL.md 文件。
遇到新功能开发时，先使用 brainstorming skill。
编写代码时，遵循 test-driven-development skill。

Skill 加载优先级

位置	优先级	说明
.gemini/skills/	最高	项目级，仅当前项目
~/.gemini/extensions/*/skills/	中	扩展级，所有项目共享

故障排查

Skills 未生效

1. 确认 .gemini/skills/ 目录存在且包含 skill 文件夹
2. 每个 skill 需要包含有效 YAML frontmatter 的 SKILL.md 文件
3. 重启 Gemini CLI

扩展模式未加载

1. 检查 gemini-extension.json 是否正确放在扩展目录中
2. 确认扩展目录结构：~/.gemini/extensions/superpowers-zh/

获取帮助

• 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
• 项目主页：https://github.com/jnMetaCode/superpowers-zh
• Gemini CLI 文档：https://github.com/google-gemini/gemini-cli