superpowers-zh 1.1.0 → 1.1.2

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "superpowers-zh",
-  "description": "AI 编程超能力中文版：19 个 skills 库",
+  "description": "AI 编程超能力中文增强版：20 个 skills，支持 OpenClaw / Claude Code / Cursor 等 14 款工具",
   "owner": {
     "name": "jnMetaCode",
     "url": "https://github.com/jnMetaCode"
@@ -8,8 +8,8 @@
   "plugins": [
     {
       "name": "superpowers-zh",
-      "description": "AI 编程超能力中文版：19 个 skills（14 翻译 + 5 中国特色原创）",
-      "version": "1.0.0",
+      "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 OpenClaw / Claude Code / Cursor 等 14 款工具",
+      "version": "1.1.1",
       "source": "./",
       "author": {
         "name": "jnMetaCode",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "superpowers-zh",
-  "description": "AI 编程超能力中文版：19 个 skills（14 翻译 + 5 中国特色原创）",
-  "version": "1.0.0",
+  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 OpenClaw / Claude Code / Cursor 等 14 款工具",
+  "version": "1.1.1",
   "author": {
     "name": "jnMetaCode",
     "url": "https://github.com/jnMetaCode"

package/.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "superpowers-zh",
   "displayName": "Superpowers 中文版",
-  "description": "AI 编程超能力中文版：19 个 skills（14 翻译 + 5 中国特色原创）",
-  "version": "1.0.0",
+  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 OpenClaw / Cursor / Claude Code 等 14 款工具",
+  "version": "1.1.1",
   "author": {
     "name": "jnMetaCode",
     "url": "https://github.com/jnMetaCode"

package/README.md

@@ -1,30 +1,78 @@
-# superpowers-zh（AI 编程超能力 · 中文版）
+# superpowers-zh（AI 编程超能力 · 中文增强版）
 
 🌐 **简体中文** | [English (upstream)](https://github.com/obra/superpowers)
 
-> **让你的 AI 编程助手真正会干活** — 从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
+> 🦸 **superpowers（116k+ ⭐）完整汉化 + 6 个中国原创 skills** — 让 OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI 等 **14 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
 
-Chinese community edition of [superpowers](https://github.com/obra/superpowers), including full translations and China-specific development skills.
+Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 14 AI coding tools, including full translations and China-specific development skills.
+
+<!-- 效果对比 -->
+<table>
+<tr><td>
+
+**没装 superpowers-zh：**
+```
+你：给用户模块加个批量导出功能
+AI：好的，我来实现...（直接开始写代码）
+    export async function exportUsers() { ... }
+你：等等，格式不对，没分页，大数据量会 OOM...
+```
+
+</td><td>
+
+**装了 superpowers-zh：**
+```
+你：给用户模块加个批量导出功能
+AI：在开始实现之前，我需要了解几个关键问题：
+    1. 导出格式是 CSV 还是 Excel？
+    2. 预计数据量多大？需要异步处理吗？
+    3. 有权限要求吗？
+    → 给出 2-3 个方案，确认后再动手
+```
+
+</td></tr>
+</table>
 
 [![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/superpowers-zh)
 [![npm version](https://img.shields.io/npm/v/superpowers-zh)](https://www.npmjs.com/package/superpowers-zh)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
-[![QQ群](https://img.shields.io/badge/QQ群-833585047-blue?logo=tencentqq)](https://qm.qq.com/q/x8kyqzlfDc)
+[![QQ群](https://img.shields.io/badge/QQ群-1071280067-blue?logo=tencentqq)](https://qm.qq.com/q/EeNQA9xCxy)
 
 ### 📊 项目规模
 
 | 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
 |:---:|:---:|:---:|
-| **14** | **5** | **Claude Code / Cursor / Codex / Kiro / Trae / Antigravity / VS Code / Gemini** |
+| **14** | **6** | **OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / Qwen Code / Antigravity** |
 
 ---
 
 ## 这是什么？
 
-[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 编程 skills 框架（99k+ stars），为 Claude Code、Cursor 等 AI 编程工具提供**系统化的工作方法论**。
+[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 编程 skills 框架（116k+ stars），为 AI 编程工具提供**系统化的工作方法论**。
+
+**superpowers-zh** 在完整翻译的基础上，新增了面向中国开发者的特色 skills。
+
+### 🤖 支持 14 款主流 AI 编程工具
+
+| 工具 | 类型 | 一键安装 | 手动安装 |
+|------|------|:---:|:---:|
+| [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
+| [Claude Code](https://claude.ai/code) | CLI | `npx superpowers-zh` | `.claude/skills/` |
+| [Cursor](https://cursor.sh) | IDE | `npx superpowers-zh` | `.cursor/skills/` |
+| [Windsurf](https://codeium.com/windsurf) | IDE | `npx superpowers-zh` | `.windsurf/skills/` |
+| [Kiro](https://kiro.dev) | IDE | `npx superpowers-zh` | `.kiro/steering/` |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | CLI | `npx superpowers-zh` | `.gemini/skills/` |
+| [Codex CLI](https://github.com/openai/codex) | CLI | `npx superpowers-zh` | `.codex/skills/` |
+| [Aider](https://aider.chat) | CLI | `npx superpowers-zh` | `.aider/skills/` |
+| [Trae](https://trae.ai) | IDE | `npx superpowers-zh` | `.trae/skills/` + `.trae/rules/` |
+| [VS Code](https://code.visualstudio.com) (Copilot) | IDE 插件 | `npx superpowers-zh` | `.github/superpowers/` |
+| [DeerFlow 2.0](https://github.com/bytedance/deer-flow) | Agent 框架 | `npx superpowers-zh` | `skills/custom/` |
+| [OpenCode](https://opencode.ai) | CLI | `npx superpowers-zh` | `.opencode/skills/` |
+| [Qwen Code](https://tongyi.aliyun.com/lingma) (通义灵码) | IDE 插件 | `npx superpowers-zh` | `.qwen/skills/` |
+| [Antigravity](https://github.com/anthropics/antigravity) | CLI | `npx superpowers-zh` | `.antigravity/skills/` |
 
-**superpowers-zh** 在完整翻译的基础上，新增了面向中国开发者的特色 skills：
+> 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具，将 20 个 skills 安装到正确位置。
 
 ### 翻译的 Skills（14 个）
 
@@ -45,7 +93,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers),
 | **编写 Skills** (writing-skills) | 创建新 skill 的方法论 |
 | **使用 Superpowers** (using-superpowers) | 元技能：如何调用和优先使用 skills |
 
-### 🇨🇳 中国特色 Skills（5 个）
+### 🇨🇳 中国特色 Skills（6 个）
 
 | Skill | 用途 | 上游有吗？ |
 |-------|------|:---:|
@@ -54,6 +102,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers),
 | **中文技术文档** (chinese-documentation) | 中文排版规范、中英混排、告别机翻味 | 无 |
 | **中文提交规范** (chinese-commit-conventions) | 适配国内团队的 commit message 规范 | 无 |
 | **MCP 服务器构建** (mcp-builder) | 构建生产级 MCP 工具，扩展 AI 能力边界 | 无 |
+| **工作流执行器** (workflow-runner) | 在 AI 工具内运行多角色 YAML 工作流 | 无 |
 
 ---
 
@@ -77,8 +126,16 @@ cp -r superpowers-zh/skills /your/project/.claude/skills      # Claude Code
 cp -r superpowers-zh/skills /your/project/.cursor/skills      # Cursor
 cp -r superpowers-zh/skills /your/project/.codex/skills       # Codex CLI
 cp -r superpowers-zh/skills /your/project/.kiro/steering      # Kiro
+cp -r superpowers-zh/skills /your/project/skills/custom       # DeerFlow 2.0
 cp -r superpowers-zh/skills /your/project/.trae/rules         # Trae
 cp -r superpowers-zh/skills /your/project/.antigravity        # Antigravity
+cp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)
+cp -r superpowers-zh/skills /your/project/skills              # OpenClaw
+cp -r superpowers-zh/skills /your/project/.windsurf/skills   # Windsurf
+cp -r superpowers-zh/skills /your/project/.gemini/skills     # Gemini CLI
+cp -r superpowers-zh/skills /your/project/.aider/skills      # Aider
+cp -r superpowers-zh/skills /your/project/.opencode/skills   # OpenCode
+cp -r superpowers-zh/skills /your/project/.qwen/skills       # Qwen Code
 ```
 
 ### 方式三：在配置文件中引用
@@ -89,12 +146,19 @@ cp -r superpowers-zh/skills /your/project/.antigravity        # Antigravity
 |------|---------|------|
 | Claude Code | `CLAUDE.md` | 项目根目录 |
 | Kiro | `.kiro/steering/*.md` | 支持 always/globs/手动三种模式 |
+| DeerFlow 2.0 | `skills/custom/*/SKILL.md` | 字节跳动开源 SuperAgent，自动发现自定义 skills |
 | Trae | `.trae/rules/project_rules.md` | 项目级规则 |
 | Antigravity | `GEMINI.md` 或 `AGENTS.md` | 项目根目录 |
 | VS Code | `.github/copilot-instructions.md` | Copilot 自定义指令 |
 | Cursor | `.cursor/rules/*.md` | 项目级规则目录 |
+| OpenClaw | `skills/*/SKILL.md` | 工作区级 skills 目录，自动发现 |
+| Windsurf | `.windsurf/skills/*/SKILL.md` | 项目级 skills 目录 |
+| Gemini CLI | `.gemini/skills/*/SKILL.md` | 项目级 skills 目录 |
+| Aider | `.aider/skills/*/SKILL.md` | 项目级 skills 目录 |
+| OpenCode | `.opencode/skills/*/SKILL.md` | 项目级 skills 目录 |
+| Qwen Code | `.qwen/skills/*/SKILL.md` | 项目级 skills 目录 |
 
-> **详细安装指南**：[Kiro](docs/README.kiro.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md)
+> **详细安装指南**：[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md)
 
 ---
 
@@ -102,7 +166,7 @@ cp -r superpowers-zh/skills /your/project/.antigravity        # Antigravity
 
 | 特性 | superpowers (英文) | superpowers-zh (中文) |
 |------|-------------------|----------------------|
-| Skills 数量 | 14 | **19**（14 翻译 + 5 原创） |
+| Skills 数量 | 14 | **20**（14 翻译 + 6 原创） |
 | 语言 | 英文 | 中文（技术术语保留英文） |
 | 代码审查规范 | 西方直接风格 | 适配国内团队沟通文化 |
 | Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 |
@@ -133,7 +197,7 @@ cp -r superpowers-zh/skills /your/project/.antigravity        # Antigravity
 
 | 群名 | 群号 | 加入方式 |
 |------|------|---------|
-| AI Agent 中文实践群 | **833585047** | [点击加入](https://qm.qq.com/q/x8kyqzlfDc) |
+| AI 编程 & Agent 中文实践群 | **1071280067** | [点击加入](https://qm.qq.com/q/EeNQA9xCxy) |
 
 ---
 
@@ -141,7 +205,11 @@ cp -r superpowers-zh/skills /your/project/.antigravity        # Antigravity
 
 - 原始英文版：[obra/superpowers](https://github.com/obra/superpowers)（MIT 协议）
 - 感谢 [@obra](https://github.com/obra) 创建了这个优秀的项目
-- 姊妹项目：[agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh)（180 个 AI 智能体专家团队）
+- 姊妹项目：
+  - [ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide) — AI 编程工具实战指南 — 66 个 Claude Code 技巧 + 9 款工具最佳实践 + 可复制配置模板
+  - [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) — 187 个专业角色，让 AI 变成安全工程师、DBA、产品经理等
+  - [agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) — 多智能体编排引擎 — 用 YAML 编排 187 个角色协作，支持 DeepSeek/Claude/OpenAI/Ollama，零代码
+  - [shellward](https://github.com/jnMetaCode/shellward) — AI 智能体安全中间件 — 注入检测、数据防泄露、命令安全、零依赖、MCP Server
 
 ---
 
@@ -153,7 +221,7 @@ MIT License — 自由使用，商业或个人均可。
 
 <div align="center">
 
-**AI 编程超能力：让你的 AI 助手真正会干活**
+**🦸 AI 编程超能力：让 OpenClaw / Claude Code / Cursor 等 14 款工具真正会干活**
 
 [Star 本项目](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [贡献代码](https://github.com/jnMetaCode/superpowers-zh/pulls)
 

package/bin/superpowers-zh.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { existsSync, mkdirSync, cpSync, readdirSync, readFileSync } from 'fs';
+import { existsSync, mkdirSync, cpSync, readdirSync, readFileSync, writeFileSync } from 'fs';
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
@@ -15,9 +15,16 @@ const TARGETS = [
   { name: 'Cursor',        dir: '.cursor/skills',           detect: '.cursor' },
   { name: 'Codex CLI',     dir: '.codex/skills',            detect: '.codex' },
   { name: 'Kiro',          dir: '.kiro/steering',            detect: '.kiro' },
-  { name: 'Trae',          dir: '.trae/rules',               detect: '.trae' },
+  { name: 'DeerFlow',      dir: 'skills/custom',             detect: 'deer_flow' },
+  { name: 'Trae',          dir: '.trae/skills',              detect: '.trae' },
   { name: 'Antigravity',   dir: '.antigravity/skills',       detect: '.antigravity' },
   { name: 'VS Code',       dir: '.github/superpowers',       detect: '.github/copilot-instructions.md' },
+  { name: 'OpenClaw',      dir: 'skills',                     detect: '.openclaw' },
+  { name: 'Windsurf',      dir: '.windsurf/skills',          detect: '.windsurf' },
+  { name: 'Gemini CLI',    dir: '.gemini/skills',            detect: 'GEMINI.md' },
+  { name: 'Aider',         dir: '.aider/skills',             detect: '.aider' },
+  { name: 'OpenCode',      dir: '.opencode/skills',          detect: '.opencode' },
+  { name: 'Qwen Code',     dir: '.qwen/skills',             detect: '.qwen' },
 ];
 
 function countDirs(dir) {
@@ -25,27 +32,97 @@ function countDirs(dir) {
   return readdirSync(dir, { withFileTypes: true }).filter(e => e.isDirectory()).length;
 }
 
+function generateTraeBootstrapRule(projectDir) {
+  const rulesDir = resolve(projectDir, '.trae', 'rules');
+  mkdirSync(rulesDir, { recursive: true });
+
+  // 扫描已安装的 skills，读取 name 和 description
+  const skillsDir = resolve(projectDir, '.trae', 'skills');
+  const skillEntries = [];
+  if (existsSync(skillsDir)) {
+    for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const skillFile = resolve(skillsDir, entry.name, 'SKILL.md');
+      if (!existsSync(skillFile)) continue;
+      const content = readFileSync(skillFile, 'utf8');
+      const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+      if (!fmMatch) continue;
+      const nameMatch = fmMatch[1].match(/^name:\s*(.+)$/m);
+      const descMatch = fmMatch[1].match(/^description:\s*["']?(.+?)["']?\s*$/m);
+      if (nameMatch) {
+        skillEntries.push({
+          name: nameMatch[1].trim(),
+          desc: descMatch ? descMatch[1].trim() : '',
+        });
+      }
+    }
+  }
+
+  const skillTable = skillEntries.map(s => `| ${s.name} | ${s.desc} |`).join('\n');
+
+  const rule = `---
+alwaysApply: true
+---
+
+# Superpowers-ZH 中文增强版
+
+你已加载 superpowers-zh 技能框架（${skillEntries.length} 个 skills）。
+
+## 核心规则
+
+1. **收到任务时，先检查是否有匹配的 skill** — 哪怕只有 1% 的可能性也要检查
+2. **设计先于编码** — 收到功能需求时，先用 brainstorming skill 做需求分析
+3. **测试先于实现** — 写代码前先写测试（TDD）
+4. **验证先于完成** — 声称完成前必须运行验证命令
+
+## 可用 Skills
+
+Skills 位于 \`.trae/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。
+
+| Skill | 触发条件 |
+|-------|---------|
+${skillTable}
+
+## 如何使用
+
+当任务匹配某个 skill 的触发条件时，读取对应的 \`.trae/skills/<skill-name>/SKILL.md\` 并严格遵循其流程。
+`;
+
+  const rulePath = resolve(rulesDir, 'superpowers-zh.md');
+  writeFileSync(rulePath, rule, 'utf8');
+  console.log(`  ✅ Trae: bootstrap rule -> ${rulePath}`);
+}
+
 function showHelp() {
   console.log(`
   superpowers-zh v${PKG.version} — AI 编程超能力中文版
 
   用法：
-    npx superpowers-zh          安装 skills 到当前项目
+    npx superpowers-zh          安装 skills（及 agents）到当前项目
     npx superpowers-zh --help   显示帮助
     npx superpowers-zh --version 显示版本
 
   说明：
     自动检测当前项目使用的 AI 编程工具：
-    Claude Code / Cursor / Codex / Kiro / Trae / Antigravity / VS Code
+    Claude Code / Cursor / Codex / Kiro / DeerFlow / Trae / Antigravity / VS Code / OpenClaw
+    Windsurf / Gemini CLI / Aider / OpenCode / Qwen Code
     将 ${countDirs(SKILLS_SRC)} 个 skills 安装到对应目录。
-    如果未检测到任何工具，默认安装到 .claude/skills/。
+    Claude Code 还会额外安装 agents 到 .claude/agents/。
+    如果未检测到任何工具，默认安装到 .claude/skills/ 和 .claude/agents/。
 
   项目：https://github.com/jnMetaCode/superpowers-zh
 `);
 }
 
 function install() {
+ try {
   console.log(`\n  superpowers-zh v${PKG.version} — AI 编程超能力中文版\n`);
+
+  if (!existsSync(SKILLS_SRC)) {
+    console.error('  ❌ 错误：skills 源目录不存在，请重新安装 superpowers-zh。');
+    process.exit(1);
+  }
+
   console.log(`  源: ${countDirs(SKILLS_SRC)} 个 skills`);
   console.log(`  目标项目: ${PROJECT_DIR}\n`);
 
@@ -62,6 +139,10 @@ function install() {
       console.log(`  ✅ ${target.name}: ${count} 个 skills -> ${dest}`);
       installed++;
 
+      if (target.name === 'Trae') {
+        generateTraeBootstrapRule(PROJECT_DIR);
+      }
+
       if (target.name === 'Claude Code' && existsSync(AGENTS_SRC)) {
         const agentsDest = resolve(PROJECT_DIR, '.claude', 'agents');
         mkdirSync(agentsDest, { recursive: true });
@@ -75,9 +156,20 @@ function install() {
     mkdirSync(dest, { recursive: true });
     cpSync(SKILLS_SRC, dest, { recursive: true });
     console.log(`  ✅ 默认安装: ${countDirs(dest)} 个 skills -> ${dest}`);
+
+    if (existsSync(AGENTS_SRC)) {
+      const agentsDest = resolve(PROJECT_DIR, '.claude', 'agents');
+      mkdirSync(agentsDest, { recursive: true });
+      cpSync(AGENTS_SRC, agentsDest, { recursive: true });
+      console.log(`  ✅ 默认安装: agents -> ${agentsDest}`);
+    }
   }
 
   console.log('\n  安装完成！重启你的 AI 编程工具即可生效。\n');
+ } catch (err) {
+    console.error(`  ❌ 安装失败：${err.message}`);
+    process.exit(1);
+ }
 }
 
 const arg = process.argv[2];
@@ -85,6 +177,10 @@ if (arg === '--help' || arg === '-h') {
   showHelp();
 } else if (arg === '--version' || arg === '-v') {
   console.log(PKG.version);
+} else if (arg && arg.startsWith('-')) {
+  console.warn(`  未知参数: ${arg}\n`);
+  showHelp();
+  process.exit(1);
 } else {
   install();
 }

package/docs/README.aider.md

@@ -0,0 +1,61 @@
+# 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/

package/docs/README.antigravity.md

@@ -0,0 +1,93 @@
+# Superpowers 中文版 — Antigravity 安装指南
+
+在 [Google Antigravity](https://antigravity.google)（Google AI IDE）中使用 superpowers-zh 的完整指南。
+
+## 快速安装
+
+```bash
+cd /your/project
+npx superpowers-zh
+```
+
+安装脚本会自动检测 `.antigravity/` 目录并将 skills 复制到该目录。
+
+## 手动安装
+
+```bash
+git clone https://github.com/jnMetaCode/superpowers-zh.git
+mkdir -p /your/project/.antigravity/skills
+cp -r superpowers-zh/skills/* /your/project/.antigravity/skills/
+```
+
+## 工作原理
+
+Antigravity 支持多种规则文件格式：
+
+| 文件 | 优先级 | 说明 |
+|------|--------|------|
+| `GEMINI.md` | 最高 | Antigravity 专属规则 |
+| `AGENTS.md` | 中 | 通用规则（Antigravity、Cursor、Claude Code 共享） |
+| `.antigravity/rules.md` | 中 | 项目级规则目录 |
+| `CLAUDE.md` | 低 | 也会被自动读取 |
+
+### 推荐配置方式
+
+**方式一**：在项目根目录创建 `GEMINI.md`：
+
+```markdown
+# GEMINI.md
+
+使用 .antigravity/ 目录下的 superpowers skills 来指导工作流程。
+优先使用 brainstorming（头脑风暴）开始新任务。
+
+Skills 列表参见 .antigravity/ 目录。
+```
+
+**方式二**：在 `AGENTS.md` 中引用（多工具共享）：
+
+```markdown
+# AGENTS.md
+
+本项目使用 superpowers-zh skills 框架。
+Skills 位于 .antigravity/（Antigravity）或 .claude/skills/（Claude Code）目录下。
+```
+
+### 工具映射
+
+Antigravity 使用 Gemini 模型，工具名称与 Claude Code 不同：
+
+| Claude Code | Antigravity (Gemini) |
+|-------------|---------------------|
+| `Read` | `read_file` |
+| `Write` | `write_file` |
+| `Edit` | `replace` |
+| `Bash` | `run_shell_command` |
+| `Skill` | `activate_skill` |
+
+Skills 中的 Claude Code 工具名称会被 Antigravity 自动适配。
+
+## 使用
+
+Antigravity 支持 Agent Manager 并行执行多个 agent：
+- 与 superpowers-zh 的「派遣并行 Agent」skill 理念一致
+- 可以同时调度多个 skill 处理不同任务
+
+## 全局规则
+
+个人级别的全局规则放在：
+```
+~/.gemini/GEMINI.md
+~/.gemini/AGENTS.md
+```
+
+## 更新
+
+```bash
+cd /your/project
+npx superpowers-zh
+```
+
+## 获取帮助
+
+- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
+- Antigravity 文档：https://antigravity.google/docs/rules-workflows

package/docs/README.codex.md

@@ -0,0 +1,91 @@
+# Superpowers 中文版 — Codex CLI 安装指南
+
+在 Codex 中使用 superpowers-zh 的完整指南。
+
+## 快速安装
+
+告诉 Codex：
+
+```
+Fetch and follow instructions from https://raw.githubusercontent.com/jnMetaCode/superpowers-zh/refs/heads/main/.codex/INSTALL.md
+```
+
+## 手动安装
+
+### 前置条件
+
+- OpenAI Codex CLI
+- Git
+
+### 步骤
+
+1. 克隆仓库：
+   ```bash
+   git clone https://github.com/jnMetaCode/superpowers-zh.git ~/.codex/superpowers-zh
+   ```
+
+2. 创建 skills 符号链接：
+   ```bash
+   mkdir -p ~/.agents/skills
+   ln -s ~/.codex/superpowers-zh/skills ~/.agents/skills/superpowers
+   ```
+
+3. 重启 Codex。
+
+4. **子代理 skills（可选）：** `dispatching-parallel-agents` 和 `subagent-driven-development` 需要 Codex 的多代理功能。在 Codex 配置中添加：
+   ```toml
+   [features]
+   multi_agent = true
+   ```
+
+### Windows
+
+使用 junction 代替符号链接（无需开发者模式）：
+
+```powershell
+New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
+cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers-zh\skills"
+```
+
+## 工作原理
+
+Codex 原生支持 skill 发现——启动时扫描 `~/.agents/skills/` 目录，解析 SKILL.md 的 frontmatter，按需加载 skills。通过一个符号链接即可注册所有 skills：
+
+```
+~/.agents/skills/superpowers/ → ~/.codex/superpowers-zh/skills/
+```
+
+`using-superpowers` skill 会自动被发现并强制执行 skill 使用纪律——无需额外配置。
+
+## 使用
+
+Skills 自动发现。Codex 在以下情况激活 skills：
+- 你提到 skill 名称（如 "use brainstorming"）
+- 任务匹配 skill 的描述
+- `using-superpowers` skill 指示 Codex 使用某个 skill
+
+## 更新
+
+```bash
+cd ~/.codex/superpowers-zh && git pull
+```
+
+Skills 通过符号链接即时更新。
+
+## 卸载
+
+```bash
+rm ~/.agents/skills/superpowers
+```
+
+**Windows (PowerShell):**
+```powershell
+Remove-Item "$env:USERPROFILE\.agents\skills\superpowers"
+```
+
+可选：删除克隆的仓库 `rm -rf ~/.codex/superpowers-zh`
+
+## 获取帮助
+
+- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
+- 项目主页：https://github.com/jnMetaCode/superpowers-zh