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

30 Commits

Author SHA1 Message Date
AI不止语
d937312202 chore(release): v1.7.11 —— 剩下没查过的工具全查完了，又是四款「装了完全不生效」 
v1.7.10 查出三款装错，当时的结论是「既然错过一次，就该问一句还有几个」。这一版
把剩下的逐款对官方文档核完（拿不到文档的对源码）。

答案：又是四款装了完全不生效，全部是我们自己写的路径、全部没查过官方文档。

## 必须重装的六款

| 工具 | 问题 |
|---|---|
| Codex CLI | 项目级装到 `.codex/skills`，官方扫描清单里从来没有这个目录 |
| VS Code (Copilot) | 20 个文件 Copilot 一个都不读，且不写任何引导 |
| Windsurf | `--global` 装到 `~/.windsurf/skills`，官方是 `~/.codeium/windsurf/skills/` |
| DeerFlow | 检测标记 `deer_flow` 在真实仓库里不存在，从没被自动检测到过 |
| Qwen Code | 无 bootstrap（skill 是死重）；文档还把它跟通义灵码搞混了 |
| Claw Code | 无 bootstrap、且是 23 款里唯一没有安装文档的一款 |

## 其余

- CodeBuddy / CodeArts 拿到官方用户级路径出处，补 `--global`（全局支持 9 → 11 款）
- 4 条死链，其中 2 条是编造出来的仓库地址（`anthropics/openclaw`、
  `anthropics/antigravity` 都不存在）
- 官网工具墙停在 20 款：Cline / Kilo Code / Crush 的用户在下拉里找不到自己的工具；
  skill 详情页 6 条死链；新增赞助商页
- 5 条新门禁，全部做过反向验证：全局落盘位置、外链验活、官网工具列表条目数、
  官网全局清单覆盖、两条 shell 静默失效坑

## 版本号

`v1.7.11 起…` 这句话此前散在 8 处文档里，而 package.json 还停在 1.7.10 ——
用户装到的版本里根本没有那些修复。7 个声明文件经 scripts/sync-plugin-version.js
同步到 1.7.11，两版 README 的更新亮点块换成本版内容。

## 发版前全量验证（全绿）

| 项 | 结果 |
|---|---|
| `scripts/audit.sh` | 170 pass / 0 warn / 0 fail |
| `scripts/verify-release.sh` | 115 pass / 0 fail |
| CI 等价检查（frontmatter / package.json / --help） | 20 skills 0 error，v1.7.11 |
| tests/kimi · pi · opencode · brainstorm-server | 全 PASS（6 / 1 / 32 用例） |
| 官网 66 页构建 + 全站链接扫描 | 站内死链 0，无效 `href="#"` 0 |
| 官网给出的 23 条安装命令逐条实跑 | 19 款自动检测 + 4 款显式命令，各装 20 skills ✓ |
 2026-08-28 22:37:53 +08:00
AI不止语
d83d3f9dc2 chore(release): v1.7.10 —— 工具支持层系统核查：Aider / Kiro / Qoder 三处修正 
版本号：7 份声明文件 1.7.9 -> 1.7.10。包内文件 109（无增减）。

内容见 RELEASE-NOTES.zh.md v1.7.10 条目。起因是 v1.7.9 修 Hermes 时发现我们
从支持它起就装错了目录 —— 既然错过一次，就该问「还有几个」。答案是又查出三个，
全部是我们自己那层写的、全部没查过官方文档：

- Aider：检测标记 .aider 目录根本不存在（真实项目从没被检测到过），且
  CONVENTIONS.md 不会被自动加载（官方要求 --read）。两错叠加 = 完全不可用。
- Kiro：steering 每轮常驻，我们把 20 个 skill 正文全塞进去 —— 实测 335 KB/轮。
  改索引式后 4.4 KB，76 倍；升级时自动清旧布局（不清等于没修）。
- Qoder：subagent 映射表 4 行错 2 行，且没标适用范围（只覆盖 CLI，IDE 不同）。

同时堵上测试盲区：Aider 那个 bug 能在 90 项全绿下活着，是因为测试写的是
mkdir .aider 再断言认出 Aider —— 拿代码测代码。已补真实标记与 Kiro 两条硬
回归守卫，verify-release 90 -> 101 pass。

发版前门禁
- audit.sh 166 pass / 0 warn / 0 fail
- verify-release.sh 101 pass / 0 fail
- dry-run：1.7.10 / 109 文件
 2026-08-12 19:07:14 +08:00
AI不止语
4a53c1e6ab chore(release): v1.7.9 —— 修复 Hermes 支持一直不生效（#45） 
版本号：7 份声明文件 1.7.8 -> 1.7.9。包内文件 109（无增减）。

内容见 RELEASE-NOTES.zh.md v1.7.9 条目。要点：我们从支持 Hermes 起就只装
项目级 .hermes/skills/，而 Hermes 只自动加载 ~/.hermes/skills/ —— 装了完全
不生效，比不支持更糟。改为全局推荐 + 项目级打印可粘贴的 external_dirs 配置。
修复代码本体见 441d024，本次为发版收尾。

顺带修掉发版工具的一个真问题：bump-version.sh 缺 jq 时不退出，逐文件打
"command not found" 后继续跑到 unbound variable —— 版本号一个没写，输出里
却有 "Done."。加前置检查挡住（本次发版即踩到）。

发版前门禁
- audit.sh 166 pass / 0 warn / 0 fail
- verify-release.sh 90 pass / 0 fail
- dry-run：1.7.9 / 109 文件
 2026-08-11 20:53:41 +08:00
AI不止语
f290def463 chore(release): v1.7.8 —— 定位核查：修掉 5 处对上游的偏离并加检查固化 
版本号：7 份声明文件 1.7.7 -> 1.7.8。包内文件 108 -> 109（antigravity-tools.md）。

内容见 RELEASE-NOTES.zh.md v1.7.8 条目。要点：按「只是翻译上游 + 增加更多
工具支持」这个定位逐层核查，查出 5 处偏离（缺文件、漏同步 3 个 commit、
漏译 2 节、编号缺陷、增量插在上游步骤中间），全部修掉；并新增 audit 3c-bis
把「fork 增量必须显式声明」变成可执行检查。

发版前门禁
- audit.sh 166 pass / 0 warn / 0 fail
- verify-release.sh 90 pass / 0 fail
- dry-run：1.7.8 / 109 文件
 2026-08-08 14:30:03 +08:00
AI不止语
5b54fc4b53 chore(release): v1.7.7 —— 新增 Crush（23 款工具）+ 测试覆盖盲区修补 
版本号：7 份声明文件 1.7.6 -> 1.7.7。包内文件 107 -> 108（docs/README.crush.md）。

内容见 RELEASE-NOTES.zh.md v1.7.7 条目。

发版前门禁
- audit.sh 152 pass / 0 warn / 0 fail
- verify-release.sh 90 pass / 0 fail（覆盖从 82 项提升）
- dry-run：1.7.7 / 108 文件
 2026-08-08 06:15:40 +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不止语
d1ac51e450 chore(release): v1.7.6 —— 上游 v6.2.0 对齐完成，漂移告警清零 
版本号：7 份声明文件 1.7.5 -> 1.7.6（只动 "version" 行）。

C 块（说服性段落 -> rationalization 表）收尾，#19 的 A/B/C/D 四块全部完成。
scripts/audit.sh 的上游结构漂移告警从 3 条降到 0 条。

内容见 RELEASE-NOTES.zh.md v1.7.6 条目。要点：盘点先行发现 14 个
refactor commit 里有 3 项是实质改动而非风格瘦身（新增 rationalization 表、
executing-plans 加隔离工作区步骤、using-git-worktrees 规则等价压缩），
其余各项逐条核实规则在别处仍在之后才删。

发版前门禁
- audit.sh 150 pass / 0 warn / 0 fail
- verify-release.sh 82 pass / 0 fail
- 行为 eval 两轮共 11 题全对（专门考被删段落里的规则是否仍生效）
- dry-run：1.7.6 / 107 文件 / 468.6 kB
 2026-08-08 00:22:39 +08:00
AI不止语
9022c6fcc0 chore(release): v1.7.5 —— 上游 B + D 块（worktree bug、Gemini 勘误、测试参考重构） 
版本号：7 份声明文件 1.7.4 -> 1.7.5（只动 "version" 行）。

内容见 RELEASE-NOTES.zh.md v1.7.5 条目。三项面向用户的实质改动：

1) worktree 清理静默空转（真 bug，已复现验证）
2) 更正「Gemini 不支持子智能体」的错误说法 —— 原说法会让 3 个 skill
   在 Gemini CLI 上瘸腿
3) testing-anti-patterns.md -> writing-good-tests.md：5 个反模式清单
   重构为两条原则 + 变异检查

外加 audit 结构漂移度量修正（此前把围栏内 shell 注释当标题，虚报了 2 条
假阳性漂移；#19 里引用的欠账数字此前是虚高的）。

发版前门禁
- audit.sh 152 pass / 1 warn / 0 fail（唯一 warn 是 using-git-worktrees 真漂移）
- verify-release.sh 82 pass / 0 fail
- 行为 eval 8/8（B 块）
- 包内容核对：writing-good-tests.md 已入包、testing-anti-patterns.md 已移除、
  re-review-prompt.md 在包内
- dry-run：1.7.5 / 107 文件 / 468.1 kB
 2026-08-07 23:35:09 +08:00
AI不止语
eadc83b64b chore(release): v1.7.4 —— SDD 同步上游 v6.2.0（附行为 eval 证据） 
版本号：7 份声明文件 1.7.3 -> 1.7.4（只动 "version" 行，已 diff 确认）。
包内文件 106 -> 107（新增 re-review-prompt.md）。

内容见 RELEASE-NOTES.zh.md v1.7.4 条目。

按 CLAUDE.md「改 skill 需要 eval 证据」的要求，本次补了两层行为验证 ——
结构性核对不足以证明译文真的传达了新规则：

1) 新机制 7 个场景 eval：7/7 正确
   考察第 2 轮该唤回还是换新、第 4 轮模型档位、第 5 轮能否再开一轮、
   承重发现该搁置还是停下、Minor 走哪条路、遇到别的计划的账本怎么办、
   控制者能否自己修。连「运行环境无法唤回时才改派全新实现者」都答出。

2) 集成 eval：用 tests/subagent-driven-dev/go-fractals 脚手架跑真实
   执行的准备阶段，验证 agent 是否按新签名调脚本（旧习惯可能省掉 PLAN_FILE）
   - 实际调用 sdd-workspace plan.md，带上了 PLAN_FILE
   - 同时检查了 plan 作用域账本和旧扁平路径的游离账本
   - 账本第一行为正确的身份行；工作区落在 .superpowers/sdd/plan/
   - 起飞前冲突扫描产出 5 条打包成一次的提问，而非逐条打断
   - 建 10 条待办并按指令在分派实现者前停下

回归：audit.sh 150 pass / 0 fail、verify-release.sh 82 pass / 0 fail
dry-run：1.7.4 / 107 文件 / 464.0 kB
 2026-08-07 22:36:38 +08:00
AI不止语
78457e5bc3 chore(release): v1.7.3 —— 上游纯代码修复同步 + 工具计数一致性检查 
版本号：7 份声明文件 1.7.2 -> 1.7.3（只动 "version" 行，未重排 JSON，已 diff 确认）。

内容见 RELEASE-NOTES.zh.md v1.7.3 条目：
- 同步上游 Windows SessionStart hook 分发修复与 find-polluter.sh 三处路径 bug
- audit 新增 Category 5 工具计数一致性检查（+24 项，已验证会拦漂移）
- 修 bash 3.2 下 CJK 报错信息乱码（3 处）
- .gitignore 补新工具安装产物；官网计数 20 -> 22
- 简繁 README 亮点更新至 v1.7.3，补上 Windows 修复一条

发版前门禁
- scripts/audit.sh: 153 pass / 0 fail（3 warn 为上游漂移，见 #19）
- scripts/verify-release.sh: 82 pass / 0 fail
- npm publish --dry-run: 1.7.3 / 106 文件 / 457.6 kB
 2026-08-07 21:59:56 +08:00
AI不止语
da6c6b082d chore(release): v1.7.2 —— Cline / Kilo Code 适配 + 检测落空建议 + marketplace 文档 
版本号：7 份声明文件全部 1.7.1 -> 1.7.2（按 .version-bump.json 逐一核对一致）。
注：本机没装 jq，scripts/bump-version.sh 跑不了，改用等价的逐字面量替换，
只动 "version" 那一行，未重排任何 JSON（已 diff 确认）。

新增 scripts/verify-release.sh —— 发版前深度验证，82 项断言。
补 audit.sh 的盲区：audit 只看 installer 退出码，装完有没有东西落盘、卸载有没有
留垃圾它都不查。本脚本断言实际结果：
  A. 22 款工具：装 -> 断言 20 个 skill 落盘 -> 二次装幂等 -> 卸载零残留 + 无嵌套
  B. 19 个检测标记逐一验证只触发预期工具（防新增工具误触发既有工具）
  C. --global 7 款成功 / 14 款明确拒绝且退出码 1
  D. --global 拒绝信息引用的 8 份 docs 真实存在（防死链）
  E. rules 型工具索引断言：表 20 行、无空 description、Cline 无 frontmatter
  F. PATH 探测在 PATH 为空 / 畸形 / 未定义三种退化情形下的健壮性

文档
- RELEASE-NOTES.zh.md 加 v1.7.2 条目，含设计取舍与完整验证清单
- 简繁 README 更新亮点：v1.7.0 -> v1.7.2（1.7.1 时漏更新，一并修正）
- marketplace 示例里的 "Version: 1.7.1" 改为「<当前版本>」—— 写死版本号每次
  发版都会过期

发版前验证结果
- scripts/audit.sh: 130 pass / 0 fail（2 warn 为既有上游漂移，见 #19）
- scripts/verify-release.sh: 82 pass / 0 fail
- npm 包端到端：npm pack -> 包内 version 1.7.2 -> 从 tarball 安装 ->
  用打包后的二进制真实跑 Kilo Code 自动检测 -> 20 skills + 索引生成 ->
  卸载零残留
- engines >=20 与实际语法一致（仅用到 padEnd/ES2017，无 ?? 与 ?.）
- 包体 444K / 106 文件，docs/README.cline.md 与 README.kilocode.md 均已入包
 2026-08-07 20:00:51 +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不止语
c9d1539412 chore(release): v1.7.1 —— subagent-driven-development 对齐上游 v6 重写 
npm 1.7.0 发布在 SDD v6 合并（#108）之前，tarball 不含新内容，故 bump patch 发版：
- 双审查者合并为 task-reviewer-prompt.md、新增 scripts/（review-package/sdd-workspace/task-brief）
- SKILL/implementer 补 v6 契约、删 v5 双 reviewer
- 7 个清单版本同步至 1.7.1

关联 #89 #19
 2026-07-17 21:15:10 +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
AI不止语
c3fe5ba31c chore: 同步上游 v6.1.0/v6.1.1（bootstrap 精简 + Codex 插件清单修复）(#94) 2026-07-13 20:30:53 +08:00
AI不止语
e8d9c9cb01 chore(release): v1.6.0 
对齐上游 v6.0.0 实质变更 + 新增 Kimi/Pi 两款 harness 支持：
- Kimi Code 支持（#59，关 #37）
- Pi (oh-my-pi) 支持（#60，关 #44）
- brainstorm 可视化伴侣安全模型（#58，每会话密钥 + 安全头）
- worktree 移除旧全局目录（#57）+ hooks/session-start v6（#58）
- opencode 测试修复（#72）

版本号同步：package.json + 5 个 plugin 清单 + marketplace + gemini-extension。
 2026-06-20 10:17:04 +08:00
AI不止语
3202b18e43 chore: release v1.5.0 — Qoder 适配 + qoder-tools.md ref 
- package.json + 5 个 plugin manifest: 1.4.0 → 1.5.0
- RELEASE-NOTES.zh.md: 新增 v1.5.0 段，描述 Qoder 适配、Rules schema
  来源说明、设计取舍
- skills/using-superpowers/references/qoder-tools.md: 新增工具映射 ref
  （Qoder 大部分工具同名 CC，仅 EnterPlanMode → EnterSpecMode 差异；
  附 Task agent 类型表 + Quest MCP 工具清单）
- skills/using-superpowers/SKILL.md 第 42 行: 平台适配段加 Qoder ref 引用

发版前验证：
- 6 处版本号全部 1.5.0
- 18 款工具 install + 二次幂等 + uninstall 全跑通
- bootstrap 工具（Qoder + Trae）rule 文件内容正确写入与卸载清理
- audit 96 PASS / 0 FAIL
- npm pack --dry-run 确认 docs/README.qoder.md + qoder-tools.md 入包
 2026-05-21 05:56:56 +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不止语
9a8d4e471e docs(meta): 修 "6 中国原创" 文案漂移，准确反映 14+4+2 拆分 (#27) 
* docs(meta): 修 "6 中国原创" 文案漂移，准确反映 14+4+2 拆分

5 处描述把 skill 数量写成 "14 翻译 + 6 中国原创"，但实际只有 4 个 chinese-*
（chinese-code-review / chinese-commit-conventions / chinese-documentation /
chinese-git-workflow）是中国原创；另外 2 个（mcp-builder / workflow-runner）
是上游 v5.0+ 已删除但本 fork 保留的 skill，不是中国原创。

- 结构化描述（3 个 plugin/marketplace JSON）：拆为 "14 翻译 + 4 中国原创 + 2 上游历史保留"
- 散文（README + package.json）：改 "完整汉化 + 4 个中国原创 skills"
  （mcp-builder/workflow-runner 实质上是汉化版，归入"完整汉化"语义）

数学：14 + 4 + 2 = 20，与 .codex-plugin/plugin.json 已有的 "4 个中文 skills 沉淀" 对齐。

* docs(readme): 补漏 L61 "6 国产原创" 同性质漂移

跟前一 commit 同性质——"国产原创" 语义明确指 chinese-original，
mcp-builder/workflow-runner 是上游翻译版不是国产原创。

剩余 L44/46/L122/L133/L134 用的是 "中国特色"（china-specific）
框架，可以包含 fork-specific 历史保留，留给跟进 PR 单独处理。
 2026-05-12 18:36:07 +08:00
AI不止语
c5b4fa446b chore: release v1.4.0 — 上游漂移 P0 全量修复 + 防回归基建 (#32) 
跟 PR #28 + #30 + #31 一起构成 v1.4.0 的完整内容。本 PR 仅做发布层
（版本号 bump + plugin manifest 同步 + release notes），不动 skill 内容。

版本号 1.3.0 → 1.4.0：
- package.json
- .claude-plugin/plugin.json + marketplace.json
- .cursor-plugin/plugin.json
- .codex-plugin/plugin.json
- gemini-extension.json（之前卡在 1.1.6，本次顺带追上）

工具链小修：
- scripts/sync-plugin-version.js TARGETS 加入 gemini-extension.json
  （之前漏掉，是 gemini-extension.json 长期卡在老版本的根因）
- package.json 的 version 钩子 git add 列表加上 gemini-extension.json

RELEASE-NOTES.zh.md 新增 v1.4.0 段，按"上游同步"性质分组列出 9 项
修复内容，明确标注每项的上游 ref + 本 fork PR 号。

注意：本 PR 应在 #28 + #30 + #31 merge 之后才 merge —— 顺序错了
会导致 release notes 描述的 PR 在 git log 里还没有。

不影响：
- 上游 marketplace 安装路径（仍按主站路径正常工作）
- 现有 npm 用户向后兼容（npx superpowers-zh 仍可用）
 2026-05-12 18:14:02 +08:00
AI不止语
6c1fe583e8 chore: release v1.3.0 — 跟上游 v5.1.0 对齐 + 修 marketplace.json drift 2026-05-10 22:57:13 +08:00
AI不止语
48c4d0d417 fix(scripts): sync-plugin-version 支持嵌套字段路径 (#23) 
补上之前简化版未实现的 plugins.0.version 路径，把
.claude-plugin/marketplace.json 纳入版本同步目标。

修复 marketplace.json 卡在 1.1.8 的老漂移（自 v1.1.8 起没动过）：
plugins[0].version 1.1.8 -> 1.2.1（追上其他 4 个 manifest）。

实现：
- TARGETS 改为对象数组 { path, field }，对齐上游 .version-bump.json 格式
- field='version' 走顶层 regex（保留原行为）
- field='plugins.0.version' 走嵌套 regex（锚定到 plugins 数组首项）
- 都用 regex 替换而非 JSON.stringify，保持原文件格式（缩进/数组写法等）

测试：
- 升级场景 1.2.1 → 1.3.0：4 个 manifest 全部同步
- 幂等性：版本相同时输出 "already at"
- 边界：marketplace.json 其他字段完全未动（diff 仅 version 一行）
- npm pack：90 文件 228KB 不变
 2026-05-10 22:48:09 +08:00
AI不止语
bb9dc4950e chore: plugin manifest 版本号自动跟 package.json 同步 
之前 .claude-plugin/plugin.json 和 .cursor-plugin/plugin.json 的 version
字段一直停在 1.1.8，落后于 npm 1.1.9 / 1.2.0 / 1.2.1——每次发版都要手改。

- 新增 scripts/sync-plugin-version.js：用正则替换 version 字段一行，
  保留两个 manifest 的原排版（数组单行/多行、缩进等），无 diff 噪音
- 在 package.json 挂 npm version 钩子：bump 后自动同步并 git add 到
  version commit 里，从此不会再漏
- 把当前两个 manifest 从 1.1.8 一次性修到 1.2.1
 2026-05-05 19:32:20 +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
7628e03ece docs: update branding -- OpenClaw first, 6 Chinese skills, 14 tools 
- Unify all descriptions: GitHub repo, package.json, plugin configs
- Put OpenClaw first in all tool listings (high demand from community)
- Fix skills count: 5 -> 6 Chinese-original (was missing workflow-runner)
- Fix version: 1.0.0 -> 1.1.1 in claude-plugin and cursor-plugin configs
- Reorder tool support table by popularity
- Update README tagline to match GitHub repo description
 2026-03-26 22:55:38 +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
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