Superpowers 工作工程方法论（WorkBuddy 适配版）v1.4.0
> 基于 obra/superpowers 重制，专为 WorkBuddy 工具链适配。
> 与 marketplace 装的简化版（superpowers）并存，但本版多了 17 个 references（含 v1.4.0 新增的 writing-skills）。
v1.4.0 相对 v1.3.0 的变更
- 新增 1 个 reference：
references/writing-skills.md— 把 TDD 应用到 process 文档的方法论（SDO description 写法 + RED-GREEN-REFACTOR for skills + Bulletproofing 防借口）。用于写新 skill、编辑已有 skill、部署前验证。- 配套：
references/sub-skills-detail.md和references/superpowers-scenario-guide.md待 v1.4.x 后续版本用 writing-skills 的方法论重新审查纪律类 skill（TDD / verification / stopping conditions）
v1.3.0 相对 v1.2.0 的变更（历史）
- 新增 3 个 references：diagnosing-superpowers / using-superpowers / using-git-worktrees
v1.2.0 相对 v1.1.0 的变更（历史）
- 新增 3 个 references：executing-plans / verification-before-completion / receiving-code-review
- 修
workbuddy-tools.md引用断链
v1.1.0 相对 v0.1.0 的变更（历史）
- 新增
writing-plans.md（独立文件） - 修 SDD 停止条件 3 → 4 条
- 修 SKILL.md 9 项机制对照表
跟 marketplace 简化版的区别
| 关键机制 | marketplace 简化版 | 本版（obra-superpowers-workbuddy v1.4.0） |
|---|---|---|
| using-superpowers 入口纪律 | ❌ | ✅ |
| diagnosing-superpowers 诊断 | ❌ | ✅ |
| using-git-worktrees 工作区隔离 | ❌ | ✅ |
| Rulings, not stalls（自主裁决不停滞） | ❌ | ✅ |
| ledger 决策记录 | ❌ | ✅ |
| Fix round R of 5 | ❌ | ✅ |
| 子代理上下文隔离原则 | ❌ | ✅ |
| graphviz 决策树 | ❌ | ✅ |
| writing-plans 独立文件 | ❌ | ✅ |
| executing-plans 内联执行 | ❌ | ✅ |
| verification-before-completion | ❌ | ✅ |
| receiving-code-review | ❌ | ✅ |
| writing-skills skill 创建+验证（v1.4.0 新增） | ❌ | ✅ |
| TDD 反模式清单 | ❌ | ✅ |
| brainstorming 视觉伴侣（show_widget 版） | ❌ | ✅ |
| 多 WorkBuddy 工具 refs | ❌ | ✅ |
当前状态（2026-09-29 12:18）
| 块 | 状态 | 文件 |
|---|---|---|
| Q7 — writing-skills 引入（v1.4.0） | ✅ 完成 | references/writing-skills.md |
| Q6 — 入口纪律 + 诊断 + worktree（v1.3.0） | ✅ 完成 | 3 个 references |
| Q5 — 三大缺口补齐（v1.2.0） | ✅ 完成 | 3 个 references |
| Q4 — writing-plans 独立化（v1.1.0） | ✅ 完成 | references/writing-plans.md |
| Q3 — WorkBuddy 工具映射 | ✅ 完成 | references/workbuddy-tools.md |
| Q2 — 视觉伴侣（show_widget 版） | ✅ 完成 | references/visual-companion.md |
| Q1 — WorkBuddy 兼容性微调 | ✅ 完成 | 10 个 references |
| 总规模 | 20 个文件 / ~3900 行 / ~130 KB |
20 个文件
| 文件 | 大小 | 关键机制 |
|---|---|---|
subagent-driven-development.md |
12.1 KB | Rulings + ledger + Fix round R + fresh context |
brainstorming.md |
6.4 KB | 5 阶段流程 + show_widget 集成 |
test-driven-development.md |
7.3 KB | RED-GREEN-REFACTOR + 9 条反模式 + 9 种项目测试命令 |
requesting-code-review.md |
6.2 KB | 两段评审 + 3 级严重度 + 5 维代码质量 |
systematic-debugging.md |
7.9 KB | 4 阶段根因 + 7 类根因 + 5 层 defense-in-depth |
dispatching-parallel-agents.md |
9.1 KB | 同响应多 Agent + 3 种并行模式 + sweet spot |
finishing-a-development-branch.md |
7.9 KB | 5 步收尾 + 4 选项 + PR 描述模板 + backup 必做 |
visual-companion.md |
10.6 KB | show_widget 5 模式（含 mermaid 决策树） |
workbuddy-tools.md |
9.1 KB | 工具映射表 + Subagent dispatch |
writing-plans.md |
11.3 KB | plan.md 模板 + task 结构 + reviewer prompt + bite-sized 粒度 |
executing-plans.md |
11.8 KB | 内联执行 plan + task loop + completion contract + 整分支 review |
verification-before-completion.md |
5.5 KB | Iron Law + Gate Function 5 步 + 红线 + 防借口 |
receiving-code-review.md |
7.3 KB | Response Pattern 6 步 + 禁止回复 + YAGNI 检查 + 实现顺序 |
diagnosing-superpowers.md |
8.8 KB | 4 步 workflow + 分析师子代理 + bundle 导出 + 只报告不下诊断 |
using-superpowers.md |
6.0 KB | 铁律：1% 可能性就 invoke skill + 12 条红旗借口表 |
using-git-worktrees.md |
7.2 KB | 3 步：检测已隔离 / 创建（submodule 守卫） / setup + baseline |
writing-skills.md |
~10 KB | SDO + RED-GREEN-REFACTOR for skills + Bulletproofing 防借口 |
基础工作流（7 步）
> 每步详情见 references/<name>.md —— 加载时按需读。
> 任何动作前先 invoke 相关 skill（铁律，见 references/using-superpowers.md）。
- 头脑风暴 — 通过提问把粗糙想法打磨成规格；可用
show_widget做视觉对比。详见references/brainstorming.md。 - 开隔离工作区 —
git worktree新建分支（submodule 守卫 + gitignore 验证）。详见references/using-git-worktrees.md。 - 写实施计划 — 拆成 2-5 分钟一个的小任务，每个含精确路径 + 完整代码 + 验证步骤。详见
references/writing-plans.md。 - 执行计划 — 二选一：
- Subagent-Driven（推荐）：每个 task 派 fresh 子代理 + task 之间评审。详见references/subagent-driven-development.md。
- Inline Execution（内联）：本会话跑 task + 最后整分支 review。详见references/executing-plans.md。 - TDD — 强制 RED-GREEN-REFACTOR；测试前写的代码一律删除。详见
references/test-driven-development.md。 - 代码评审（双向）：
- 请求评审（reviewer 视角）：对照计划审查；Critical 级阻断推进。详见references/requesting-code-review.md。
- 接收评审（implementer 视角）：技术评估反馈，不表演同意。详见references/receiving-code-review.md。 - 收尾开发分支 — 验证测试，给出合并 / 开 PR / 保留 / 丢弃。详见
references/finishing-a-development-branch.md。
所有完成声明前：必须跑验证命令，铁律见 references/verification-before-completion.md。
superpowers 自己出错时：走 references/diagnosing-superpowers.md（4 步：问 → 定位 → 分诊 → 报告）。
写/编辑/验证 skill：走 references/writing-skills.md（SDO + RED-GREEN-REFACTOR for skills + Bulletproofing）。
4 条核心纪律（区别于简化版）
- Rulings, not stalls — 遇歧义自主决定 + 写进 ledger，不要停下来问 Howard（除非 4 种例外）。
- ledger 必写 — 每个决策一行
Ruling: <决定> — <理由> — <错了成本>。 - Fix round R of 5 — R≤3 同 implementer 续做，R≥4 换 Plan 重新拆解，R=5 停下来报 Howard。
- Fresh context per task — 每个子代理给完整自包含 prompt，不继承主会话历史。
停止条件（只有这 4 种）
- 不可逆 / 破坏性 操作（删库、drop table）
- 安全敏感 动作（写公开凭证、推送敏感数据）
- 跨 worktree 副作用（merge / push 到共享分支 / publish）
- 计划烂到所有路径都是猜——重构 plan 再继续
其他情况一律 Rulings, not stalls。
工具映射（Quick Reference）
完整映射见 references/workbuddy-tools.md。常用：
| 动作 | 工具 |
|---|---|
| 派子代理 | Agent(subagent_type="general-purpose") |
| 任务跟踪 | TaskCreate / TaskUpdate / TaskList |
| 读 / 写 / 改 文件 | Read / Write / Edit |
| 跑命令 | Bash / PowerShell |
| 找文件 / 搜内容 | Glob / Grep |
| 抓网页 / 搜网 | WebFetch / WebSearch |
| 调别的 skill | Skill(name=...) |
| 渲染可视化 | show_widget(widget_code=...) |
| 呈给 Howard | present_files(files=[...]) |
与 marketplace 简化版的关系
- marketplace 装的
superpowers：保留不动（市场版，已稳定） - 本版
obra-superpowers-workbuddy v1.4.0：完整 17 个 references + 16 项机制 + 4 条纪律 + 4 种停止条件 - 两者并存，不冲突；用户按需
@skill:obra-superpowers-workbuddy或@skill:superpowers
使用提示
Howard 启用本版时，我会自动加载：
1. 本 SKILL.md（必读）
2. 按需读取 references/ 下的具体文件
不会一次性把所有 facts 灌进 context——按 superpowers 自己的 verification-before-completion 纪律"按需加载"。
版权与许可证
本 Skill 基于 obra/superpowers 修改，遵循 MIT 许可证。
原作：
- 项目：obra/superpowers
- 作者：Jesse Vincent & contributors（Prime Radiant）
- 仓库：https://github.com/obra/superpowers
- 许可证：MIT License（原仓库 LICENSE 文件）
本修改版（obra-superpowers-workbuddy）：
- 修改者：Howard + 大钳子
- 修改时间：2026-09-22（v0.1.0）/ 2026-09-28（v1.1.0）/ 2026-09-28（v1.2.0）/ 2026-09-29（v1.3.0）/ 2026-09-29（v1.4.0）
- 修改内容：将原版方法论凝缩并适配 WorkBuddy 工具链（Agent 子代理 / TaskCreate 任务跟踪 / show_widget 视觉伴侣等）。v1.1.0：新增独立的 writing-plans.md，补齐 v0.1.0 缺失的写实施计划机制；移除对照表里与文档事实不符的 "Anthropic 最佳实践参考" 项；统一 subagent-driven-development.md 停止条件到 4 条。v1.2.0：新增 3 个 references（executing-plans / verification-before-completion / receiving-code-review），修复 workbuddy-tools.md 的引用断链。v1.3.0：新增 3 个 references（diagnosing-superpowers / using-superpowers / using-git-worktrees）。v1.4.0：新增 writing-skills（把 TDD 应用到 process 文档，用于创建/编辑/验证 skill）。所有文档均为重新撰写的 prose，未直接搬运原版源码。
完整 MIT 许可证文本见本 skill 文件夹根目录的 LICENSE 文件。
