superpowers-zh 1.0.0 → 1.1.1

package/README.md

@@ -7,6 +7,7 @@
 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)
+[![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)
@@ -15,7 +16,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers),
 
 | 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
 |:---:|:---:|:---:|
-| **14** | **5** | **Claude Code / Cursor / Codex / Gemini** |
+| **14** | **5** | **Claude Code / Cursor / Codex / Kiro / Trae / Antigravity / VS Code / Gemini** |
 
 ---
 
@@ -71,20 +72,29 @@ npx superpowers-zh
 # 克隆仓库
 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
+# 复制 skills 到你的项目（选择你使用的工具）
+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/.trae/rules         # Trae
+cp -r superpowers-zh/skills /your/project/.antigravity        # Antigravity
 ```
 
-### 方式三：在 CLAUDE.md 中引用
+### 方式三：在配置文件中引用
 
-```markdown
-# CLAUDE.md
+根据你使用的工具，在对应配置文件中引用 skills：
 
-请使用 superpowers-zh 的 skills 来指导你的工作流程。
-Skills 位于 ./skills/ 目录下。
-```
+| 工具 | 配置文件 | 说明 |
+|------|---------|------|
+| Claude Code | `CLAUDE.md` | 项目根目录 |
+| Kiro | `.kiro/steering/*.md` | 支持 always/globs/手动三种模式 |
+| Trae | `.trae/rules/project_rules.md` | 项目级规则 |
+| Antigravity | `GEMINI.md` 或 `AGENTS.md` | 项目根目录 |
+| VS Code | `.github/copilot-instructions.md` | Copilot 自定义指令 |
+| Cursor | `.cursor/rules/*.md` | 项目级规则目录 |
+
+> **详细安装指南**：[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)
 
 ---
 
@@ -107,18 +117,15 @@ Skills 位于 ./skills/ 目录下。
 
 欢迎参与！翻译改进、新增 skills、Bug 修复都可以。
 
-### 计划中的 Skills
+### 贡献方向
+
+我们只接收符合 superpowers 定位的 skill——**AI 编程工作流方法论**。好的 skill 应该：
 
-- [ ] DeepSeek/国产模型调优
-- [ ] Vue 生态 TDD
-- [ ] 微信小程序开发流程
-- [ ] 阿里巴巴 Java 开发规范
-- [ ] 合规检查（等保/个人信息保护法）
-- [ ] 国内云平台部署（阿里云/腾讯云/华为云）
-- [ ] 飞书/钉钉项目管理集成
-- [ ] 出海全栈开发（i18n + 多支付 + CDN 分流）
+- 教 AI 助手**怎么干活**，而不是某个框架/语言的教程
+- 解决上游英文版不覆盖的**中国开发者痛点**
+- 有明确的步骤、检查清单、示例，AI 加载后能直接执行
 
-欢迎认领或提出新想法！
+欢迎提 Issue 讨论你的想法！
 
 ---
 

package/bin/superpowers-zh.js

@@ -1,49 +1,75 @@
 #!/usr/bin/env node
 
-import { existsSync, mkdirSync, cpSync, readdirSync } from 'fs';
-import { resolve, dirname, join } from 'path';
+import { existsSync, mkdirSync, cpSync, readdirSync, readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf8'));
 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' },
+  { name: 'Claude Code',   dir: '.claude/skills',           detect: '.claude' },
+  { 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: 'Antigravity',   dir: '.antigravity/skills',       detect: '.antigravity' },
+  { name: 'VS Code',       dir: '.github/superpowers',       detect: '.github/copilot-instructions.md' },
 ];
 
-function countFiles(dir) {
+function countDirs(dir) {
   if (!existsSync(dir)) return 0;
-  let count = 0;
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    if (entry.isDirectory()) count++;
-  }
-  return count;
+  return readdirSync(dir, { withFileTypes: true }).filter(e => e.isDirectory()).length;
+}
+
+function showHelp() {
+  console.log(`
+  superpowers-zh v${PKG.version} — AI 编程超能力中文版
+
+  用法：
+    npx superpowers-zh          安装 skills（及 agents）到当前项目
+    npx superpowers-zh --help   显示帮助
+    npx superpowers-zh --version 显示版本
+
+  说明：
+    自动检测当前项目使用的 AI 编程工具：
+    Claude Code / Cursor / Codex / Kiro / Trae / Antigravity / VS Code
+    将 ${countDirs(SKILLS_SRC)} 个 skills 安装到对应目录。
+    Claude Code 还会额外安装 agents 到 .claude/agents/。
+    如果未检测到任何工具，默认安装到 .claude/skills/ 和 .claude/agents/。
+
+  项目：https://github.com/jnMetaCode/superpowers-zh
+`);
 }
 
 function install() {
-  console.log('\n  superpowers-zh — AI 编程超能力中文版\n');
-  console.log(`  源: ${countFiles(SKILLS_SRC)} 个 skills`);
+ 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`);
 
   let installed = 0;
 
   for (const target of TARGETS) {
-    const configDir = resolve(PROJECT_DIR, target.dir.split('/')[0]);
-    // 只安装到已存在配置目录的工具，或者全部安装
+    const detectPath = resolve(PROJECT_DIR, target.detect);
     const dest = resolve(PROJECT_DIR, target.dir);
 
-    if (existsSync(configDir) || installed === 0) {
+    if (existsSync(detectPath)) {
       mkdirSync(dest, { recursive: true });
       cpSync(SKILLS_SRC, dest, { recursive: true });
-      const count = countFiles(dest);
+      const count = countDirs(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 });
@@ -53,14 +79,35 @@ function install() {
   }
 
   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(`  ✅ 默认安装: ${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);
+ }
 }
 
-install();
+const arg = process.argv[2];
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superpowers-zh",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "AI 编程超能力中文版 — 14 个翻译 + 5 个中国特色原创 skills",
   "type": "module",
   "main": ".opencode/plugins/superpowers.js",
@@ -28,6 +28,11 @@
     "cursor",
     "codex",
     "gemini",
+    "kiro",
+    "trae",
+    "antigravity",
+    "vscode",
+    "copilot",
     "ai-coding",
     "skills",
     "chinese",