Skip to content

sync(v6): 移除旧全局 worktree 目录引用,对齐上游 v6.0.0#57

Merged
jnMetaCode merged 1 commit into
mainfrom
sync/v6-worktree-cleanup
Jun 19, 2026
Merged

sync(v6): 移除旧全局 worktree 目录引用,对齐上游 v6.0.0#57
jnMetaCode merged 1 commit into
mainfrom
sync/v6-worktree-cleanup

Conversation

@jnMetaCode

Copy link
Copy Markdown
Owner

你要解决什么问题?

using-git-worktreesfinishing-a-development-branch 两个 skill 仍在引用 ~/.config/superpowers/worktrees/ 这个全局 worktree 目录。上游 obra/superpowers 在 v6.0.0 已废弃该目录,worktree 统一落到项目内 .worktrees/。本 fork 落后于此:agent 按现有中文 skill 行事时,仍会把这个上游已不再创建的路径当作合法的目录选择项和清理目标,造成与上游实际行为不一致的指引。

此外 using-git-worktrees 存在既有的步骤编号缺口(步骤 0,1,3,4,缺 2),阅读和交叉引用易混。

本改动属于 issue #19(v6 同步追踪)范围内的 worktree 部分。

这个 PR 做了什么改变?

从两个 skill 中移除所有 ~/.config/superpowers/worktrees/ 全局目录引用(目录选择分支、安全验证豁免说明、创建代码块、快速参考表行、优先级表述、清理判定);并把 using-git-worktrees 的步骤重新编号为连续的 0,1,2,3、校正 3 处步骤交叉引用,使其与上游 v6.0.3 标题结构逐行对齐。

这个改变适合放在核心库中吗?

适合。这是对所有用户通用的核心 worktree skill 的上游行为同步,与具体项目/领域/第三方工具无关,不引入任何依赖。

你考虑了哪些替代方案?

  • 保留全局目录做"向后兼容":放弃。上游已删除创建该目录的逻辑,保留只会指引 agent 操作一个不会再生成的路径,是死引用。
  • 只删目录、不修步骤编号:放弃。既然要与上游 v6.0.3 对齐,顺带修正编号缺口可让结构逐行一致、降低后续同步成本;且编号修正是纯文档、无行为风险。

这个 PR 是否包含多个不相关的改变?

否。两文件的改动是同一件事——同步上游 v6.0.0 的「移除旧全局 worktree 目录」这一行为变更。步骤重编号是该文件对齐 v6.0.3 结构的附带必要项。

已有的 PR

测试环境

工具(如 Claude Code、Cursor) 工具版本 模型 模型版本/ID
Claude Code 本会话 Claude Opus 4.8 claude-opus-4-8

评估

本改动是对上游已发布、已由上游 eval 验证的行为变更的忠实结构同步,非新增/重塑 agent 行为,因此未单独跑 writing-skills 对抗式 eval。验证手段:

  • scripts/audit.sh(仓库自带质量审计:frontmatter / 结构层级 / 交叉引用)→ 78 PASS / 0 FAIL
  • 与上游 v6.0.3 原文做标题结构逐行 diff,确认层级对齐;「创建工作树」代码块与上游逐字一致
  • 全文扫描确认两文件无 ~/.config/superpowers 残留;所有"跳到步骤 N"引用均指向存在的步骤
  • 两文件 description 字段未改 → skill 触发行为不变

严格性

  • skills 改动:改动为上游行为同步,非新行为设计;用仓库 audit + 与上游结构 diff 验证(见上)。跑 writing-skills 新增对抗 eval,理由如「评估」节所述
  • 这个改变经过了结构/一致性核验,而不仅仅是正常路径
  • 我没有在未经评估证明的情况下修改精心调整的内容(红旗表格、合理化描述、"人类搭档"用语等均未触碰)

人工审核

  • 提交前已有人工审核过完整的 diff

上游 v6.0.0 废弃了 ~/.config/superpowers/worktrees/ 全局目录,worktree
统一落到项目内 .worktrees/。本提交同步该行为变更:

- using-git-worktrees: 删除目录选择中的全局目录分支、安全验证豁免说明、
  创建代码块里的全局路径分支及快速参考表行;目录优先级表述改为
  「明确 instructions > 现有项目本地目录 > 默认」。顺带修复既有的步骤
  编号缺口(0,1,3,4 → 0,1,2,3)并校正 3 处步骤交叉引用,使其与上游
  v6.0.3 标题结构逐行对齐。
- finishing-a-development-branch: 两处 worktree 清理判定移除全局目录。

验证:scripts/audit.sh 78 PASS / 0 FAIL;与上游 v6.0.3 原文标题结构
对齐;两文件无 ~/.config/superpowers 残留。description 未改,skill
触发行为不变。

关联 #19(v6 同步追踪)
@jnMetaCode

Copy link
Copy Markdown
Owner Author

ℹ️ 关于 CI:「全量审计」红是 既有问题,与本 PR 无关

  • 与本 PR 改动相关的 「Validate skills and structure」检查 pass
  • 「全量审计」的 4 个 FAIL 全部是 hooks/session-start + brainstorm server.cjs/start-server.sh/stop-server.sh上游 v6.0.0 漂移(上游给 brainstorm 可视化伴侣换了新安全模型)。这几个文件不在本 PR diff 内
  • main 分支当前的 Audit workflow 本身就是 failure(如 commit 8dc606d3),证明这是 PR 之前就存在的状态。

本 PR 只动两个 worktree SKILL.md(+11/-26)。brainstorm/hooks 的 v6 同步是另一块独立欠账,会单独提 PR。

@jnMetaCode jnMetaCode merged commit c72ab42 into main Jun 19, 2026
1 of 2 checks passed
jnMetaCode added a commit that referenced this pull request Jun 20, 2026
对齐上游 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。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant