superpowers-zh 1.3.0 → 1.6.0

package/bin/superpowers-zh.js

@@ -53,7 +53,7 @@ const TARGETS = [
   { name: 'Kiro',          dir: '.kiro/steering',            detect: '.kiro' },
   { name: 'DeerFlow',      dir: 'skills/custom',             detect: 'deer_flow' },
   { name: 'Trae',          dir: '.trae/skills',              detect: '.trae' },
-  { name: 'Antigravity',   dir: '.antigravity/skills',       detect: '.antigravity' },
+  { name: 'Antigravity',   dir: '.agents/skills',            detect: '.agents' },
   { name: 'VS Code',       dir: '.github/superpowers',       detect: '.github/copilot-instructions.md' },
   { name: 'OpenClaw',      dir: 'skills',                     detect: '.openclaw' },
   { name: 'Windsurf',      dir: '.windsurf/skills',          detect: '.windsurf' },
@@ -63,6 +63,7 @@ const TARGETS = [
   { name: 'Qwen Code',     dir: '.qwen/skills',             detect: '.qwen' },
   { name: 'Hermes Agent',  dir: '.hermes/skills',            detect: ['.hermes', 'HERMES.md', '.hermes.md'] },
   { name: 'Claw Code',     dir: '.claw/skills',              detect: ['.claw', 'CLAW.md'] },
+  { name: 'Qoder',         dir: '.qoder/skills',             detect: '.qoder' },
 ];
 
 function countDirs(dir) {
@@ -141,6 +142,51 @@ ${skillTable}
   console.log(`  ✅ Trae: bootstrap rule -> ${rulePath}`);
 }
 
+function generateQoderBootstrap(projectDir) {
+  const rulesDir = resolve(projectDir, '.qoder', 'rules');
+  mkdirSync(rulesDir, { recursive: true });
+
+  const skillEntries = scanSkillEntries(SKILLS_SRC);
+  const skillTable = skillEntries.map(s => `| ${s.name} | ${s.desc} |`).join('\n');
+
+  // Qoder rules schema（来源：社区实际样本，docs.qoder.com/zh/user-guide/rules 没公开）
+  // trigger: always_on  → "始终生效"，适用于所有智能会话和内联对话
+  // trigger: model_decision + description: ...  → 模型按描述自主决定
+  // trigger: manual  → 仅 @rule 手动触发
+  const rule = `---
+trigger: always_on
+alwaysApply: true
+---
+
+# Superpowers-ZH 中文增强版
+
+你已加载 superpowers-zh 技能框架（${skillEntries.length} 个 skills）。
+
+## 核心规则
+
+1. **收到任务时，先检查是否有匹配的 skill** — 哪怕只有 1% 的可能性也要检查
+2. **设计先于编码** — 收到功能需求时，先用 brainstorming skill 做需求分析
+3. **测试先于实现** — 写代码前先写测试（TDD）
+4. **验证先于完成** — 声称完成前必须运行验证命令
+
+## 可用 Skills
+
+Skills 位于 \`.qoder/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。
+
+| Skill | 触发条件 |
+|-------|---------|
+${skillTable}
+
+## 如何使用
+
+当任务匹配某个 skill 的触发条件时，读取对应的 \`.qoder/skills/<skill-name>/SKILL.md\` 并严格遵循其流程。也可输入 \`/<skill-name>\` 显式调用。
+`;
+
+  const rulePath = resolve(rulesDir, 'superpowers-zh.md');
+  writeFileSync(rulePath, rule, 'utf8');
+  console.log(`  ✅ Qoder: bootstrap rule -> ${rulePath}`);
+}
+
 function generateAntigravityBootstrap(projectDir) {
   const skillEntries = scanSkillEntries(SKILLS_SRC);
   const skillList = skillEntries.map(s => `- **${s.name}**: ${s.desc}`).join('\n');
@@ -158,17 +204,17 @@ function generateAntigravityBootstrap(projectDir) {
 
 ## 可用 Skills
 
-Skills 位于 \`.antigravity/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。
+Skills 位于 \`.agents/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。
 
 ${skillList}
 
 ## 如何使用
 
-当任务匹配某个 skill 时，读取对应的 \`.antigravity/skills/<skill-name>/SKILL.md\` 并严格遵循其流程。
+当任务匹配某个 skill 时，读取对应的 \`.agents/skills/<skill-name>/SKILL.md\` 并严格遵循其流程。
 `;
 
-  // 写入 .antigravity/rules.md（不覆盖用户已有的 GEMINI.md / AGENTS.md）
-  const rulePath = resolve(projectDir, '.antigravity', 'rules.md');
+  // 写入 .agents/rules.md（不覆盖用户已有的 GEMINI.md / AGENTS.md）
+  const rulePath = resolve(projectDir, '.agents', 'rules.md');
   writeFileSync(rulePath, content, 'utf8');
   console.log(`  ✅ Antigravity: bootstrap rule -> ${rulePath}`);
 }
@@ -385,6 +431,7 @@ const TOOL_ALIASES = {
   'claw':         'Claw Code',
   'claw-code':    'Claw Code',
   'clawcode':     'Claw Code',
+  'qoder':        'Qoder',
 };
 
 function showHelp() {
@@ -437,6 +484,10 @@ function installForTarget(target) {
     generateTraeBootstrapRule(PROJECT_DIR);
   }
 
+  if (target.name === 'Qoder') {
+    generateQoderBootstrap(PROJECT_DIR);
+  }
+
   if (target.name === 'Antigravity') {
     generateAntigravityBootstrap(PROJECT_DIR);
   }
@@ -469,7 +520,8 @@ function isHomeDir(p) {
 // 卸载支持：完整删除的 bootstrap 文件、需要清理段落的 bootstrap 文件
 const BOOTSTRAP_DELETE = [
   '.trae/rules/superpowers-zh.md',
-  '.antigravity/rules.md',
+  '.qoder/rules/superpowers-zh.md',
+  '.agents/rules.md',
 ];
 const BOOTSTRAP_CLEAN_SECTION = [
   'CLAUDE.md',
@@ -696,18 +748,17 @@ function install(forceToolName, force) {
   }
 
   if (installed === 0) {
-    console.log('  ⚠️  未检测到任何已知的 AI 编程工具。\n');
-    console.log('  如果你使用的是 Cursor、Trae 等工具，请用 --tool 指定：');
-    console.log('    npx superpowers-zh --tool cursor');
-    console.log('    npx superpowers-zh --tool trae\n');
-    console.log('  现在将默认安装到 .claude/skills/（兼容 Claude Code / OpenClaw）\n');
-
-    const dest = resolve(PROJECT_DIR, '.claude', 'skills');
-    mkdirSync(dest, { recursive: true });
-    copyDirSync(SKILLS_SRC, dest);
-    console.log(`  ✅ 默认安装: ${countDirs(dest)} 个 skills -> ${dest}`);
-
-    generateClaudeCodeBootstrap(PROJECT_DIR);
+    // 检测落空时不再静默装 Claude Code —— 否则 Antigravity / Trae 等
+    // 不会在项目里留下检测目录的工具，会被误装成 Claude（见 issue #33）。
+    // 改为明确报错并教用户用 --tool 显式指定。
+    console.log('  ⚠️  未在当前目录检测到任何已知 AI 编程工具的项目标记。\n');
+    console.log('  为避免装错工具，未做任何安装。请用 --tool 显式指定你的工具，例如：\n');
+    console.log('    npx superpowers-zh --tool claude        # Claude Code / Copilot CLI');
+    console.log('    npx superpowers-zh --tool antigravity   # Google Antigravity');
+    console.log('    npx superpowers-zh --tool trae          # Trae');
+    console.log('    npx superpowers-zh --tool cursor        # Cursor\n');
+    console.log(`  全部可用别名：${Object.keys(TOOL_ALIASES).join(', ')}\n`);
+    process.exit(1);
   }
 
   console.log('\n  安装完成！重启你的 AI 编程工具即可生效。\n');

package/docs/README.antigravity.md

@@ -9,14 +9,14 @@ cd /your/project
 npx superpowers-zh
 ```
 
-安装脚本会自动检测 `.antigravity/` 目录并将 skills 复制到该目录。
+安装脚本会自动检测 `.agents/` 目录并将 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/
+mkdir -p /your/project/.agents/skills
+cp -r superpowers-zh/skills/* /your/project/.agents/skills/
 ```
 
 ## 工作原理
@@ -27,7 +27,7 @@ Antigravity 支持多种规则文件格式：
 |------|--------|------|
 | `GEMINI.md` | 最高 | Antigravity 专属规则 |
 | `AGENTS.md` | 中 | 通用规则（Antigravity、Cursor、Claude Code 共享） |
-| `.antigravity/rules.md` | 中 | 项目级规则目录 |
+| `.agents/rules.md` | 中 | 项目级规则目录 |
 | `CLAUDE.md` | 低 | 也会被自动读取 |
 
 ### 推荐配置方式
@@ -37,10 +37,10 @@ Antigravity 支持多种规则文件格式：
 ```markdown
 # GEMINI.md
 
-使用 .antigravity/ 目录下的 superpowers skills 来指导工作流程。
+使用 .agents/ 目录下的 superpowers skills 来指导工作流程。
 优先使用 brainstorming（头脑风暴）开始新任务。
 
-Skills 列表参见 .antigravity/ 目录。
+Skills 列表参见 .agents/ 目录。
 ```
 
 **方式二**：在 `AGENTS.md` 中引用（多工具共享）：
@@ -49,7 +49,7 @@ Skills 列表参见 .antigravity/ 目录。
 # AGENTS.md
 
 本项目使用 superpowers-zh skills 框架。
-Skills 位于 .antigravity/（Antigravity）或 .claude/skills/（Claude Code）目录下。
+Skills 位于 .agents/（Antigravity）或 .claude/skills/（Claude Code）目录下。
 ```
 
 ### 工具映射

package/docs/README.kimi.md

@@ -0,0 +1,86 @@
+# Superpowers 中文版 · Kimi Code 指南
+
+在 [Kimi Code](https://github.com/MoonshotAI/kimi-code) 上使用 superpowers-zh 的完整说明。
+
+## 安装
+
+superpowers-zh 通过 Kimi Code 的插件清单 `.kimi-plugin/plugin.json` 集成，**直接指向仓库现有的 `skills/` 目录**——不复制 skill、不建 symlink、不装 hook、无任何运行时依赖。
+
+打开插件管理器：
+
+```text
+/plugins
+```
+
+如果 Kimi 插件市场已收录，进入 `Marketplace` > `Superpowers 中文版` 安装即可。
+
+也可以直接从本仓库安装：
+
+```text
+/plugins install https://github.com/jnMetaCode/superpowers-zh
+```
+
+如需验证尚未发布的改动，显式指定分支：
+
+```text
+/plugins install https://github.com/jnMetaCode/superpowers-zh/tree/main
+```
+
+Kimi Code 在**新会话**才会应用插件变更。安装、更新、启用、禁用或重载插件后，用 `/new` 开一个新会话。
+
+## 工作原理
+
+Kimi 插件清单位于 `.kimi-plugin/plugin.json`，做三件事：
+
+1. 把 Kimi Code 指向仓库现有的 `skills/` 目录；
+2. 通过 `sessionStart.skill` 在会话开始时加载 `using-superpowers`（这是让 skill 在恰当时机自动触发的关键）；
+3. 通过 `skillInstructions` 提供 Kimi 专属的工具映射。
+
+## 工具映射
+
+skill 内容描述的是「动作」而非写死某个运行时的工具名。在 Kimi Code 上它们对应到：
+
+- 「向用户提问」/「问澄清问题」/「给出多选项」→ `AskUserQuestion`
+- 「创建待办」/「在待办清单中标记完成」→ `TodoList`
+- 「分派子智能体」/「Task tool (general-purpose)」→ `Agent`（用 Kimi 的 subagent 类型，如 `coder`/`explore`/`plan`，**不要**传 `general-purpose`）
+- 「调用某个 skill」→ Kimi Code 原生 `Skill` 工具
+- 「读文件」/「写文件」/「改文件」→ `Read` / `Write` / `Edit`
+- 「跑 shell 命令」→ `Bash`
+- 「搜索文件内容」→ `Grep`
+- 「按路径/模式找文件」→ `Glob`
+- 「抓取 URL」→ `FetchURL`
+- 「联网搜索」→ `WebSearch`
+
+完整映射写在清单的 `skillInstructions` 字段里，由 Kimi 在运行时读取。
+
+## 更新
+
+用 Kimi Code 的插件管理器：
+
+```text
+/plugins
+```
+
+选中 Superpowers 中文版更新，更新后用 `/new` 开新会话。
+
+## 排错
+
+### 插件没加载
+
+1. 跑 `/plugins info superpowers-zh` 看诊断信息；
+2. 确认插件已启用；
+3. 安装或更新后用 `/new` 开新会话。
+
+### 直接 GitHub 安装装到了旧版本
+
+对于裸仓库 URL，Kimi Code 会装最新的 GitHub release（若存在）。要在下一个 release 前测试未发布的改动，显式指定分支：
+
+```text
+/plugins install https://github.com/jnMetaCode/superpowers-zh/tree/main
+```
+
+### skill 不触发
+
+1. 用 `/plugins info superpowers-zh` 确认插件已启用；
+2. 用 `/new` 开新会话；
+3. 试验收提示词：`我们来做个 react todo list`。集成正常的话，会在写任何代码之前先加载 `brainstorming`。

package/docs/README.openclaw.md

@@ -62,11 +62,14 @@ OpenClaw 与 Claude Code 使用相同的工具名称，skills 无需额外适配
 
 ## 使用
 
-安装完成后重启 OpenClaw，所有 skills 会自动生效。你可以：
+安装完成后重启 OpenClaw，所有 skills 会自动生效。AI 会按任务上下文自动调用对应 skill：
 
-- 输入 `/brainstorming` 开始头脑风暴
-- 输入 `/commit` 使用中文提交规范
-- 在任何编码任务中，skills 会被自动调用
+- 新任务 / 新功能 → `brainstorming`（头脑风暴）
+- 写 commit message → `chinese-commit-conventions`（中文 commit 规范）
+- 调试问题 → `systematic-debugging`
+- 完成任务后 → `requesting-code-review`（请求代码审查）
+
+无需手动 slash command 触发 —— AI 通过 skill frontmatter 的 `description` 字段自主选择匹配的 skill。如果想强制触发某个 skill，直接在指令里点名："用 brainstorming 帮我想一下 X 怎么做"。
 
 ## 全局 Skills
 

package/docs/README.pi.md

@@ -0,0 +1,54 @@
+# Superpowers 中文版 · Pi 指南
+
+在 [Pi](https://github.com/earendil-works/pi)（oh-my-pi）上使用 superpowers-zh 的完整说明。
+
+## 安装
+
+superpowers-zh 通过 Pi 的扩展机制集成，**直接指向仓库现有的 `skills/` 目录**——不复制 skill、不建 symlink、无额外运行时依赖。
+
+集成由 `package.json` 里的 `pi` 字段声明：
+
+```json
+"pi": {
+  "skills": ["./skills"],
+  "extensions": ["./.pi/extensions/superpowers.ts"]
+}
+```
+
+并带 `pi-package` keyword，便于 Pi 发现这是一个 Pi 包。
+
+按 Pi 的包安装方式安装 `superpowers-zh`（参考 Pi 文档的包管理命令），Pi 会读取上述 `pi` 配置，挂载 `skills/` 并加载 `.pi/extensions/superpowers.ts` 扩展。
+
+## 工作原理
+
+`.pi/extensions/superpowers.ts` 注册了 Pi 的生命周期钩子：
+
+1. **`resources_discover`** — 把仓库的 `skills/` 目录贡献给 Pi 的技能系统；
+2. **`session_start` / `session_compact`** — 标记需要重新注入 bootstrap；
+3. **`context`** — 在会话上下文中注入 `using-superpowers` 的内容（去除 frontmatter）+ Pi 工具映射，作为「You have superpowers」bootstrap，让 skill 在恰当时机被遵循；
+4. **`agent_end`** — 一轮结束后停止重复注入。
+
+注入带有唯一标记，已存在时不会重复注入；并且会插入到 compaction summary 之后，避免被压缩流程吞掉。
+
+## 工具映射
+
+Pi 有原生技能系统，但**不暴露** `Skill` 工具。skill 内容描述「动作」，在 Pi 上对应到小写工具：
+
+- 「调用某个 skill」→ Pi 原生技能：用 `read` 加载对应 `SKILL.md`，或由人类显式 `/skill:name`
+- 「读/写/改文件」→ `read` / `write` / `edit`
+- 「跑 shell 命令」→ `bash`
+- 「搜索文件内容」→ `grep`，「按名找文件」→ `find`，「列目录」→ `ls`
+- 「分派子智能体」→ 若装了 `pi-subagents` 的 `subagent` 工具则用之；没有则在本会话内完成或说明能力缺失，**不要**臆造 `Task` 调用
+- 「待办清单」→ 若装了 todo/task 工具则用之；否则用 plan 文件或仓库内 `TODO.md` 跟踪；旧的 `TodoWrite` 引用按此处理
+
+完整映射见 [`skills/using-superpowers/references/pi-tools.md`](../skills/using-superpowers/references/pi-tools.md)，扩展也会把同样的映射注入会话。
+
+## 验证
+
+```bash
+bash tests/pi/run-tests.sh
+```
+
+该测试动态加载扩展并校验：声明了 `pi` 包配置、注册了正确的生命周期钩子（且无 pre-compaction 注入）、`resources_discover` 贡献了 `skills/` 目录、`session_start` 注入了「You have superpowers」+「Pi tool mapping」、pi-tools 参考文档存在。
+
+> 注：扩展是 TypeScript（仅 `import type`，运行时无类型依赖）。Node 22.6–23.5 需 `--experimental-strip-types`（run-tests.sh 已带），23.6+ 默认支持。

package/docs/README.qoder.md

@@ -0,0 +1,95 @@
+# Superpowers 中文版 — Qoder 安装指南
+
+在 [Qoder](https://qoder.com)（阿里推出的 AI IDE）中使用 superpowers-zh 的完整指南。
+
+## 自动安装
+
+```bash
+cd /your/project
+npx superpowers-zh
+```
+
+安装脚本会自动检测 `.qoder/` 目录并：
+
+1. 把 20 个 skills 复制到 `.qoder/skills/<name>/SKILL.md`
+2. 生成一个**始终生效**的 bootstrap rule `.qoder/rules/superpowers-zh.md`（`trigger: always_on`），让 Qoder 每个会话都加载核心规则与 skill 索引
+
+如果项目目录里还没有 `.qoder/`，可以显式指定：
+
+```bash
+npx superpowers-zh --tool qoder
+```
+
+## 手动安装
+
+```bash
+git clone https://github.com/jnMetaCode/superpowers-zh.git
+cp -r superpowers-zh/skills /your/project/.qoder/skills
+```
+
+或全局安装（对所有项目生效）：
+
+```bash
+cp -r superpowers-zh/skills ~/.qoder/skills
+```
+
+## Skill 加载优先级
+
+| 位置 | 优先级 | 说明 |
+|------|--------|------|
+| `.qoder/skills/` | 最高 | 项目级，仅当前项目 |
+| `~/.qoder/skills/` | 中 | 用户级，所有项目共享 |
+
+> 同名 skill 项目级覆盖用户级。
+
+## 使用
+
+1. 安装完成后**重启 Qoder**
+2. 在对话框输入 `/` 即可看到已加载的 skills 列表
+3. bootstrap rule（`.qoder/rules/superpowers-zh.md`）会被 Qoder 识别为"始终生效"，每个会话自动加载核心规则
+4. Qoder 还会根据 skill 的 `description` 自动判断何时调用；也可输入 `/<skill-name>` 手动触发
+
+> Qoder Rules schema（`trigger: always_on` / `model_decision` / `manual`）来自社区实际样本，官方文档（docs.qoder.com/zh/user-guide/rules）目前只公开 UI 配置流程未公开 frontmatter schema。如果 Qoder 后续改了 schema，rule 文件可能需要打开 Qoder Settings → Rules 重新选择类型。
+
+## 工具映射说明
+
+skills 中引用的 Claude Code 工具名称（`Read` / `Write` / `Edit` / `Bash` / `Grep` / `Glob` / `WebFetch` / `WebSearch` 等）在 Qoder 中**同名对应**，无需额外映射。
+
+少数差异：
+
+| Claude Code | Qoder 等价 |
+|-------------|-----------|
+| `EnterPlanMode` / `ExitPlanMode` | `EnterSpecMode` / `ExitSpecMode` |
+| `Task`（子 agent） | `Task`（支持 `explore-agent` / `plan-agent` / `qoder-guide` 等 agent 类型）|
+| `TodoWrite` | `TodoWrite` |
+
+> Skill 是工作方法论，不是工具实现 —— 即使工具名略有差异，模型也会自动选用最近似的 Qoder 工具完成。无需为 Qoder 重写 skill。
+
+## 故障排查
+
+### 装好了但 `/` 看不到 skills
+
+1. 确认 `.qoder/skills/<skill-name>/SKILL.md` 文件存在
+2. 确认 `SKILL.md` 文件的 frontmatter 完整（`name` + `description`，`description` 不超过 1024 字符）
+3. **必须重启 Qoder** —— 新装的 skill 不会热加载
+
+### skill 不被自动调用
+
+Qoder 按 description 文本匹配用户意图来决定何时调用 skill。如果某个 skill 自动调用不可靠，可在对话中显式输入 `/<skill-name>` 手动触发。
+
+中国原创的 4 个 `chinese-*` skill 本身就是**手动触发**设计（避免污染上游 skill 的自动调度），需要显式 `/chinese-code-review` / `/chinese-commit-conventions` 等。
+
+## 卸载
+
+```bash
+cd /your/project
+npx superpowers-zh --uninstall
+```
+
+会移除 `.qoder/skills/` 目录下所有 superpowers-zh 装的 skill 文件夹（保留你自己写的）。
+
+## 获取帮助
+
+- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
+- 项目主页：https://github.com/jnMetaCode/superpowers-zh
+- Qoder 官方文档：https://docs.qoder.com/zh/extensions/skills

package/docs/README.trae.md

@@ -9,16 +9,18 @@ cd /your/project
 npx superpowers-zh
 ```
 
-安装脚本会自动检测 `.trae/` 目录并将 skills 复制到 `.trae/rules/`。
+安装脚本会自动检测 `.trae/` 目录，将各 skill 完整复制到 `.trae/skills/`（含 `SKILL.md` 及其 `scripts/` 等附属文件），并在 `.trae/rules/superpowers-zh.md` 生成一份 bootstrap 规则用于自动触发。
 
 ## 手动安装
 
 ```bash
 git clone https://github.com/jnMetaCode/superpowers-zh.git
-mkdir -p /your/project/.trae/rules
-cp -r superpowers-zh/skills/* /your/project/.trae/rules/
+mkdir -p /your/project/.trae/skills
+cp -r superpowers-zh/skills/* /your/project/.trae/skills/
 ```
 
+> 手动复制只会放好 skill 文件，不会生成 `.trae/rules/` 下的 bootstrap 自动触发规则。建议优先用上面的 `npx superpowers-zh`，否则需要在对话里手动点名 skill 才会激活。
+
 ## 工作原理
 
 Trae 使用 `.rules` 机制管理 AI 行为：
@@ -32,7 +34,7 @@ Trae 使用 `.rules` 机制管理 AI 行为：
 
 ### Skills 适配
 
-superpowers-zh 的 SKILL.md 文件可以直接作为 Trae 的 rules 使用。Trae 会在初始化时加载 `.trae/rules/` 下的所有规则文件。
+安装器把各 skill 放在 `.trae/skills/<skill-name>/`，并在 `.trae/rules/superpowers-zh.md` 写入一份 bootstrap 规则。Trae 初始化时加载 `.trae/rules/` 下的规则，bootstrap 规则会引导 AI 在任务匹配时读取对应的 `.trae/skills/<skill-name>/SKILL.md` 并遵循其流程。
 
 ### 推荐配置
 

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "superpowers-zh",
   "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
-  "version": "1.1.6",
+  "version": "1.6.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/hooks-cursor.json

@@ -3,7 +3,7 @@
   "hooks": {
     "sessionStart": [
       {
-        "command": "./hooks/session-start"
+        "command": "./hooks/run-hook.cmd session-start"
       }
     ]
   }

package/hooks/session-start

@@ -7,13 +7,6 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
 
-# Check if legacy skills directory exists and build warning
-warning_message=""
-legacy_skills_dir="${HOME}/.config/superpowers/skills"
-if [ -d "$legacy_skills_dir" ]; then
-    warning_message="\n\n<important-reminder>IN YOUR FIRST REPLY AFTER SEEING THIS MESSAGE YOU MUST TELL THE USER:⚠️ **WARNING:** Superpowers now uses Claude Code's skills system. Custom skills in ~/.config/superpowers/skills will not be read. Move custom skills to ~/.claude/skills instead. To make this message go away, remove ~/.config/superpowers/skills</important-reminder>"
-fi
-
 # Read using-superpowers content
 using_superpowers_content=$(cat "${PLUGIN_ROOT}/skills/using-superpowers/SKILL.md" 2>&1 || echo "Error reading using-superpowers skill")
 
@@ -31,8 +24,7 @@ escape_for_json() {
 }
 
 using_superpowers_escaped=$(escape_for_json "$using_superpowers_content")
-warning_escaped=$(escape_for_json "$warning_message")
-session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${using_superpowers_escaped}\n\n${warning_escaped}\n</EXTREMELY_IMPORTANT>"
+session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${using_superpowers_escaped}\n</EXTREMELY_IMPORTANT>"
 
 # Output context injection as JSON.
 # Cursor hooks expect additional_context (snake_case).
@@ -45,13 +37,13 @@ session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the
 # See: https://github.com/obra/superpowers/issues/571
 if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
   # Cursor sets CURSOR_PLUGIN_ROOT (may also set CLAUDE_PLUGIN_ROOT)
-  printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
+  printf '{\n  "additional_context": "%s"\n}\n' "$session_context" | cat
 elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
   # Claude Code sets CLAUDE_PLUGIN_ROOT without COPILOT_CLI
-  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"
+  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context" | cat
 else
   # Copilot CLI (sets COPILOT_CLI=1) or unknown platform — SDK standard format
-  printf '{\n  "additionalContext": "%s"\n}\n' "$session_context"
+  printf '{\n  "additionalContext": "%s"\n}\n' "$session_context" | cat
 fi
 
 exit 0

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "superpowers-zh",
-  "version": "1.3.0",
+  "version": "1.6.0",
   "engines": {
     "node": ">=20.0.0"
   },
-  "description": "AI 编程超能力中文增强版 — superpowers（99k+ ⭐）完整汉化 + 6 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI 等 17 款工具",
+  "description": "AI 编程超能力中文增强版 — superpowers（159k+ ⭐）完整汉化 + 4 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 18 款工具",
   "type": "module",
   "main": ".opencode/plugins/superpowers.js",
   "bin": {
     "superpowers-zh": "bin/superpowers-zh.js"
   },
   "scripts": {
-    "version": "node scripts/sync-plugin-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .cursor-plugin/plugin.json .codex-plugin/plugin.json"
+    "site": "node site/build.mjs",
+    "site:deploy": "node site/build.mjs && wrangler pages deploy site/dist --project-name=superpowers-zh-site",
+    "version": "node scripts/sync-plugin-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .cursor-plugin/plugin.json .codex-plugin/plugin.json gemini-extension.json"
   },
   "files": [
     "bin/",
@@ -24,6 +26,7 @@
     ".codex-plugin/",
     ".opencode/INSTALL.md",
     ".opencode/plugins/",
+    ".pi/extensions/",
     "CLAUDE.md",
     "GEMINI.md",
     "RELEASE-NOTES.md",
@@ -53,17 +56,27 @@
     "hermes",
     "hermes-agent",
     "claw-code",
+    "qoder",
     "ai-coding",
     "skills",
     "chinese",
     "中文",
     "tdd",
     "debugging",
-    "code-review"
+    "code-review",
+    "pi-package"
   ],
+  "pi": {
+    "skills": [
+      "./skills"
+    ],
+    "extensions": [
+      "./.pi/extensions/superpowers.ts"
+    ]
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/jnMetaCode/superpowers-zh.git"
+    "url": "git+https://github.com/jnMetaCode/superpowers-zh.git"
   },
   "homepage": "https://github.com/jnMetaCode/superpowers-zh",
   "author": "jnMetaCode",

package/skills/brainstorming/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: brainstorming
 description: "在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。"
+version: "1.0.0"
+license: MIT
+metadata:
+  hermes:
+    tags: [design, planning]
 ---
 
 # 头脑风暴：将想法转化为设计