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

19 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不止语
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不止语
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不止语
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
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
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
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