lywsvip/superpowers-zh
1
0
Fork 0
mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-02 22:54:06 +08:00
Code Issues Packages Projects Releases Wiki Activity
206 Commits 34 Branches 46 Tags
main
Commit Graph

39 Commits

Author SHA1 Message Date
AI不止语
fb63548c9d fix(installer): Codex 项目级装到 Codex 从不扫描的目录；CodeArts 补 --global 
## Codex：项目级又是「装了完全不生效」

官方 skills 文档（developers.openai.com/codex/skills，现 308 跳到官方新文档站）
给出的扫描目录**完整清单**：

    $CWD/.agents/skills、$CWD/../.agents/skills、$REPO_ROOT/.agents/skills
    $HOME/.agents/skills、/etc/codex/skills、内置 skill

**没有 .codex/skills。** 两次分别追问确认「.codex/skills 是否曾被扫描」，答案都是
从未出现。而我们项目级正是装到 .codex/skills。

全局（~/.agents/skills）一直是对的 —— 原注释也写明了「不是 ~/.codex/skills」，
说明当初查过全局却没顺手核项目级。改为 .agents/skills，并在安装时清理旧位置
（只清我们装的那些，用户自己放在 .codex/skills 下的不动，已实测）。

与 Antigravity 共用 .agents/skills 是 Agent Skills 开放约定，不是冲突。

## 这个改动暴露出一个既有 bug：检测有顺序依赖

改完后测试立刻报「检测 .codex/ -> 得到「Antigravity,Codex CLI」，期望「Codex CLI」」。

根因：自动检测是**边装边判**的。Codex 装到 .agents/skills 会创建 .agents/，
循环走到 Antigravity（detect: '.agents'）时它就被误判为「项目里有这个工具」，
于是多装一份。这个坑在任何「装了 A 会创建 B 的检测标记」的组合上都会犯。

改为先把所有工具的检测结果一次性算完再开始装 —— 检测必须基于**安装前**的项目
状态。实测：只有 .codex 时只装 Codex；同时有 .codex 与 .agents 时两款都装且
.agents/skills 下仍是 20 个（不重复）。

## CodeArts：官方已证实用户级路径，补上 --global

原注释只写「用户在 #20 确认」，没有官方出处。已补华为云官方用户指南出处：

    项目级：项目根目录的 ./.codeartsdoer/skills/
    个人级：%USERPROFILE%/.codeartsdoer/skills   即 ~/.codeartsdoer/skills

既然已证实，--global 从拒绝名单移出并加落盘断言。实测装 20 个到
~/.codeartsdoer/skills、卸载后 HOME 零残留。仍是 skills-only —— 其 bootstrap
约定未证实，不猜。

## 顺带核实

- Cursor：官方 skills 文档确认 .cursor/skills/<name>/SKILL.md ✅
- OpenCode：官方 skills 文档确认项目级与全局都对 ✅（唯二全对的之一）
- Kimi / Pi：不在 TARGETS 里，走 plugin manifest 与扩展分发；已确认 docs 没有
  承诺 --tool kimi/pi，installer 也正确拒绝这两个名字，无虚假承诺

audit 168 pass / 0 warn / 0 fail；verify-release 115 pass / 0 fail。
 2026-08-13 05:54:52 +08:00
AI不止语
0e3fbc4830 fix(installer): VS Code 装的 20 个文件 Copilot 一个都不读（又一个纯死重） 
## 问题

官方文档（code.visualstudio.com/docs/copilot/customization/custom-instructions）
明确 Copilot 只自动读这几处：

    .github/copilot-instructions.md / AGENTS.md / CLAUDE.md   （始终生效）
    .github/instructions/*.instructions.md                    （按 applyTo 匹配）

而我们把 20 个 skill 拷进 `.github/superpowers/` —— **不在其中**，而且装完
**什么引导都不写**。也就是说 VS Code 用户装完，Copilot 一个字都不会读。

旧文档更说明问题：它写着「由于 Copilot 主要通过单个指令文件工作，建议创建
.github/copilot-instructions.md 引用 skills」并给了示例 —— 我们知道需要引导，
却让用户自己动手，而绝大多数人不会照做。

## 改法

自动生成 `.github/instructions/superpowers-zh.instructions.md`：

    ---
    applyTo: "**"          # 关键：省略则只能手动挂载 = 白写
    name: Superpowers-ZH
    description: …
    ---

约 4.5 KB 的索引（核心规则 + 20 个 skill 触发条件表），正文仍留在
`.github/superpowers/` 按需读取 —— 与 Cline / Kilo / Kiro 同一套思路：applyTo "**"
的文件对每个请求都生效，正文塞进去就是每轮常驻开销。

**刻意不动用户的 .github/copilot-instructions.md** —— 那是他们的文件。用我们自己
的 .instructions.md，互不干扰，卸载也能精确删除。

检测标记补上 `.github/instructions`（用了 instructions 机制的项目都有），原来只认
`.github/copilot-instructions.md`。

## 顺带核实的两款

- **Cursor**：cursor.com/docs/skills 确认 .cursor/skills/<name>/SKILL.md 启动时
  自动发现 —— 我们是对的。
- **OpenCode**：opencode.ai/docs/skills 确认 .opencode/skills/ 与
  ~/.config/opencode/skills/ —— 项目级和全局都对。它同时扫 .claude/skills 与
  .agents/skills，已在注释里写明「装过 CC 或 Antigravity 的别重复装」。

## 验证

- 装：正确识别 -> 生成 instructions（applyTo "**"，4503 字节）+ skills 到
  .github/superpowers/
- 卸载：只删我们的，用户的 my-own.instructions.md 与 copilot-instructions.md
  原样保留
- verify-release 新增 VS Code 段（文件存在 / applyTo 断言 / 20 行索引 / 指向
  .github/superpowers/），111 -> 115 pass
- audit 168 pass / 0 warn / 0 fail
 2026-08-12 21:03:40 +08:00
AI不止语
43edf34b2c fix(installer): Windsurf 全局装错目录（装了不生效）+ 两个静默失效的检查 
## Windsurf --global 一直装在 Windsurf 不读的地方

官方文档（docs.windsurf.com/windsurf/cascade/skills）写明两个路径**不同构**：

    项目级：.windsurf/skills/<skill-name>/
    用户级：~/.codeium/windsurf/skills/<skill-name>/   ← 在 .codeium 下

我们的 --global 装到 ~/.windsurf/skills —— Windsurf 不读那里。又一个 Hermes 同款
「装了完全不生效」。项目级路径是对的，只有全局错。

Cursor 一并核实：cursor.com/docs/skills 确认 .cursor/skills/<name>/SKILL.md
启动时自动发现，无需配置 —— 我们装的是对的。

## 测试为什么没抓到：只验退出码，不验落盘位置

verify-release 的 C 段对全局白名单只断言「退出码为 0」。装到错目录退出码照样是 0。
**「跑通了」不等于「装对了」。** 新增 GLOBAL_DIR 断言：10 款全局工具逐个断言
skill 真的落在官方读的那个目录，外加一条自检（GLOBAL_DIR 必须覆盖 GLOBAL_OK 全部，
以后加全局工具不能漏断言）。

双向验证：把 Windsurf 全局路径改回旧值，立刻报
「--global windsurf: .codeium/windsurf/skills 里是 0 个 skill，期望 20」。

## 两个我自己写出来的静默失效

**① `grep -P` 不可移植。** 新加的「变量后紧跟多字节字符」检查第一版用了 grep -P，
在交互 shell 里（ugrep）看着能用，进了脚本跑的是 /usr/bin/grep（BSD grep，不支持
-P），配上 2>/dev/null 就成了永远匹配不到的死检查 —— 正是我这两天一直在修的那类
bug，自己又造了一个。改用 LC_ALL=C + ERE：C locale 下多字节按单字节处理，>0x7F
的字节落在 [^ -~] 之外，BSD/GNU 都支持。

**② 同一个全角括号坑又踩一次。** `期望 $EXPECT_SKILLS（…）` 里全角括号被吞进变量
名，set -u 下脚本半途崩掉。这已经是本仓第二次（第一次是死链检查的 $code）。所以
把它固化成 audit 1e，注释行排除，双向验证过。

## 一次操作事故（记下来）

用 /tmp 备份做变异测试时，把 verify-release.sh 的未提交改动整段覆盖没了，
git diff 才发现。变异测试应该用 git 保护现场，不该用 /tmp 拷贝。

## 其它

- 外链验活跳过分支补 ok，否则 PASS 总数随网络漂移、发版记录对不上（实测连跑两次
  稳定 111）
- docs/README.windsurf.md 重写：两个路径不同构、渐进式披露（默认只给模型 name +
  description，不造成常驻开销）、跨工具发现（也扫 .agents/skills 与 .claude/skills，
  装过 Antigravity 或 CC 的不必重复装）

audit 168 pass / 0 warn / 0 fail；verify-release 111 pass / 0 fail。
 2026-08-12 20:42:21 +08:00
AI不止语
226638b969 feat(installer): Claw Code 补 bootstrap + 文档；CodeBuddy 补 --global（官方已证实） 
核查最后两款。这两款的**路径都是对的**，问题在缺失的能力和文档。

## Claw Code

路径拿到了源码级证据（ultraworkers/claw-code）：
- rust/crates/plugins/src/lib.rs 明写 "discovers skills from local roots such as
  `.claw/skills`, `.omc/skills`, `.agents/skills`, `~/.omc/skills` …"
- USAGE.md 列出根指令文件优先级 CLAUDE.md > CLAW.md > AGENTS.md

三处缺口：

**① 没写 bootstrap。** 只装 skills，CLAW.md 一个字都没写 —— 与 Qwen Code 同款
问题，skill 能被发现但不会自动触发。已补 generateClawBootstrap。

**② 一个真实的遮蔽陷阱。** 因为优先级是 CLAUDE.md > CLAW.md，项目里若已有
CLAUDE.md（不少工具都会生成它），就可能压过我们刚写的 CLAW.md，表现为「装了
不触发」。安装器现在检测到这种情况会主动提示，并给出解法（让 CLAUDE.md 也带
引导）。这种坑不说清楚，用户只会以为我们的东西不好使。

**③ 23 款工具里唯一没有安装文档的一款。** 已补 docs/README.claw.md，含上面两条
源码出处、遮蔽陷阱说明，以及一条实用提醒：claw 也扫 .agents/skills，装过
Antigravity 的项目其实已经能读到，再装会加载两份。

## CodeBuddy

路径和 bootstrap 都对（官方 codebuddy.cn/docs/cli/skills 与 /codebuddy-dir 确认
.codebuddy/skills/ + CODEBUDDY.md）。但我们的文档写着：

> 目前仅支持项目级安装。CodeBuddy 的用户级（全局）skills 加载路径尚未验证。

现已核实 —— 官方目录结构文档确认全局与项目级同构：

    skills   ~/.codebuddy/skills/       .codebuddy/skills/
    记忆文件  ~/.codebuddy/CODEBUDDY.md   项目根 CODEBUDDY.md（两处等价）
    优先级   项目级 > 用户级 > 插件级

已补 --global 支持：TARGETS 加 global、bootstrap 支持 isGlobal（全局写
~/.codebuddy/CODEBUDDY.md）、全局卸载清单加上它。文档链接一并从
copilot.tencent.com 换成官方文档域名 codebuddy.cn。

## 验证

- Claw 项目级：装 -> CLAW.md 生成 -> 卸载零残留；已有 CLAUDE.md 时正确给出提示
- CodeBuddy 全局：装到 ~/.codebuddy/skills + ~/.codebuddy/CODEBUDDY.md，
  bootstrap 内容指向 ~/.codebuddy/skills/，卸载后 HOME 零残留
- CodeBuddy 项目级不受影响，仍指向 .codebuddy/skills/
- verify-release 白名单 codebuddy 由「应拒绝」移到「应成功」，110 pass / 0 fail
- audit 167 pass / 0 warn / 0 fail（新增 docs/README.claw.md 进交叉引用检查）
 2026-08-12 19:48:14 +08:00
AI不止语
49c2e3a205 fix(installer): DeerFlow 检测标记不存在（Aider 同款）+ 文档里一个查无实据的环境变量 
## 安装路径是对的

官方文档（bytedance-deer-flow.mintlify.app/concepts/skills）确认 DeerFlow 自动
扫描两个**写死**的目录找 SKILL.md：

    for base_dir in ["skills/public", "skills/custom"]:

public 是自带的、进 git；custom 是用户装的、默认被 gitignore。无任何配置项。
我们装到 skills/custom/ 是对的。

## 但检测标记从来没匹配过

detect 写的是 deer_flow —— 用 GitHub API 列了 deer-flow main 分支的顶层目录：

    .agent .github backend contracts deploy docker docs frontend plans
    pr-build scripts skills tests

**没有 deer_flow。** 跟 Aider 的 .aider 是同一个毛病：真实检出从来没被自动检测
到过，用户必须手动 --tool deerflow。

改认 skills/public —— 它是 skills 机制本身、随仓库版本控制，任何 DeerFlow 检出
都有；deer_flow 保留作 1.x 兼容。实测模拟真实检出（skills/public + backend +
frontend）能正确识别为 DeerFlow 并装进 skills/custom/。

## 文档里一个查无实据的环境变量

旧文档给了 `export DEERFLOW_SKILLS_DIR=...` 的写法，容易被读成「DeerFlow 认这个
环境变量」。官方文档里没有它，目录是写死的。已删除，改为直接用绝对路径。

顺带补上原文档没说的两件事：容器挂载（skill 在沙箱里跑，两个目录挂到
/mnt/skills/，附属脚本要写容器内路径），以及由此带来的限制 —— brainstorming
的可视化伴侣是宿主机 harness 用的，在 DeerFlow 容器沙箱里不可用。

## 验证

- 模拟真实 DeerFlow 检出：自动识别 -> skills/custom/
- 卸载精确：只删我们装的 20 个，skills/public/ 与用户自建的 custom skill 不动
- verify-release B 段补 skills/public 标记，109 -> 110 pass
- audit 166 pass / 0 warn / 0 fail
 2026-08-12 19:42:04 +08:00
AI不止语
b01a91c267 fix(installer): Qwen Code 缺 bootstrap（skill 是死重）+ 文档把产品搞混了 
核查第五款。路径本身是对的 —— 这是查过的几款里第一个没装错地方的。但另有
两个问题。

## ① 我们把产品搞混了

docs 标题写「Qwen Code (通义灵码)」，链接指向 tongyi.aliyun.com；README 里
把它标成「IDE 插件」。

实际：Qwen Code 是 QwenLM/qwen-code 这个**命令行工具**（Gemini CLI 的 fork），
跑在终端里。通义灵码是阿里的 IDE 插件，**是另一个产品**，配置路径完全不同。
照着我们的文档去配通义灵码是配不通的。

这跟 #119 的 Qoder 表「没标产品面」是同一类错误：把两个不同产品面的东西
混成一份说明。docs 与简繁 README 一并更正（类型也从「IDE 插件」改回 CLI）。

## ② 只装 skills、不写 bootstrap —— skill 是死重

实测装完项目里只有 .qwen/skills/，一个引导文件都没写。而 Claude 写 CLAUDE.md、
Gemini 写 GEMINI.md，Qwen Code 的对应物 QWEN.md 我们完全没用。

按上游的原则：没有 bootstrap，skill 就是死重 —— 文件在磁盘上但很少被调用。

两套机制都查了官方文档：
- skills：qwenlm.github.io/.../features/skills/ 确认 .qwen/skills/ 与
  ~/.qwen/skills/ 自动发现，无需配置
- QWEN.md：分层记忆的默认上下文文件就是 QWEN.md，从 cwd 逐层向上到项目根、
  以及全局 ~/.qwen/ 都会被扫描并拼接（可用 contextFileName 改名）

已补 generateQwenBootstrap，复用 Gemini 那套结构：项目级写 ./QWEN.md，全局写
~/.qwen/QWEN.md；已有文件则用哨兵注释追加而不覆盖。

顺带补上全局卸载的缺口：qwen 在 GLOBAL_OK 里，--global 会写 ~/.qwen/QWEN.md，
原来 GLOBAL_BOOTSTRAP_CLEAN_SECTION 只有 .claude/CLAUDE.md，装卸一轮会在用户
主目录留残留。

## 验证

- 项目级：已有 QWEN.md 时追加，卸载后逐字节恢复用户内容
- 全局：写 ~/.qwen/QWEN.md，卸载后 HOME 下残留 0 个文件
- verify-release 新增 Qwen 段（bootstrap 写入 / 不覆盖用户内容 / 指向
  .qwen/skills/ / 卸载切除干净 / 不误删用户内容 / 全局零残留），101 -> 108 pass
- audit.sh 166 pass / 0 warn / 0 fail

## 范围

installer、docs、简繁 README、verify-release 均为 fork 自有，零上游偏离。
 2026-08-12 19:17:26 +08:00
AI不止语
ad32b2546b fix(installer): Kiro 把 335 KB 塞进每一轮对话 —— 改为索引式（Aider 的反面） 
继 Aider 之后核查 Kiro。这次的错跟 Aider 正好相反：不是不加载，是**全部加载、
每一轮都加载**。

## 问题

Kiro 官方文档（kiro.dev/docs/steering）明确：`.kiro/steering/` 下的文件默认
`inclusion: always`，"loaded into every Kiro interaction automatically"。

而我们把 20 个 skill 的正文整个装进了 `.kiro/steering/`。实测：

    47 个 md 文件 / 342914 字节 ≈ 335 KB —— 每轮对话全量进上下文

这跟我们当初给 Cline / Kilo Code 修的是同一个问题（那次是 182 KB），解法当时
就设计好了，只是没意识到 Kiro 的 steering 也是常驻性质。

## 改法：照搬 Cline / Kilo 的索引式

- skills 正文改装 `.kiro/skills/`（不被自动加载）
- `.kiro/steering/superpowers-zh.md` 只放索引：核心规则 + 20 个 skill 的触发
  条件表，带 `inclusion: always`

335 KB -> 4.4 KB，76 倍。

## 升级路径（这条最要紧）

老用户通常直接重装而不会先卸载。不清旧布局的话新旧两份并存，335 KB 一点没减 ——
那这次修了等于没修。所以安装时先清 `.kiro/steering/` 下与我们 skill 同名的目录，
并打印清理了几个；卸载同样处理（LEGACY_SKILL_DIRS）。

只删同名目录，**用户自己写的 steering 文件不动** —— 已实测。

## 文档里两个编造的 frontmatter 键

docs/README.kiro.md 写着加载模式是 `alwaysApply: true` 和 `globs: "*.ts"` ——
这两个键 Kiro 文档里**根本不存在**，是 Cursor / Trae 的约定被误写成了 Kiro 的。
Kiro 实际用 inclusion / fileMatchPattern。已按官方文档重写整篇，并补上默认值
就是 always 这一条（这正是 335 KB 的成因）。

## 回归守卫

verify-release.sh 新增 Kiro 段：索引存在、带 inclusion: always、20 行表、指向
.kiro/skills/，以及两条硬守卫 ——
  - steering 下只能有 1 个 md
  - steering 常驻总字节 < 20 KB
外加升级路径断言：旧布局必须被清、用户自己的文件必须保留。
双向验证过：模拟退回旧布局后两条断言都会失败。

verify-release 93 -> 101 pass。

## 验证

- 全新装：steering 1 个文件 4437 字节，.kiro/skills/ 下 20 个 skill
- 从旧布局升级：342971 -> 4494 字节，清理 20 个旧目录，用户文件保留
- 卸载：零残留，用户 steering 文件逐字节保留
- audit.sh 166 pass / 0 warn / 0 fail、verify-release.sh 101 pass / 0 fail

## 范围

installer、docs、README 简繁、verify-release 均为 fork 自有，零上游偏离。
 2026-08-12 18:58:54 +08:00
AI不止语
be6dc8c252 fix(installer): Aider 支持有两个都会导致「装了不生效」的错（#45 同类） 
顺着 #45（Hermes 装错目录）和 #119（Qoder 映射表是编的）这条线，系统查了
我们自己那层工具支持。Aider 查出两处，都实测坐实，都是「装完看着成功、
实际不生效」。

## ① 真实 Aider 项目从来没被自动检测到过

detect 写的是 '.aider'，即要求存在一个 `.aider/` 目录 —— 而 **Aider 不创建
这个目录**。它在项目根留下的是 `.aider.` 前缀的产物：

  .aider.conf.yml / .aider.chat.history.md / .aider.tags.cache.v3/

实测：造一个含这三样的目录跑 `npx superpowers-zh`，输出「未检测到任何已知
AI 编程工具」。而 docs/README.aider.md 一直写着「会自动检测 .aider.conf.yml
文件」—— 文档描述的是意图，代码做的是另一回事。

改为认这四个标记（保留 '.aider' 兼容）。

## ② CONVENTIONS.md 不会被 Aider 自动加载

代码注释和文档都写着「Aider 原生支持自动加载此文件」。官方文档
（aider.chat/docs/usage/conventions.html）说的是反的：必须
`aider --read CONVENTIONS.md`，或在 .aider.conf.yml 里写 `read: CONVENTIONS.md`。

最糟的是 docs 的「Skills 未生效」排障第 3 条写着「Aider 会自动读取
CONVENTIONS.md，无需额外配置」—— 用户卡住时来查文档，看到的正好是让他
继续卡住的那句。

改法照搬 #45 的做法：装完打印可直接用的两种激活方式，**不替用户改
.aider.conf.yml**（那是他们的文件）。docs 开头重写，把「还需一步」放最前面，
并注明 v1.7.9 及更早的说法是错的。

## 测试的盲区

verify-release.sh 的检测测试是 `mkdir .aider` 然后断言认出 Aider —— 拿代码
测代码，真实标记一个都没测。已补三个真实标记；顺带修了 case 分支：.yml 也
要按文件建，用目录冒充文件等于测了个假场景。

verify-release 90 -> 93 pass。

## 验证

- 只有 .aider.conf.yml 的目录：正确识别为 Aider，并打印激活提示
- 已有自写 CONVENTIONS.md：追加而不覆盖；卸载后逐字节恢复原内容
- 卸载：.aider 下残留 0 项
- audit.sh 166 pass / 0 warn / 0 fail、verify-release.sh 93 pass / 0 fail

## 范围

bin/superpowers-zh.js、docs/README.aider.md、scripts/verify-release.sh 均为
fork 自有（上游没有 installer 与 docs），零上游偏离。
 2026-08-12 18:03:28 +08:00
AI不止语
441d024cd6 fix(installer): Hermes 支持一直是坏的 —— 改为全局安装并给出可粘贴配置（#45） 
## 我们装错了目录，一直没生效

#45 报告人说「项目级 .hermes/skills/ 里的 20 个 skill 全部返回 404，必须手动
复制到 ~/.hermes/skills/ 才被识别」。查官方文档核实，他是对的：

hermes-agent.nousresearch.com/docs/user-guide/features/skills 明确
Hermes 只自动加载 ~/.hermes/skills/（原文 "the primary directory and source
of truth"），项目级目录不被自动发现；外部目录必须写进 ~/.hermes/config.yaml
的 skills.external_dirs。

而我们从支持 Hermes 起就只装项目级 .hermes/skills/ —— 那个目录 Hermes 根本
不读。这不是「不好用」，是「装了完全不生效」，比不支持更糟。

## 改法

- TARGETS 给 Hermes 加 global（~/.hermes/skills），全局成为推荐装法
- 项目级仍保留（skills 可随仓库分发），但装完打印**可直接粘贴**的配置片段：
      skills:
        external_dirs:
          - <项目绝对路径>/.hermes/skills
  不替用户改 config.yaml —— 那是他们的文件。文档里也写明「配置里不存在的
  路径会被静默跳过」，所以写错不会报错、只会没生效。
- 全局模式**不写 bootstrap**：Hermes 的用户级指令文件约定没有公开文档，
  往 $HOME 根目录写 HERMES.md 是猜路径 + 污染主目录。实测确认全局装完
  $HOME 根目录 0 个文件、卸载 0 残留。

## 文档与清单

- docs/README.hermes.md 开头重写，把「必须全局」放在最前面，并注明
  v1.7.8 及更早只支持项目级 = 装了不生效，是我们的实现错误
- 简繁 README：全局支持清单加 Hermes Agent，工具表的安装命令改为 --global
- verify-release.sh 的 GLOBAL_OK 加 hermes、GLOBAL_NO 移除

## 验证

- 全局：装 20 skills 到 ~/.hermes/skills、$HOME 根目录 0 文件、卸载 0 残留
- 项目级：正确打印 A/B 两种方案与绝对路径的 config.yaml 片段
- audit.sh 166 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 0 fail

注：#45 的后半部分（7 个 skill 文件里 24 处硬编码 Claude 工具名）本次未动。
那属于行为塑造内容，且 references/hermes-tools.md 已有完整映射表，
应走「强化映射表引用」而非把正文改成某个 harness 专属工具名。
 2026-08-08 14:55:21 +08:00
AI不止语
8a2f37071a feat(installer): 新增 Crush 适配（23 款工具，#40）；补齐 verify-release 覆盖盲区 
## Crush（#40）

查权威源（charmbracelet/crush repo 文档）确认：Crush 遵循 Agent Skills 开放标准，
项目级**自动发现** .crush/skills、.agents/skills、.claude/skills、.cursor/skills
四个目录，无需任何配置；用户级为 ~/.config/crush/skills。

重要副作用写进了 docs：已经为 CC / Cursor / Codex / Antigravity 装过的用户，
Crush 现在就已经能读到那些 skills，此时不要再装 --tool crush，否则同一批
skills 会有两份、被重复加载。docs 里给了确认命令。

- TARGETS 加 Crush（detect: .crush / crush.json / .crush.json），支持 --global
- CLI_PROBES 加 crush（它是 CLI，PATH 探得到）
- skills-only 适配，不需要 bootstrap；不动用户的 crush.json
- 新增 docs/README.crush.md
- 计数 22 -> 23（installer TARGETS 22 条 + Copilot CLI 单独计）

实测：装 20 skills / 二次装幂等 / 卸载零残留且正确保留用户的 crush.json；
--global 装到 ~/.config/crush/skills 并可干净卸载。

## audit Category 5 当场抓到我漏改的 5 处

加计数时忘了 site/build.mjs 的 5 个位置（三语言标语 + FAQ 枚举）。上个版本
新加的计数一致性检查直接 FAIL 拦下 —— 这是它第一次在真实改动中生效。已补
site 18 处并重建，三语言首页 23 计数、0 残留、Crush 均已出现。

## verify-release.sh 有同样的漂移问题，已修

它有自己独立的覆盖清单，加新工具时不进去就静默不测（本次 Crush 就是：
分数仍是 82，因为压根没测它）。

- SPEC / DETECT / GLOBAL_OK 三处补 Crush
- 顺带发现 B 段还漏了 3 个工具的检测标记：DeerFlow（deer_flow）、
  VS Code（.github/copilot-instructions.md）、Gemini CLI（GEMINI.md）——
  后两个是文件而非目录，DETECT 循环原先一律 mkdir，现按扩展名区分创建方式
- 新增 G 段自检：SPEC 覆盖数必须等于 installer 宣称的工具数；
  DETECT 覆盖的工具名集合必须包含全部 TARGETS 名字（用集合比对而非数条数 ——
  一个工具可以有多个检测标记，数数会误判）

覆盖从 82 项升到 90 项。

回归：audit.sh 152 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 0 fail
 2026-08-08 06:14:48 +08:00
AI不止语
6cb1cd89bc feat(installer): 新增 Cline 与 Kilo Code 适配（22 款工具，#112、#88） 
两款都是 VS Code 扩展，加载的是「rules」而非懒加载的 skills —— rules 会
并入每一轮 system prompt。所以照搬「把 20 个 SKILL.md 复制进规则目录」会
让每轮对话背着几万字常驻开销（Cline 官方也提示规则超约 300 行后遵守度下降）。

改用仓库既有的 Trae 模式：规则目录里只放一份小索引（核心规则 + 20 个 skill
的名称/触发条件表），skills 本体放各自的 skills/ 目录由 agent 按需读取。

Cline（#112）
- skills -> .cline/skills/，索引 -> .clinerules/superpowers-zh.md
- 不写 YAML frontmatter：Cline 目前只支持 paths 一个条件字段，
  无 frontmatter 即始终生效，正是所需
- 索引保持在 .clinerules/ 根层单文件 —— 子目录是否递归扫描官方未说明

Kilo Code（#88）
- skills -> .kilocode/skills/，索引 -> .kilocode/rules/superpowers-zh.md
- 走 .kilocode/rules/ 而非 v7 推荐的 .kilo/rules/ + kilo.jsonc：后者需要把
  路径登记进用户的 kilo.jsonc，那是带注释的 JSONC，安装器安全合并容易改坏
  用户配置。官方明确 .kilocode/rules/ 向后兼容且零配置生效，故选它。
  docs 里写了想迁到 v7 方式该改哪一行，以及万一没生效怎么反馈。

接入点（全部为新增，未改动任何既有工具的条目）
- TARGETS 加 2 条，检测标记 .clinerules / [.kilocode,.kilo,kilo.jsonc] 均唯一
- installForTarget 分发、TOOL_ALIASES（cline/kilocode/kilo/kilo-code）
- BOOTSTRAP_DELETE 加两份索引路径，--uninstall 能清干净
- --global 明确拒绝并指向 docs：Cline 全局 rules 路径随 OS 变
  （~/Documents/Cline/Rules，Linux/WSL 还有 ~/Cline/Rules 回退），
  Kilo 全局需改 kilo.jsonc，都不是通用 --global 能可靠命中的
- audit.sh TOOLS 数组加 cline kilocode，纳入 install/幂等/卸载回归
- 新增 docs/README.cline.md、docs/README.kilocode.md
- 计数 20 -> 22：简繁 README、package.json、CLAUDE.md、3 份 plugin manifest
  （RELEASE-NOTES 里的历史计数是过往版本记录，不动）

实测
- 两款均通过 装 / 二次装幂等 / 卸载无残留
- 检测隔离：.clinerules 只触发 Cline、.kilocode|.kilo|kilo.jsonc 只触发
  Kilo Code；.claude/.cursor/.trae/.qoder/.codebuddy 检测结果与改动前一致；
  .claude + .clinerules 共存时两款并行安装正常
- audit.sh: 130 pass / 0 fail（2 项 warn 为既有上游漂移，见 #19）

路径依据：docs.cline.bot/customization/cline-rules、kilo.ai/docs/customize/custom-rules

两款合并为一个提交：共用同一套「rules 型工具」机制与同一批计数改动，
拆开会产生 21 款的中间状态，audit 无法在中间提交上自洽通过。
 2026-08-07 17:38:37 +08:00
AI不止语
23fc645402 fix(installer): 修正复制失败提示里的失效锚点 
上一个提交给 README 插入「方式二：Plugin Marketplace」后，手动安装一节
顺延为方式三，installer 报错文案里硬编码的 #方式二手动安装 锚点失效。

改为指向父级 #快速开始 —— 章节编号以后还会变，锚点不该依赖它。
 2026-08-07 17:34:21 +08:00
AI不止语
08c5290ce6 feat(installer): 检测落空时扫 PATH，给出针对性的 --tool 命令 (#48) 
用户装了 opencode/codex 但项目里没留下标记目录（没在该项目跑过、或配置
在别处），只报「未检测到任何已知 AI 编程工具」很让人懵 —— issue #48 报告
人 opencode 1.17.3 就是这种情况。

改为：检测落空时扫 PATH 找已安装的 CLI，直接打印可复制的 --tool 命令。

- 新增 CLI_PROBES（仅 CLI；IDE 装在应用目录里，PATH 上探不到）
- isOnPath() 只查文件是否存在，不 spawn 进程 —— 不在用户机器上执行
  探测命令；Windows 下遍历 PATHEXT
- --global 模式只建议 GLOBAL_TARGETS 内的工具，避免推荐装不了的
- 探到具体工具就不再列通用示例，别让用户在无关工具名里自己挑

仍然只提示、不自动安装 —— 自动装错工具正是 issue #33 修掉的问题：
PATH 上装了不代表这个项目要用它。

audit.sh: 126 pass / 0 fail（2 项 warn 为既有的上游漂移，见 #19）
 2026-08-07 17:25:15 +08:00
AI不止语
01319b5b02 feat: 新增华为云码道 CodeArts 支持（skills-only，关 #20） (#99) 
华为云 CodeArts Doer 的 skills 目录为 .codeartsdoer/skills/（用户在 #20 确认）。
本次做 skills-only 适配：检测 .codeartsdoer/ 或 --tool codearts 安装，
靠 CodeArts 自身 skill 发现加载。其 bootstrap/指令文件约定未证实，
故不生成 bootstrap（docs 已说明，若不自动触发可手动点名 skill）。

- bin: TARGET（.codeartsdoer/skills，检测 .codeartsdoer）+ 别名
  （codearts/codeartsdoer/huawei）
- 工具数 19 → 20：README/站点/package/FAQ/stats 同步
- docs/README.codearts.md（含自动触发的诚实说明 + 求证请求）
- audit TOOLS 加 codearts

测试：audit 124 PASS/0 FAIL（含 codearts 装/幂等/卸载）、全局套件 50/50
回归、站点重建工具数 20。
 2026-07-13 21:56:11 +08:00
AI不止语
cd651cd1c6 feat: 新增 CodeBuddy（腾讯 AI IDE）工具支持（关 #18 #75） (#98) 
CodeBuddy 加载机制类似同类 IDE：项目根 CODEBUDDY.md 作 bootstrap，
skills 放 .codebuddy/skills/。仅项目级（用户级加载路径未证实，暂不做全局）。

- bin: 加 TARGET（检测 .codebuddy / CODEBUDDY.md）+ 别名（codebuddy/-cn/-code）
  + CODEBUDDY.md bootstrap 生成 + 卸载哨兵清理
- 工具数 18 → 19：README/站点/package.json/FAQ/stats 全量同步
- docs/README.codebuddy.md 中文使用文档；audit TOOLS 加 codebuddy
- 站点 FAQ 与工具列表补 CodeBuddy

测试：audit 122 PASS/0 FAIL（含 codebuddy 装/幂等/卸载）、全局套件 50/50
回归无破、站点重建 42 页工具数 19。
 2026-07-13 21:43:56 +08:00
AI不止语
b9c6ca7c89 feat: 支持全局安装 --global（关 #21） 
多项目用户此前需逐个项目 npx 安装。新增 --global：一次装到工具的
用户级目录（如 ~/.claude/skills），所有项目共享，更新只需重装一次。
项目级（默认）优先、全局兜底，二者可共存。

- 支持全局的 7 款工具，均逐一核对各工具 docs 声明的真实加载路径，
  不臆造无效路径；其余工具明确报错并引导项目级安装
- Codex 全局装到 ~/.agents/skills（docs 确认其启动扫描该目录，
  而非 ~/.codex/skills）
- Gemini / Antigravity 有意不纳入通用 --global（各有专属全局方式），
  报错指向对应 docs，避免「装了不生效」的假功能
- 对称的 --global --uninstall，按哨兵精确清理，保全用户既有内容
- home 护栏：项目级仍拒绝在 ~ 裸装并引导 --global，全局模式跳过
- 版本 1.6.1 → 1.7.0，同步 6 个 plugin manifest
- 顺带修 package.json description 残留的 159k+ → 250k+

隔离自动化测试 50/50 通过：项目级回归、7 款全局工具装卸、数据保全
（含全局 CLAUDE.md 保留用户个人指令）、幂等性、非全局工具拒绝并
指向 docs、自动检测、home 护栏、参数健壮性。
 2026-07-13 20:36:59 +08:00
Drolese
1d504ed756 fix(Antigravity): 修复Antigravity安装引导文件目录错误问题 (#51) 
参考官方文档https://antigravity.google/docs/skills，将引导目录从.antigravity修改为.agents
 2026-06-17 06:48:29 +08:00
AI不止语
76019ce9d6 fix(install): 检测落空时不再静默兜底安装 (#33) (#43) 
零参数 npx superpowers-zh 自动检测不到任何工具目录时，原本会静默兜底
安装到 .claude/skills/。但 Antigravity / Trae 等工具不一定在项目里留下
检测目录（如 .antigravity/），这些工具的用户因此被误装成默认目标，且因
文件实际落在 .claude/ 而非预期目录，卸载时显示成功但文件依旧存在。

改为：检测落空时明确报错并列出 --tool 用法后退出，不做任何安装。
带 .claude/ 目录的项目仍会被自动检测命中，裸命令安装行为不变。

修复 #33。
 2026-06-17 06:45:00 +08:00
AI不止语
725977b422 feat: 加 Qoder 适配（第 18 款工具）— skills + always_on bootstrap rule 
closes #26, closes #34

## 改动

- bin/superpowers-zh.js: TARGETS 加 Qoder (`.qoder/skills`, detect `.qoder`)，
  TOOL_ALIASES 加 `qoder`，新增 `generateQoderBootstrap()` 生成
  `.qoder/rules/superpowers-zh.md`（`trigger: always_on` + `alwaysApply: true`）
- scripts/audit.sh: TOOLS 加 qoder，17→18
- 3 个 plugin manifest（.claude-plugin/{plugin,marketplace}.json、.cursor-plugin/plugin.json）
  description 同步到 18 款
- README、CLAUDE.md、package.json 文案对齐 18
- docs/README.qoder.md: 新增完整安装/使用/卸载指南，附 schema 说明

## 设计要点

Qoder Rules 的 frontmatter schema（`trigger: always_on` / `model_decision` /
`manual`）官方 docs.qoder.com/zh/user-guide/rules 未公开，来自 GitHub 上
4 份真实社区样本（python-office、termiClaude、QoderTest、TelegramFileServer）
的交叉验证。

按 Trae 模式生成 always_on bootstrap 而非 Cursor/Windsurf 的"裸 skill"模式，
是为了确保核心规则（先 brainstorming / 先 TDD / 先验证）在每个会话都自动加载，
不依赖模型对 description 文本的隐式匹配。

## 验证

- 端到端：--tool qoder 装、自动检测、二次幂等、卸载（20 skills + 1 bootstrap
  全部清掉，0 残留）
- bootstrap 文件 skill 列表（20）与实际 skills/ 目录数（20）一致
- 全量 audit: 96 PASS / 0 FAIL（18 款工具完整 install + 幂等 + uninstall 跑通）
 2026-05-21 00:56:18 +08:00
AI不止语
a9e02b501e chore: 跟上游 v5.1.0 对齐 (#22) 
补齐上游漏的根级文件：CLAUDE.md（翻译 + 中文 fork 备注）、
AGENTS.md（symlink → CLAUDE.md，跟上游 mode 120000 一致）、
RELEASE-NOTES.md（上游英文原样 1180 行）、RELEASE-NOTES.zh.md
（新建中文 fork 自身 release log）、.codex-plugin/plugin.json
（中文化）、.version-bump.json、scripts/bump-version.sh、
assets/{app-icon.png,superpowers-small.svg}、4 个上游新增测试。

跟上游意图对齐，删上游已废弃流程：
- commands/ 全 3 个 deprecated stub（上游 #1188）
- agents/code-reviewer.md（已上升进 requesting-code-review skill，
  上游 PR #1299）
- bin/superpowers-zh.js 删 install agents 逻辑，保留 uninstall 用
  hardcoded LEGACY_AGENT_FILENAMES 列表清理已装用户残留
- .github/workflows/ci.yml 删 "Validate agents" 段
- package.json files 字段移除 agents/ commands/

主动修上游 v5.1.0 疏忽：
- .cursor-plugin/plugin.json 删 dangling 的 "agents": "./agents/"
  和 "commands": "./commands/"。上游删目录但忘同步 manifest
  （git blame 显示自 2026-02-13 起从未更新）。

配套：
- scripts/sync-plugin-version.js 扩到 .codex-plugin/plugin.json
- npm pack 校验 90 文件 228KB，agents/commands 残留 0 条

中文版"手动新增"叠加层全部保留：bin/ + npx 流程、docs/、
chinese-* skill、mcp-builder、workflow-runner、README 主推 npx、
各 INSTALL.md、.gemini/、sync-plugin-version.js。

详见 RELEASE-NOTES.zh.md v1.3.0 段。
 2026-05-10 22:27:52 +08:00
AI不止语
36187d388e fix: 哨兵注释 + 保守 fallback，杜绝 --uninstall 数据丢失 
v1.2.0 的 cleanBootstrapSection 用 indexOf('\n# ') 找段尾，当 superpowers
段在文件开头、后面只有 ## 二级标题时，会错误地把段尾扩展到文件末尾，
导致用户在 superpowers 段之后写的二级标题内容被一并删除。

修复：
- 安装时给 4 处追加型 bootstrap（CLAUDE.md / GEMINI.md / HERMES.md /
  CONVENTIONS.md）的内容用 <!-- superpowers-zh:begin/end --> 哨兵包裹
- 卸载优先按哨兵精确切除；找不到时 fallback 到标题 marker；
  再不行用末尾固定句子兜底；都不行就跳过 + 警告，绝不删用户数据
- isHomeDir 在 homedir() 返回空字符串时返回 false（避免误判 cwd 是 home）
 2026-05-05 18:24:57 +08:00
AI不止语
85fd3aeda2 fix: 加 --uninstall 子命令、home 目录守护、计数显示修复（#17） 
- 修复在 ~ 直接安装会污染主目录的问题：默认拒绝，需 --force
- 新增 npx superpowers-zh --uninstall：清理 skills、bootstrap 文件，
  保留用户在 CLAUDE.md/HERMES.md 中的原有内容
- 修复多工具检测时计数叠加显示（21/23/101 → 全部按源数 20 显示）
- copyDirSync 跳过 .DS_Store，停止散播 macOS 元数据
 2026-05-05 18:01:43 +08:00
jnMetaCode
8298e9f865 fix: npx 安装 CC 目标时补上 CLAUDE.md bootstrap（skill 不触发根因） (#14) 
之前 installForTarget 对 Trae/Gemini/Aider/Antigravity/Hermes 都会自动生成
bootstrap 规则（写到各自的 rules 文件），让模型知道"任何任务前先查 skill"。
唯独 .claude/ 分支只复制 skills 和 agents，不写 CLAUDE.md 引导。

结果：用户 npx superpowers-zh 装到 .claude/ 后，skill 文件都在，但模型
完全没被告知要主动用——提"加个导出功能"直接写代码，不会走 brainstorming
→ writing-plans 的方法论流程。手动 /brainstorming 能触发，自动不触发。

本次改动：
- 新增 generateClaudeCodeBootstrap()，对齐 Gemini/Aider 的追加/创建逻辑
- installForTarget 的 .claude/ 分支调用它
- 默认回退分支（未检测到任何工具）也调用它
- 幂等：已包含 superpowers-zh 引用则跳过
- 已有 CLAUDE.md 则追加，保留用户原内容

本地验证四个场景：空项目 / 已有 CLAUDE.md / 二次装 / --tool claude，全部通过。

version bump: 1.1.8 -> 1.1.9
 2026-04-28 11:11:44 +08:00
jiangnan
4778006422 feat: 添加 Claw Code 支持（第 17 款工具）+ CNB 平台支持 
- 新增 Claw Code（Rust 版 AI CLI）：auto-detect `.claw/` 或 `CLAW.md`，支持 `--tool claw/claw-code/clawcode`
- chinese-git-workflow skill 新增 CNB（腾讯云原生构建）平台适配，含 `.cnb.yml` CI 示例（#6）
- 版本 1.1.7 → 1.1.8
 2026-04-19 16:04:29 +08:00
jiangnan
fb08e884dc fix: Windows 下 cpSync 复制 skills 失败导致目标目录为空（#5） 
- 弃用 cpSync 改用手动递归 + realpathSync，规避 npx 缓存 junction
  和 Node 16.7-18 cpSync 实验性 API 在 Windows 上的不稳定行为
- 复制后做计数校验：源 >0 而目标 =0 时报错并给出排查建议
- bump 1.1.6 → 1.1.7
 2026-04-16 08:27:53 +08:00
jiangnan
d89daf9fc2 feat: 添加 Hermes Agent 支持（第 16 款工具） 
- 安装器新增 Hermes Agent 目标（.hermes/skills/）和别名（hermes/hermes-agent）
- 安装时自动生成 HERMES.md bootstrap（含工具映射和 skills 列表）
- 新增 references/hermes-tools.md 工具映射表（中文化）
- using-superpowers 技能新增 Hermes Agent 平台说明（skill_view 三级渐进式加载）
- 各处 description 加入 Hermes Agent 名称，工具数量更新为 16 款
- package.json 添加 hermes/hermes-agent 关键词
 2026-04-13 20:16:00 +08:00
jiangnan
fc9a2a40ca 同步上游 v5.0.7：Copilot CLI 支持、OpenCode bootstrap 改进、版本统一 
上游同步：
- hooks/session-start: 新增 Copilot CLI 平台检测（COPILOT_CLI 环境变量）
- .opencode/plugins/superpowers.js: bootstrap 从 system prompt 改为 user message 注入，避免 token 膨胀和 Qwen 兼容问题
- skills/using-superpowers: 新增 Copilot CLI 使用说明和工具映射引用
- 新增 references/copilot-tools.md（中文化）

本地优化：
- 清理 OpenCode 插件死代码（normalizePath/os/configDir）
- 统一版本号为 1.1.6（修复插件 JSON 与 package.json 不一致）
- .gitignore 排除安装器生成的 skills 副本
- package.json files 数组精简，避免打包重复的 skills 副本
- 安装器新增 copilot/copilot-cli 别名
- 工具数量更新为 15 款
 2026-04-13 19:55:20 +08:00
jiangnan
72db65ad1c fix: bootstrap rules 不再混入第三方 skills（如 OpenSpec） 
scanSkillEntries 改为扫描源目录 SKILLS_SRC，而非安装目标目录，
避免用户已有的其他工具 skills 被误列进生成的 rules 文件。
 2026-04-06 14:11:22 +08:00
jiangnan
b38edc010c feat: 添加 --tool 参数支持手动指定工具，改进检测失败提示 
Cursor 等工具如果项目里没有配置目录，自动检测会失败。

新增：
- --tool cursor / --tool trae 等参数跳过检测直接安装
- 支持 19 个别名（cursor, claude-code, trae, windsurf 等）
- 检测不到工具时提示用户使用 --tool 而非静默回退
- 重构 installForTarget() 消除重复代码
 2026-04-01 14:46:22 +08:00
jiangnan
550853fd8e fix: 兼容低版本 Node.js（>=14），解决 cpSync 不可用问题 
Windows 用户报告 SyntaxError: 'fs' does not provide an export named 'cpSync'。
根因：cpSync 是 Node 16.7+ API，低版本不支持。

修复：
- 新增 copyDirSync() 兼容函数，优先用 cpSync，不可用时手动递归复制
- 添加 engines 字段声明最低 Node 14+ 要求
 2026-03-31 14:11:03 +08:00
jiangnan
67a4365819 fix: Antigravity/Aider/Gemini CLI 安装后自动生成引导文件 
与 Trae 同类问题：skills 复制到目录后工具无法自动发现。

- Antigravity: 生成 .antigravity/rules.md
- Aider: 生成 CONVENTIONS.md（已有则追加，幂等安全）
- Gemini CLI: 追加到 GEMINI.md（已有则追加，幂等安全）
- 重构 scanSkillEntries() 为公共函数，4 款工具共用
 2026-03-30 11:20:28 +08:00
jiangnan
c4123e821b fix(trae): 安装 skills 到正确目录并自动生成 bootstrap rule 
Trae 用户反馈安装后 skills 无法自动激活。根因：skills 被安装到
.trae/rules/ 而非 .trae/skills/，且缺少 alwaysApply 引导规则。

修复：
- skills 安装到 .trae/skills/（正确目录）
- 自动生成 .trae/rules/superpowers-zh.md（alwaysApply: true）
- bootstrap rule 包含所有 skills 的名称和触发条件
 2026-03-30 11:02:26 +08:00
jiangnan
c2ab9e653b feat: add Windsurf, Gemini CLI, Aider, OpenCode, Qwen Code support — 14 tools total 
- Add 5 new tool targets to installer (bin/superpowers-zh.js)
- Gemini CLI detects GEMINI.md to avoid conflict with Antigravity
- Aider detects .aider/ directory for broader compatibility
- Add installation docs for Windsurf, Gemini CLI, Aider, Qwen Code
- Update README with full 14-tool support table and usage guide
- Fix skills count: 20 (14 translated + 6 Chinese-original incl. workflow-runner)
- Fix OpenClaw doc linking to wrong upstream repo
- Align gemini-extension.json name/version with package.json
- Add docs/ to package.json files array for npm installs
- Add install script validation step to CI
 2026-03-26 22:33:15 +08:00
jiangnan
fd145dc641 feat: add OpenClaw support 
- Add OpenClaw target in installer (detect .openclaw/, install to skills/)
- Add OpenClaw to README supported tools list, manual install, config table
- Add docs/README.openclaw.md installation guide
- Add openclaw keyword to package.json
 2026-03-26 21:07:04 +08:00
jiangnan
6046c4c334 feat: add DeerFlow 2.0 support + workflow-runner skill 
- Install script detects deer_flow/ and copies skills to skills/custom/
- Add DeerFlow to README tool list and install instructions
- Add docs/README.deerflow.md install guide
- Add deerflow keyword to package.json
- Include workflow-runner skill (20 skills total)
 2026-03-24 07:44:50 +08:00
jiangnan
74a9b7c1f0 修复安装脚本：fallback 补装 agents、错误处理、参数校验 
- fallback 安装现在也会安装 agents 到 .claude/agents/
- install 函数添加 try-catch 和 SKILLS_SRC 存在性检查
- 未知 CLI 参数显示警告并输出帮助
- 帮助文本补充 agents 相关说明
 2026-03-21 00:17:52 +08:00
jiangnan
6fa291f09c 修复安装脚本：精确检测工具目录，防止误安装 
- VS Code 检测改为 .github/copilot-instructions.md（避免误判普通 .github 目录）
- VS Code skills 安装到 .github/superpowers/（不污染 .github 根目录）
- Antigravity skills 安装到 .antigravity/skills/
- 移除 installed===0 的首个工具强制安装逻辑
- 6 个场景测试全部通过
 2026-03-20 19:35:35 +08:00
jiangnan
6d95ed50b0 v1.1.0: 新增 Kiro/Trae/Antigravity/VS Code 支持 
- 安装脚本自动检测 7 种 AI 编程工具
- 新增 4 个工具安装指南（Kiro/Trae/Antigravity/VS Code）
- README 更新支持工具列表和安装方式
- package.json 版本升级至 1.1.0
 2026-03-20 19:31:56 +08:00
jiangnan
80bc100625 superpowers 中文社区版：14 个翻译 + 5 个中国特色原创 skills 
基于 obra/superpowers (MIT) 完整汉化，新增中国开发者专属 skills：
- 中文代码审查：适配国内团队沟通文化
- 中文 Git 工作流：支持 Gitee/Coding/极狐 GitLab
- 中文技术文档：中英混排规范、排版标准
- 中文提交规范：Conventional Commits 中文适配 + commitlint 配置
- MCP 服务器构建：生产级 MCP 工具开发方法论

支持工具：CC / Cursor / Codex CLI / Gemini
安装：npx superpowers-zh
 2026-03-20 11:32:25 +08:00