superpowers-zh 1.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "superpowers-zh",
+  "description": "AI 编程超能力中文版：19 个 skills 库",
+  "owner": {
+    "name": "jnMetaCode",
+    "url": "https://github.com/jnMetaCode"
+  },
+  "plugins": [
+    {
+      "name": "superpowers-zh",
+      "description": "AI 编程超能力中文版：19 个 skills（14 翻译 + 5 中国特色原创）",
+      "version": "1.0.0",
+      "source": "./",
+      "author": {
+        "name": "jnMetaCode",
+        "url": "https://github.com/jnMetaCode"
+      }
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "superpowers-zh",
+  "description": "AI 编程超能力中文版：19 个 skills（14 翻译 + 5 中国特色原创）",
+  "version": "1.0.0",
+  "author": {
+    "name": "jnMetaCode",
+    "url": "https://github.com/jnMetaCode"
+  },
+  "homepage": "https://github.com/jnMetaCode/superpowers-zh",
+  "repository": "https://github.com/jnMetaCode/superpowers-zh",
+  "license": "MIT",
+  "keywords": ["skills", "tdd", "debugging", "chinese", "中文", "best-practices", "workflows"]
+}

package/.codex/INSTALL.md

@@ -0,0 +1,67 @@
+# 为 Codex 安装 Superpowers 中文版
+
+通过原生 skill 发现机制在 Codex 中启用 superpowers skills。只需克隆并创建符号链接。
+
+## 前置条件
+
+- Git
+
+## 安装步骤
+
+1. **克隆 superpowers-zh 仓库：**
+   ```bash
+   git clone https://github.com/jnMetaCode/superpowers-zh.git ~/.codex/superpowers
+   ```
+
+2. **创建 skills 符号链接：**
+   ```bash
+   mkdir -p ~/.agents/skills
+   ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers
+   ```
+
+   **Windows (PowerShell)：**
+   ```powershell
+   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
+   cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers\skills"
+   ```
+
+3. **重启 Codex**（退出并重新启动 CLI）以发现 skills。
+
+## 从旧版引导方式迁移
+
+如果你在原生 skill 发现机制之前安装过 superpowers，需要：
+
+1. **更新仓库：**
+   ```bash
+   cd ~/.codex/superpowers && git pull
+   ```
+
+2. **创建 skills 符号链接**（上面的步骤 2）——这是新的发现机制。
+
+3. **移除旧的引导代码块**——删除 `~/.codex/AGENTS.md` 中引用 `superpowers-codex bootstrap` 的代码块，已不再需要。
+
+4. **重启 Codex。**
+
+## 验证
+
+```bash
+ls -la ~/.agents/skills/superpowers
+```
+
+你应该看到一个符号链接（Windows 上为目录连接），指向你的 superpowers skills 目录。
+
+## 更新
+
+```bash
+cd ~/.codex/superpowers && git pull
+```
+
+Skills 通过符号链接即时更新。
+
+## 卸载
+
+```bash
+rm ~/.agents/skills/superpowers
+```
+
+可选：删除克隆的仓库：`rm -rf ~/.codex/superpowers`。

package/.cursor-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+  "name": "superpowers-zh",
+  "displayName": "Superpowers 中文版",
+  "description": "AI 编程超能力中文版：19 个 skills（14 翻译 + 5 中国特色原创）",
+  "version": "1.0.0",
+  "author": {
+    "name": "jnMetaCode",
+    "url": "https://github.com/jnMetaCode"
+  },
+  "homepage": "https://github.com/jnMetaCode/superpowers-zh",
+  "repository": "https://github.com/jnMetaCode/superpowers-zh",
+  "license": "MIT",
+  "keywords": ["skills", "tdd", "debugging", "chinese", "中文", "best-practices", "workflows"],
+  "skills": "./skills/",
+  "agents": "./agents/",
+  "commands": "./commands/",
+  "hooks": "./hooks/hooks-cursor.json"
+}

package/.opencode/INSTALL.md

@@ -0,0 +1,83 @@
+# 为 OpenCode 安装 Superpowers 中文版
+
+## 前置条件
+
+- 已安装 [OpenCode.ai](https://opencode.ai)
+
+## 安装步骤
+
+在你的 `opencode.json`（全局或项目级别）中将 superpowers-zh 添加到 `plugin` 数组：
+
+```json
+{
+  "plugin": ["superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git"]
+}
+```
+
+重启 OpenCode。完成——插件会自动安装并注册所有 skills。
+
+通过询问来验证："告诉我你的超能力"
+
+## 从旧版符号链接安装方式迁移
+
+如果你之前使用 `git clone` 和符号链接安装过 superpowers，请移除旧的配置：
+
+```bash
+# 移除旧的符号链接
+rm -f ~/.config/opencode/plugins/superpowers.js
+rm -rf ~/.config/opencode/skills/superpowers
+
+# 可选：移除克隆的仓库
+rm -rf ~/.config/opencode/superpowers
+
+# 如果你在 opencode.json 中为 superpowers 添加过 skills.paths，请将其移除
+```
+
+然后按照上面的安装步骤操作。
+
+## 使用方法
+
+使用 OpenCode 的原生 `skill` 工具：
+
+```
+use skill tool to list skills
+use skill tool to load superpowers/brainstorming
+```
+
+## 更新
+
+Superpowers 会在你重启 OpenCode 时自动更新。
+
+要固定到特定版本：
+
+```json
+{
+  "plugin": ["superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git#v1.0.0"]
+}
+```
+
+## 故障排除
+
+### 插件未加载
+
+1. 检查日志：`opencode run --print-logs "hello" 2>&1 | grep -i superpowers`
+2. 验证 `opencode.json` 中的插件配置
+3. 确保你运行的是最新版本的 OpenCode
+
+### Skills 未找到
+
+1. 使用 `skill` 工具列出已发现的内容
+2. 检查插件是否已加载（见上文）
+
+### 工具映射
+
+当 skills 引用 Claude Code 工具时：
+- `TodoWrite` → `todowrite`
+- `Task` 子代理 → `@mention` 语法
+- `Skill` 工具 → OpenCode 的原生 `skill` 工具
+- 文件操作 → 你的原生工具
+
+## 获取帮助
+
+- 报告问题：https://github.com/jnMetaCode/superpowers-zh/issues
+- 完整文档：https://github.com/jnMetaCode/superpowers-zh

package/.opencode/plugins/superpowers.js

@@ -0,0 +1,107 @@
+/**
+ * Superpowers plugin for OpenCode.ai
+ *
+ * Injects superpowers bootstrap context via system prompt transform.
+ * Auto-registers skills directory via config hook (no symlinks needed).
+ */
+
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Simple frontmatter extraction (avoid dependency on skills-core for bootstrap)
+const extractAndStripFrontmatter = (content) => {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) return { frontmatter: {}, content };
+
+  const frontmatterStr = match[1];
+  const body = match[2];
+  const frontmatter = {};
+
+  for (const line of frontmatterStr.split('\n')) {
+    const colonIdx = line.indexOf(':');
+    if (colonIdx > 0) {
+      const key = line.slice(0, colonIdx).trim();
+      const value = line.slice(colonIdx + 1).trim().replace(/^["']|["']$/g, '');
+      frontmatter[key] = value;
+    }
+  }
+
+  return { frontmatter, content: body };
+};
+
+// Normalize a path: trim whitespace, expand ~, resolve to absolute
+const normalizePath = (p, homeDir) => {
+  if (!p || typeof p !== 'string') return null;
+  let normalized = p.trim();
+  if (!normalized) return null;
+  if (normalized.startsWith('~/')) {
+    normalized = path.join(homeDir, normalized.slice(2));
+  } else if (normalized === '~') {
+    normalized = homeDir;
+  }
+  return path.resolve(normalized);
+};
+
+export const SuperpowersPlugin = async ({ client, directory }) => {
+  const homeDir = os.homedir();
+  const superpowersSkillsDir = path.resolve(__dirname, '../../skills');
+  const envConfigDir = normalizePath(process.env.OPENCODE_CONFIG_DIR, homeDir);
+  const configDir = envConfigDir || path.join(homeDir, '.config/opencode');
+
+  // Helper to generate bootstrap content
+  const getBootstrapContent = () => {
+    // Try to load using-superpowers skill
+    const skillPath = path.join(superpowersSkillsDir, 'using-superpowers', 'SKILL.md');
+    if (!fs.existsSync(skillPath)) return null;
+
+    const fullContent = fs.readFileSync(skillPath, 'utf8');
+    const { content } = extractAndStripFrontmatter(fullContent);
+
+    const toolMapping = `**Tool Mapping for OpenCode:**
+When skills reference tools you don't have, substitute OpenCode equivalents:
+- \`TodoWrite\` → \`todowrite\`
+- \`Task\` tool with subagents → Use OpenCode's subagent system (@mention)
+- \`Skill\` tool → OpenCode's native \`skill\` tool
+- \`Read\`, \`Write\`, \`Edit\`, \`Bash\` → Your native tools
+
+**Skills location:**
+Superpowers skills are in \`${configDir}/skills/superpowers/\`
+Use OpenCode's native \`skill\` tool to list and load skills.`;
+
+    return `<EXTREMELY_IMPORTANT>
+You have superpowers.
+
+**IMPORTANT: The using-superpowers skill content is included below. It is ALREADY LOADED - you are currently following it. Do NOT use the skill tool to load "using-superpowers" again - that would be redundant.**
+
+${content}
+
+${toolMapping}
+</EXTREMELY_IMPORTANT>`;
+  };
+
+  return {
+    // Inject skills path into live config so OpenCode discovers superpowers skills
+    // without requiring manual symlinks or config file edits.
+    // This works because Config.get() returns a cached singleton — modifications
+    // here are visible when skills are lazily discovered later.
+    config: async (config) => {
+      config.skills = config.skills || {};
+      config.skills.paths = config.skills.paths || [];
+      if (!config.skills.paths.includes(superpowersSkillsDir)) {
+        config.skills.paths.push(superpowersSkillsDir);
+      }
+    },
+
+    // Use system prompt transform to inject bootstrap (fixes #226 agent reset bug)
+    'experimental.chat.system.transform': async (_input, output) => {
+      const bootstrap = getBootstrapContent();
+      if (bootstrap) {
+        (output.system ||= []).push(bootstrap);
+      }
+    }
+  };
+};

package/GEMINI.md

@@ -0,0 +1,2 @@
+@./skills/using-superpowers/SKILL.md
+@./skills/using-superpowers/references/gemini-tools.md

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jnMetaCode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,153 @@
+# superpowers-zh（AI 编程超能力 · 中文版）
+
+🌐 **简体中文** | [English (upstream)](https://github.com/obra/superpowers)
+
+> **让你的 AI 编程助手真正会干活** — 从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
+
+Chinese community edition of [superpowers](https://github.com/obra/superpowers), including full translations and China-specific development skills.
+
+[![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/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)
+
+### 📊 项目规模
+
+| 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
+|:---:|:---:|:---:|
+| **14** | **5** | **Claude Code / Cursor / Codex / Gemini** |
+
+---
+
+## 这是什么？
+
+[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 编程 skills 框架（99k+ stars），为 Claude Code、Cursor 等 AI 编程工具提供**系统化的工作方法论**。
+
+**superpowers-zh** 在完整翻译的基础上，新增了面向中国开发者的特色 skills：
+
+### 翻译的 Skills（14 个）
+
+| Skill | 用途 |
+|-------|------|
+| **头脑风暴** (brainstorming) | 需求分析 → 设计规格，不写代码先想清楚 |
+| **编写计划** (writing-plans) | 把规格拆成可执行的实施步骤 |
+| **执行计划** (executing-plans) | 按计划逐步实施，每步验证 |
+| **测试驱动开发** (test-driven-development) | 严格 TDD：先写测试，再写代码 |
+| **系统化调试** (systematic-debugging) | 四阶段调试法：定位→分析→假设→修复 |
+| **请求代码审查** (requesting-code-review) | 派遣审查 agent 检查代码质量 |
+| **接收代码审查** (receiving-code-review) | 技术严谨地处理审查反馈，拒绝敷衍 |
+| **完成前验证** (verification-before-completion) | 证据先行——声称完成前必须跑验证 |
+| **派遣并行 Agent** (dispatching-parallel-agents) | 多任务并发执行 |
+| **子 Agent 驱动开发** (subagent-driven-development) | 每个任务一个 agent，两轮审查 |
+| **Git Worktree 使用** (using-git-worktrees) | 隔离式特性开发 |
+| **完成开发分支** (finishing-a-development-branch) | 合并/PR/保留/丢弃四选一 |
+| **编写 Skills** (writing-skills) | 创建新 skill 的方法论 |
+| **使用 Superpowers** (using-superpowers) | 元技能：如何调用和优先使用 skills |
+
+### 🇨🇳 中国特色 Skills（5 个）
+
+| Skill | 用途 | 上游有吗？ |
+|-------|------|:---:|
+| **中文代码审查** (chinese-code-review) | 符合国内团队文化的代码审查规范 | 无 |
+| **中文 Git 工作流** (chinese-git-workflow) | 适配 Gitee/Coding/极狐 GitLab | 无 |
+| **中文技术文档** (chinese-documentation) | 中文排版规范、中英混排、告别机翻味 | 无 |
+| **中文提交规范** (chinese-commit-conventions) | 适配国内团队的 commit message 规范 | 无 |
+| **MCP 服务器构建** (mcp-builder) | 构建生产级 MCP 工具，扩展 AI 能力边界 | 无 |
+
+---
+
+## 快速开始
+
+### 方式一：npm 安装（推荐）
+
+```bash
+cd /your/project
+npx superpowers-zh
+```
+
+### 方式二：手动安装
+
+```bash
+# 克隆仓库
+git clone https://github.com/jnMetaCode/superpowers-zh.git
+
+# 复制 skills 到你的项目
+cp -r superpowers-zh/skills /your/project/.claude/skills
+# 或
+cp -r superpowers-zh/skills /your/project/.cursor/skills
+```
+
+### 方式三：在 CLAUDE.md 中引用
+
+```markdown
+# CLAUDE.md
+
+请使用 superpowers-zh 的 skills 来指导你的工作流程。
+Skills 位于 ./skills/ 目录下。
+```
+
+---
+
+## 对比上游
+
+| 特性 | superpowers (英文) | superpowers-zh (中文) |
+|------|-------------------|----------------------|
+| Skills 数量 | 14 | **19**（14 翻译 + 5 原创） |
+| 语言 | 英文 | 中文（技术术语保留英文） |
+| 代码审查规范 | 西方直接风格 | 适配国内团队沟通文化 |
+| Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 |
+| Git 提交规范 | 无 | Conventional Commits 中文适配 |
+| 文档规范 | 英文 | 中文排版规范 + 中英混排 |
+| MCP 构建 | 无 | MCP 服务器构建方法论 |
+| 社区 | Discord | QQ 群 |
+
+---
+
+## 贡献
+
+欢迎参与！翻译改进、新增 skills、Bug 修复都可以。
+
+### 计划中的 Skills
+
+- [ ] DeepSeek/国产模型调优
+- [ ] Vue 生态 TDD
+- [ ] 微信小程序开发流程
+- [ ] 阿里巴巴 Java 开发规范
+- [ ] 合规检查（等保/个人信息保护法）
+- [ ] 国内云平台部署（阿里云/腾讯云/华为云）
+- [ ] 飞书/钉钉项目管理集成
+- [ ] 出海全栈开发（i18n + 多支付 + CDN 分流）
+
+欢迎认领或提出新想法！
+
+---
+
+## 社区交流
+
+| 群名 | 群号 | 加入方式 |
+|------|------|---------|
+| AI Agent 中文实践群 | **833585047** | [点击加入](https://qm.qq.com/q/x8kyqzlfDc) |
+
+---
+
+## 致谢
+
+- 原始英文版：[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 智能体专家团队）
+
+---
+
+## 许可证
+
+MIT License — 自由使用，商业或个人均可。
+
+---
+
+<div align="center">
+
+**AI 编程超能力：让你的 AI 助手真正会干活**
+
+[Star 本项目](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [贡献代码](https://github.com/jnMetaCode/superpowers-zh/pulls)
+
+</div>

package/agents/code-reviewer.md

@@ -0,0 +1,48 @@
+---
+name: code-reviewer
+description: |
+  当一个主要项目步骤完成并需要根据原始计划和编码标准进行审查时使用此智能体。示例：<example>Context: 用户正在创建一个代码审查智能体，应在逻辑代码块编写完成后调用。user: "我已经按照计划第 3 步完成了用户认证系统的实现" assistant: "干得好！让我使用 code-reviewer 智能体来根据我们的计划和编码标准审查实现" <commentary>由于一个主要项目步骤已完成，使用 code-reviewer 智能体来验证工作是否符合计划并识别任何问题。</commentary></example> <example>Context: 用户完成了一个重要功能的实现。user: "任务管理系统的 API 端点现在完成了——这涵盖了我们架构文档中的第 2 步" assistant: "很好！让我用 code-reviewer 智能体检查这个实现，确保它符合我们的计划并遵循最佳实践" <commentary>规划文档中的一个编号步骤已完成，所以应该用 code-reviewer 智能体审查工作。</commentary></example>
+model: inherit
+---
+
+你是一位高级代码审查员，精通软件架构、设计模式和最佳实践。你的角色是根据原始计划审查已完成的项目步骤，确保代码质量标准得到满足。
+
+审查已完成的工作时，你将：
+
+1. **计划对齐分析**：
+   - 将实现与原始规划文档或步骤描述进行对比
+   - 识别与计划的方案、架构或需求的任何偏差
+   - 评估偏差是合理的改进还是有问题的偏离
+   - 验证所有计划的功能是否都已实现
+
+2. **代码质量评估**：
+   - 审查代码是否遵循已建立的模式和约定
+   - 检查错误处理、类型安全和防御性编程是否恰当
+   - 评估代码组织、命名约定和可维护性
+   - 评估测试覆盖率和测试实现的质量
+   - 寻找潜在的安全漏洞或性能问题
+
+3. **架构和设计审查**：
+   - 确保实现遵循 SOLID 原则和已建立的架构模式
+   - 检查关注点分离和松耦合是否恰当
+   - 验证代码与现有系统的集成是否良好
+   - 评估可扩展性和可延展性的考虑
+
+4. **文档和标准**：
+   - 验证代码包含适当的注释和文档
+   - 检查文件头、函数文档和内联注释是否存在且准确
+   - 确保遵循项目特定的编码标准和约定
+
+5. **问题识别和建议**：
+   - 将问题明确分类为：关键（必须修复）、重要（应该修复）或建议（锦上添花）
+   - 对每个问题提供具体示例和可操作的建议
+   - 识别计划偏差时，解释它们是有问题的还是有益的
+   - 在有帮助时提供带有代码示例的具体改进建议
+
+6. **沟通协议**：
+   - 如果发现与计划的重大偏差，请编码智能体审查并确认更改
+   - 如果识别出原始计划本身的问题，建议更新计划
+   - 对于实现问题，提供明确的修复指导
+   - 在指出问题之前始终先肯定做得好的地方
+
+你的输出应该是结构化的、可操作的，聚焦于帮助保持高代码质量同时确保项目目标的达成。要全面但简洁，始终提供建设性的反馈，帮助改进当前实现和未来的开发实践。

package/bin/superpowers-zh.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, cpSync, readdirSync } from 'fs';
+import { resolve, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SKILLS_SRC = resolve(__dirname, '..', 'skills');
+const AGENTS_SRC = resolve(__dirname, '..', 'agents');
+const PROJECT_DIR = process.cwd();
+
+const TARGETS = [
+  { name: 'Claude Code', dir: '.claude/skills', type: 'skills' },
+  { name: 'Cursor',      dir: '.cursor/skills', type: 'skills' },
+  { name: 'Codex CLI',   dir: '.codex/skills',  type: 'skills' },
+];
+
+function countFiles(dir) {
+  if (!existsSync(dir)) return 0;
+  let count = 0;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) count++;
+  }
+  return count;
+}
+
+function install() {
+  console.log('\n  superpowers-zh — AI 编程超能力中文版\n');
+  console.log(`  源: ${countFiles(SKILLS_SRC)} 个 skills`);
+  console.log(`  目标项目: ${PROJECT_DIR}\n`);
+
+  let installed = 0;
+
+  for (const target of TARGETS) {
+    const configDir = resolve(PROJECT_DIR, target.dir.split('/')[0]);
+    // 只安装到已存在配置目录的工具，或者全部安装
+    const dest = resolve(PROJECT_DIR, target.dir);
+
+    if (existsSync(configDir) || installed === 0) {
+      mkdirSync(dest, { recursive: true });
+      cpSync(SKILLS_SRC, dest, { recursive: true });
+      const count = countFiles(dest);
+      console.log(`  ✅ ${target.name}: ${count} 个 skills -> ${dest}`);
+      installed++;
+
+      // 为 Claude Code 额外安装 agents
+      if (target.name === 'Claude Code' && existsSync(AGENTS_SRC)) {
+        const agentsDest = resolve(PROJECT_DIR, '.claude', 'agents');
+        mkdirSync(agentsDest, { recursive: true });
+        cpSync(AGENTS_SRC, agentsDest, { recursive: true });
+      }
+    }
+  }
+
+  if (installed === 0) {
+    // 默认安装到 .claude/skills
+    const dest = resolve(PROJECT_DIR, '.claude', 'skills');
+    mkdirSync(dest, { recursive: true });
+    cpSync(SKILLS_SRC, dest, { recursive: true });
+    console.log(`  ✅ 默认安装: ${countFiles(dest)} 个 skills -> ${dest}`);
+  }
+
+  console.log('\n  安装完成！重启你的 AI 编程工具即可生效。\n');
+}
+
+install();

package/commands/brainstorm.md

@@ -0,0 +1,5 @@
+---
+description: "已弃用 - 请改用 superpowers:brainstorming 技能"
+---
+
+告诉你的搭档这个命令已弃用，将在下个主要版本中移除。他们应该让你使用"superpowers brainstorming"技能。

package/commands/execute-plan.md

@@ -0,0 +1,5 @@
+---
+description: "已弃用 - 请改用 superpowers:executing-plans 技能"
+---
+
+告诉你的搭档这个命令已弃用，将在下个主要版本中移除。他们应该让你使用"superpowers executing-plans"技能。

package/commands/write-plan.md

@@ -0,0 +1,5 @@
+---
+description: "已弃用 - 请改用 superpowers:writing-plans 技能"
+---
+
+告诉你的搭档这个命令已弃用，将在下个主要版本中移除。他们应该让你使用"superpowers writing-plans"技能。

package/gemini-extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "superpowers",
+  "description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
+  "version": "5.0.0",
+  "contextFileName": "GEMINI.md"
+}

package/hooks/hooks-cursor.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "command": "./hooks/session-start"
+      }
+    ]
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}