mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
c2ab9e653b
- Add 5 new tool targets to installer (bin/superpowers-zh.js) - Gemini CLI detects GEMINI.md to avoid conflict with Antigravity - Aider detects .aider/ directory for broader compatibility - Add installation docs for Windsurf, Gemini CLI, Aider, Qwen Code - Update README with full 14-tool support table and usage guide - Fix skills count: 20 (14 translated + 6 Chinese-original incl. workflow-runner) - Fix OpenClaw doc linking to wrong upstream repo - Align gemini-extension.json name/version with package.json - Add docs/ to package.json files array for npm installs - Add install script validation step to CI
62 lines
1.6 KiB
Markdown
62 lines
1.6 KiB
Markdown
# Superpowers 中文版 — Aider 安装指南
|
||
|
||
在 [Aider](https://aider.chat) 中使用 superpowers-zh 的完整指南。
|
||
|
||
## 自动安装
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh
|
||
```
|
||
|
||
安装脚本会自动检测 `.aider.conf.yml` 文件并将 skills 复制到 `.aider/skills/` 目录。
|
||
|
||
## 手动安装
|
||
|
||
```bash
|
||
git clone https://github.com/jnMetaCode/superpowers-zh.git
|
||
cp -r superpowers-zh/skills /your/project/.aider/skills
|
||
```
|
||
|
||
## 通过 CONVENTIONS.md 引用
|
||
|
||
Aider 原生支持 `CONVENTIONS.md` 文件。在其中引用 skills：
|
||
|
||
```markdown
|
||
# 项目约定
|
||
|
||
## 工作方法论
|
||
|
||
本项目使用 superpowers-zh skills 作为工作方法论。
|
||
Skills 位于 `.aider/skills/` 目录，每个子目录的 SKILL.md 定义一个工作流。
|
||
|
||
- 新功能开发：先使用 brainstorming skill
|
||
- 编写代码：遵循 test-driven-development skill
|
||
- 调试问题：使用 systematic-debugging skill
|
||
```
|
||
|
||
## 通过 .aider.conf.yml 配置
|
||
|
||
在 `.aider.conf.yml` 中添加 read 配置来加载 skills：
|
||
|
||
```yaml
|
||
read:
|
||
- .aider/skills/brainstorming/SKILL.md
|
||
- .aider/skills/test-driven-development/SKILL.md
|
||
- .aider/skills/systematic-debugging/SKILL.md
|
||
```
|
||
|
||
## 故障排查
|
||
|
||
### Skills 未生效
|
||
|
||
1. 确认 `.aider/skills/` 目录存在且包含 skill 文件夹
|
||
2. 确保在 `CONVENTIONS.md` 或 `.aider.conf.yml` 中引用了 skills
|
||
3. Aider 会自动读取 `CONVENTIONS.md`，无需额外配置
|
||
|
||
## 获取帮助
|
||
|
||
- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
|
||
- 项目主页：https://github.com/jnMetaCode/superpowers-zh
|
||
- Aider 文档：https://aider.chat/docs/
|