mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
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
This commit is contained in:
AI不止语
@@ -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.3",
|
||||
"version": "1.7.4",
|
||||
"source": "./",
|
||||
"author": {
|
||||
"name": "jnMetaCode",
|
||||
|
||||
@@ -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.3",
|
||||
"version": "1.7.4",
|
||||
"author": {
|
||||
"name": "jnMetaCode",
|
||||
"url": "https://github.com/jnMetaCode"
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "superpowers-zh",
|
||||
"version": "1.7.3",
|
||||
"version": "1.7.4",
|
||||
"description": "AI 编程超能力中文增强版：头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流，附 4 个中文 skills 沉淀。",
|
||||
"author": {
|
||||
"name": "jnMetaCode",
|
||||
|
||||
@@ -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.3",
|
||||
"version": "1.7.4",
|
||||
"author": {
|
||||
"name": "jnMetaCode",
|
||||
"url": "https://github.com/jnMetaCode"
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "superpowers-zh",
|
||||
"version": "1.7.3",
|
||||
"version": "1.7.4",
|
||||
"description": "AI 编程超能力中文增强版：头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流，附 4 个中文 skills 沉淀。",
|
||||
"author": {
|
||||
"name": "jnMetaCode",
|
||||
|
||||
@@ -16,7 +16,8 @@ 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.3 更新亮点**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
|
||||
> 🆕 **v1.7.4 更新亮点**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
|
||||
> - 🔄 **SDD 同步上游 v6.2.0** —— plan 作用域工作区（一份过期账本再也不会让控制者跳过整段任务）+ 五轮上限的唤回式修复循环与熔断裁定
|
||||
> - 🪟 **Windows bootstrap 修复** —— SessionStart hook 改经 Git Bash 分发（同步上游），hook 不加载 skill 就是死重
|
||||
> - 🧩 新增 **Cline** 与 **Kilo Code** 两款 VS Code 扩展（工具数 20 → 22）—— 按 rules 常驻开销做了专门设计，索引仅 4.5 KB
|
||||
> - 🔧 检测落空时会扫 PATH 给出**可直接复制的 `--tool` 命令**，不再只报「未检测到」
|
||||
|
||||
@@ -16,7 +16,8 @@ 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.3 更新亮點**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
|
||||
> 🆕 **v1.7.4 更新亮點**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
|
||||
> - 🔄 **SDD 同步上游 v6.2.0** —— plan 作用域工作區（一份過期帳本再也不會讓控制者跳過整段任務）+ 五輪上限的喚回式修復循環與熔斷裁定
|
||||
> - 🪟 **Windows bootstrap 修復** —— SessionStart hook 改經 Git Bash 分發（同步上游），hook 不載入 skill 就是死重
|
||||
> - 🧩 新增 **Cline** 與 **Kilo Code** 兩款 VS Code 外掛（工具數 20 → 22）—— 針對 rules 常駐開銷做了專門設計，索引僅 4.5 KB
|
||||
> - 🔧 偵測落空時會掃 PATH 給出**可直接複製的 `--tool` 命令**，不再只報「未偵測到」
|
||||
|
||||
@@ -6,6 +6,67 @@
|
||||
|
||||
---
|
||||
|
||||
## v1.7.4 (2026-08-07)
|
||||
|
||||
### 🔄 SDD 同步上游 v6.2.0：plan 作用域工作区 + 基于唤回的修复循环（#19 A 块）
|
||||
|
||||
对齐上游 `subagent-driven-development` 的 6 个 commit。这是 [#19](https://github.com/jnMetaCode/superpowers-zh/issues/19) 拆分后的 A 块 —— 注意 v1.7.1 刚对齐过 SDD，本次是那之后的**新增量**。
|
||||
|
||||
**为什么脚本与文档必须整块一起改：** 我们的 SKILL.md 里写的是旧签名 `review-package BASE HEAD`。脚本换成 plan 作用域签名后若不同步改文档，agent 会照旧签名调用直接吃 usage 错误 —— 比不同步更糟。
|
||||
|
||||
**plan 作用域工作区（结构性修复）**
|
||||
|
||||
原先所有计划共用 `.superpowers/sdd/` 一个目录，一份过期账本被误读成当前进度会让控制者**跳过整段任务序列**（上游称之为观察到的最昂贵失败）。现在每个计划一个 `.superpowers/sdd/<计划文件名>/`，从结构上消除误读。账本新增身份行 `# SDD ledger — plan: <路径>`。
|
||||
|
||||
- `sdd-workspace` / `review-package` 在我们这边与上游 v6.1.1 字节一致（从未汉化），直接取上游版
|
||||
- `task-brief` 只手工应用上游那两处改动，**保留 fork 适配**（awk 同时匹配 `Task N` 与 `任务 N`，因为本仓库 writing-plans 产出中文标题）
|
||||
|
||||
**SKILL.md 全面重写（平铺 14 节 → 生命周期结构）**
|
||||
|
||||
- **修复循环**：一轮 = 一次修复分派 + 一次定向复审，每任务上限五轮。第 1-3 轮**唤回原实现者**（context 完整），第 4-5 轮换全新实现者 + 高一档模型
|
||||
- **熔断**：第 5 轮仍有未解决发现则停止分派，逐条裁定 —— 搁置（附裁定）或在承重项上 BLOCKED。只在上限处裁定，提早裁定等于换名字的预先定性
|
||||
- Minor 发现与「计划要求的」发现两条路在循环外
|
||||
- 新增「常见的合理化借口」表取代原「红线」清单
|
||||
- 新增 `re-review-prompt.md`（106 行全文翻译）
|
||||
|
||||
### 🧹 清除 v1.7.1 遗留的生成产物
|
||||
|
||||
三个 SDD 文件末尾都残留着 `</content>` —— v1.7.1 那次重写（PR #108, `d7885ca`）留下的，上游没有。这些文件会整体进 agent 的 prompt，属于污染。已全部清除并全仓扫描确认无同类残留。
|
||||
|
||||
### ✅ 验证（含行为 eval）
|
||||
|
||||
**结构性核对**
|
||||
- 章节结构与上游 14 节一一对应；`superpowers:` 引用集与上游完全一致
|
||||
- 26 项关键技术记号（脚本签名、账本行格式、四种状态、`ADDRESSED`/`NOT ADDRESSED`、数值门槛）逐一确认存在，无漏译
|
||||
- 两个 dot 图节点/边数与上游精确一致（6/6 与 23/28），且**无幽灵节点、无孤立节点** —— 手工翻译 dot 标签最易在边里写错，会静默产生幽灵节点
|
||||
|
||||
**脚本实测**（临时 git 仓库）
|
||||
- 两个计划各得独立目录；往 A 计划写 ledger 后 B 计划目录仍为空（关键回归）
|
||||
- `.gitignore` 落在 `.superpowers/sdd/` 层且 `git status` 干净
|
||||
- 中文「任务 2」与英文「Task 3」经新路径均抽取成功
|
||||
- `review-package` 旧签名正确报 usage 错误
|
||||
|
||||
**行为 eval —— 新机制 7 个场景全对**
|
||||
|
||||
考察译文是否真的传达了新规则（第 2 轮该唤回还是换新、第 4 轮模型档位、第 5 轮能否再开一轮、承重发现该搁置还是停下、Minor 走哪条路、遇到别的计划的账本怎么办、控制者能否自己修）：**7/7 正确**，连「运行环境无法唤回时才改派全新实现者」这个细节都答出。
|
||||
|
||||
**集成 eval —— 真实 agent 的准备阶段**
|
||||
|
||||
用 `tests/subagent-driven-dev/go-fractals` 脚手架跑真实执行的准备阶段，验证 agent 是否按**新签名**调脚本（旧习惯可能让它省掉 `PLAN_FILE`）：
|
||||
|
||||
- ✔ 实际调用 `sdd-workspace plan.md`，带上了 PLAN_FILE 参数
|
||||
- ✔ 同时检查了 plan 作用域账本**和**旧扁平路径的游离账本
|
||||
- ✔ 账本第一行为正确的身份行
|
||||
- ✔ 工作区落在 `.superpowers/sdd/plan/`，未在旧扁平路径写账本
|
||||
- ✔ 起飞前冲突扫描产出 5 条**打包成一次**的提问（而非逐条打断）
|
||||
- ✔ 建了 10 条待办，并按指令在分派实现者前停下
|
||||
|
||||
**回归**：`scripts/audit.sh` 150 pass / 0 fail、`scripts/verify-release.sh` 82 pass / 0 fail。SDD 已从 audit 的上游漂移警告里消失（结构层级现已对齐）。
|
||||
|
||||
> audit PASS 由 153 降至 150，是上游有意删除 Integration 一节（原列 `executing-plans` / `test-driven-development` / `writing-plans` 三个引用）导致 Category 4b 少 3 项引用检查，非静默跳过。
|
||||
|
||||
---
|
||||
|
||||
## v1.7.3 (2026-08-07)
|
||||
|
||||
### 🐛 同步上游两处纯代码修复（对齐 v6.1.1 → v6.2.0 时挑出）
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "superpowers-zh",
|
||||
"description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
|
||||
"version": "1.7.3",
|
||||
"version": "1.7.4",
|
||||
"contextFileName": "GEMINI.md"
|
||||
}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "superpowers-zh",
|
||||
"version": "1.7.3",
|
||||
"version": "1.7.4",
|
||||
"engines": {
|
||||
"node": ">=20.0.0"
|
||||
},
|
||||
|
||||
Reference in New Issue
Block a user