diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 6bf740b..061de19 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -9,7 +9,7 @@ { "name": "superpowers-zh", "description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具", - "version": "1.7.4", + "version": "1.7.5", "source": "./", "author": { "name": "jnMetaCode", diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 74c49ec..16b43d1 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "superpowers-zh", "description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具", - "version": "1.7.4", + "version": "1.7.5", "author": { "name": "jnMetaCode", "url": "https://github.com/jnMetaCode" diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 37d848a..0307d67 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", - "version": "1.7.4", + "version": "1.7.5", "description": "AI 编程超能力中文增强版:头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流,附 4 个中文 skills 沉淀。", "author": { "name": "jnMetaCode", diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index c89e64f..e91f710 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -2,7 +2,7 @@ "name": "superpowers-zh", "displayName": "Superpowers 中文版", "description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 22 款工具", - "version": "1.7.4", + "version": "1.7.5", "author": { "name": "jnMetaCode", "url": "https://github.com/jnMetaCode" diff --git a/.kimi-plugin/plugin.json b/.kimi-plugin/plugin.json index 1c08761..9f8deba 100644 --- a/.kimi-plugin/plugin.json +++ b/.kimi-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", - "version": "1.7.4", + "version": "1.7.5", "description": "AI 编程超能力中文增强版:头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流,附 4 个中文 skills 沉淀。", "author": { "name": "jnMetaCode", diff --git a/README.md b/README.md index 0930642..7b9a33c 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,9 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers) > > 🌍 Also available in [English](https://aiolaola.com/en?utm_source=github&utm_campaign=superpowers) · [日本語](https://aiolaola.com/ja?utm_source=github&utm_campaign=superpowers) · [Español](https://aiolaola.com/es?utm_source=github&utm_campaign=superpowers) · [한국어](https://aiolaola.com/ko?utm_source=github&utm_campaign=superpowers) · [繁體中文](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers) -> 🆕 **v1.7.4 更新亮点**([完整 Release Notes →](RELEASE-NOTES.zh.md)) +> 🆕 **v1.7.5 更新亮点**([完整 Release Notes →](RELEASE-NOTES.zh.md)) +> - 🐛 **两个 worktree / Gemini 的真问题** —— 修掉 worktree 清理静默空转;更正「Gemini 不支持子智能体」的错误说法(原说法会让 3 个 skill 在 Gemini CLI 上瘸腿) +> - 🔄 **测试参考重构** —— `testing-anti-patterns` → `writing-good-tests`:从 5 个反模式清单改为两条原则 + 变异检查 > - 🔄 **SDD 同步上游 v6.2.0** —— plan 作用域工作区(一份过期账本再也不会让控制者跳过整段任务)+ 五轮上限的唤回式修复循环与熔断裁定 > - 🪟 **Windows bootstrap 修复** —— SessionStart hook 改经 Git Bash 分发(同步上游),hook 不加载 skill 就是死重 > - 🧩 新增 **Cline** 与 **Kilo Code** 两款 VS Code 扩展(工具数 20 → 22)—— 按 rules 常驻开销做了专门设计,索引仅 4.5 KB diff --git a/README.zh-Hant.md b/README.zh-Hant.md index 6d6c755..5a48306 100644 --- a/README.zh-Hant.md +++ b/README.zh-Hant.md @@ -16,7 +16,9 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers) > 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers):180 節免費實操課 + 《AI 編程實戰三卷書》線上閱讀 + 實戰社群 · superpowers 裝好後配上方法論效率翻倍 · 永久免費 -> 🆕 **v1.7.4 更新亮點**([完整 Release Notes →](RELEASE-NOTES.zh.md)) +> 🆕 **v1.7.5 更新亮點**([完整 Release Notes →](RELEASE-NOTES.zh.md)) +> - 🐛 **兩個 worktree / Gemini 的真問題** —— 修掉 worktree 清理靜默空轉;更正「Gemini 不支援子智能體」的錯誤說法(原說法會讓 3 個 skill 在 Gemini CLI 上瘸腿) +> - 🔄 **測試參考重構** —— `testing-anti-patterns` → `writing-good-tests`:從 5 個反模式清單改為兩條原則 + 變異檢查 > - 🔄 **SDD 同步上游 v6.2.0** —— plan 作用域工作區(一份過期帳本再也不會讓控制者跳過整段任務)+ 五輪上限的喚回式修復循環與熔斷裁定 > - 🪟 **Windows bootstrap 修復** —— SessionStart hook 改經 Git Bash 分發(同步上游),hook 不載入 skill 就是死重 > - 🧩 新增 **Cline** 與 **Kilo Code** 兩款 VS Code 外掛(工具數 20 → 22)—— 針對 rules 常駐開銷做了專門設計,索引僅 4.5 KB diff --git a/RELEASE-NOTES.zh.md b/RELEASE-NOTES.zh.md index d970ee9..85d45dd 100644 --- a/RELEASE-NOTES.zh.md +++ b/RELEASE-NOTES.zh.md @@ -6,6 +6,57 @@ --- +## v1.7.5 (2026-08-07) + +对齐上游 v6.2.0 的 **B 块 + D 块**([#19](https://github.com/jnMetaCode/superpowers-zh/issues/19))。 + +### 🐛 worktree 清理静默空转(真 bug,我们与上游同样存在) + +`finishing-a-development-branch` 的步骤 6 在步骤 5 已经 `cd` 到主仓库根之后,才用 `git rev-parse --show-toplevel` 重算 `WORKTREE_PATH` —— 于是拿到主根路径,`.worktrees/` 溯源判断**永远匹配不上**,清理静默空转,随后分支删除还会因为 worktree 仍挂着而失败。上游记录说测试对象不得不偏离 skill 原文才能跑通。 + +修法:步骤 2 趁还在工作区内就捕获,步骤 6 消费该值并加显式警告说明为何不能重算;去掉步骤 6 冗余的 `MAIN_ROOT` 推导与 `cd`;选项 2 补上菜单已声称的分离 HEAD 推送变体。 + +**已实际复现验证**(临时仓库 + `.worktrees/feature`):旧逻辑算得 `main` → 溯源未命中 → 清理空转;新逻辑捕获到 `main/.worktrees/feature` → 命中 → `worktree remove` 与 `branch -D` 均成功。 + +### 🐛 我们把 Gemini 的子智能体支持写错了 + +`gemini-tools.md` 原文称 Gemini CLI 没有 Task 等价物、依赖子智能体的 skill「退化为 `executing-plans` 单会话执行」。**这是错的** —— Gemini CLI 通过 `invoke_agent`(`agent_name: "generalist"`,也可用 `@generalist` 聊天语法)支持子智能体,且支持同一响应内多调用并行分派。 + +这个错误会让 Gemini CLI 用户的 `subagent-driven-development` / `dispatching-parallel-agents` / `requesting-code-review` 全部瘸腿。按上游重写(33 → 62 行),补齐指令文件层级加载、`~/.gemini/skills` 与 `~/.agents/skills` 优先级、模板填写、并行分派,以及此前缺失的 20 个工具名。已全仓扫描确认无别处重复该说法。 + +### 🔄 `testing-anti-patterns.md` → `writing-good-tests.md` + +上游把 299 行的反模式枚举重写为 198 行的**两条原则**: + +- **原则 1「点名它要抓的破坏」** —— 写测试体前先答"什么生产改动会让它失败,那是 bug 还是决定"。含镜像断言、变更探测器、测行为不测文本、测你的代码不测框架 +- **原则 2「跑真东西」** —— mock 不配拥有断言、在正确层级 mock、替身要具体、完整镜像真实数据、生产类只承载生产方法 +- 新增**变异检查**:收尾前在脑中变异生产代码,每种现实变异都应至少让一个测试失败 +- 触发条件放宽到「编写或修改**任何**测试时」 + +TDD SKILL.md 同步:删掉「为什么顺序很重要」整节长散文(论点折进合理化借口表,5 行扩写)、删掉末尾已失效的「测试反模式」一节。 + +### 🔧 audit 结构漂移度量修正(此前一直在虚报欠账) + +`audit.sh` 用 `grep -cE '^#{1,4} '` 数标题,但这会把 ``` 围栏内的 shell 注释(`# 运行测试`)当成 markdown 标题 —— 多几行 bash 注释就能凭空造出「结构漂移」。 + +用正确口径(awk 逐行跟踪围栏)重算 14 个 skill,3 条告警里 **2 条是假阳性**: + +| skill | 旧口径 | 新口径 | +|---|---|---| +| `executing-plans` | 9/16 **WARN** | 9/11 pass | +| `finishing-a-development-branch` | 21/31 **WARN** | 14/17 pass | +| `using-git-worktrees` | 21/28 WARN | 14/21 **WARN(真漂移)** | + +双向验证:给 `brainstorming` 加 5 个真标题会触发告警,加 5 行围栏内 shell 注释不触发。 + +### ✅ 验证 + +- 两个新/改文件章节均与上游一一对应;`writing-good-tests.md` 指标精确一致(12 bold 要点 / 11 行表格 / 11 条危险信号 / 14 项代码记号) +- **行为 eval 8 个判断场景:8/8 全对**。附带一个有价值的对照:agent 拿不到 `writing-good-tests.md`、只能退回 SKILL.md 四条摘要时得分 6/8 —— 错的恰好是只存在于参考文件里的两条规则(部分 mock 静默失败、琐碎转发 getter 不配有测试)。说明参考文件承载着摘要覆盖不到的承重规则。 +- `scripts/audit.sh` **152 pass / 1 warn / 0 fail**(原 150/3)、`scripts/verify-release.sh` **82 pass / 0 fail** + +--- + ## v1.7.4 (2026-08-07) ### 🔄 SDD 同步上游 v6.2.0:plan 作用域工作区 + 基于唤回的修复循环(#19 A 块) diff --git a/gemini-extension.json b/gemini-extension.json index 7481257..bed40ac 100644 --- a/gemini-extension.json +++ b/gemini-extension.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论", - "version": "1.7.4", + "version": "1.7.5", "contextFileName": "GEMINI.md" } diff --git a/package.json b/package.json index ec3b521..4483767 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", - "version": "1.7.4", + "version": "1.7.5", "engines": { "node": ">=20.0.0" },