mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
a662295898
## 1) finishing-a-development-branch：worktree 清理静默空转（上游 0b47219）
真 bug，我们这边与上游同样存在。步骤 6 在步骤 5 已经 cd 到主仓库根之后才用
`git rev-parse --show-toplevel` 重算 WORKTREE_PATH，于是拿到主根路径 ——
`.worktrees/` 溯源判断永远匹配不上，清理静默空转，随后分支删除还会因为
worktree 仍挂着而失败。上游记录说测试对象不得不偏离 skill 原文才能跑通。
修法（4 处）：
- 步骤 2 趁还在工作区内就捕获 WORKTREE_PATH
- 步骤 6 改为消费步骤 2 的值，并加显式警告说明为什么不能在此重算
- 步骤 6 去掉冗余的 MAIN_ROOT 推导与 cd（两个调用方都已切好目录）
- 选项 2 补上菜单已声称的分离 HEAD 推送变体
已实际复现验证（临时仓库 + .worktrees/feature）：
- 旧逻辑：WORKTREE_PATH 算得 "main" -> 溯源未命中 -> 清理空转
- 新逻辑：捕获到 "main/.worktrees/feature" -> 命中 -> worktree remove 成功、
branch -D 成功（旧逻辑下会因 worktree 仍挂着而失败）
上游第 4 处改动（rationalization 表里"测试早先通过"那行的措辞）本次不适用 ——
我们还是「红线」清单，那张表属 C 块。
## 2) gemini-tools.md：我们错写成「不支持子 Agent」
我们的版本称 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.md 层级加载）、个人 skills 目录（~/.gemini/skills 与 ~/.agents/skills
的优先级）、子智能体支持与模板填写、并行分派，以及 tracker_* / complete_task /
update_topic / read_mcp_resource 等此前缺失的 20 个工具名。
已全仓扫描，确认没有别处重复这个错误说法。
## 3) audit.sh 结构漂移度量修正（顺带发现的假阳性来源）
3c/3d 用 `grep -cE '^#{1,4} '` 数标题，但这会把 ``` 围栏内的 shell 注释
（`# 运行测试`）当成 markdown 标题 —— 一个 skill 里多几行 bash 注释就能
凭空造出「结构漂移」。
用正确口径（排除围栏）重算 14 个 skill，3 条告警里 2 条是假阳性：
- 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（真漂移，保留）
这点很要紧：#19 里引用的上游欠账数字此前是被虚高的。
改为 awk 逐行跟踪围栏状态。双向验证：给 brainstorming 加 5 个真标题会触发
告警（7 vs 13），加 5 行围栏内 shell 注释不触发。
回归：audit.sh 152 pass / 1 warn / 0 fail（原 150 pass / 3 warn）
verify-release.sh 82 pass / 0 fail