README.aider.md

Superpowers 中文版 — Aider 安装指南

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

自动安装

cd /your/project
npx superpowers-zh

安装脚本会自动检测 .aider.conf.yml 文件并将 skills 复制到 .aider/skills/ 目录。

手动安装

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

通过 CONVENTIONS.md 引用

Aider 原生支持 CONVENTIONS.md 文件。在其中引用 skills：

# 项目约定

## 工作方法论

本项目使用 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：

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/