Combo with superpowers

与 superpowers 组合使用

ai-coding-ok 和 superpowers 如何协同工作——一个提供跨会话记忆，一个提供会话内的深度思考。

---

分工

	superpowers	ai-coding-ok
主要价值	让 Claude 深度思考一件事	让 Claude 长期一致地做一堆事
时间尺度	单次会话内	跨会话、跨月份
机制	多 sub-agent"发散+收敛"	三层记忆"记录+召回"
触发	规划、调研、研究	每次编码任务（前+后）
典型产出	设计文档、调研报告、方案对比	更新的 AGENTS.md、decisions-log.md、task-history.md

直觉： superpowers 是"脑力工作坊"，ai-coding-ok 是"组织记忆档案馆"。两者配齐才能让 AI 编程像真正的团队。

---

组合流程

1. ai-coding-ok Mode B  （规划：加载记忆）         ← 每次任务从这里开始
2. superpowers          （头脑风暴 → 规划 → 执行）
3. ai-coding-ok Mode C  （记录：写回记忆）          ← 每次任务在这里结束

ai-coding-ok 包裹在 superpowers 外面——先加载上下文再开始思考，思考结束后记录结果。

---

五个实战配方

配方 1：新项目启动（头脑风暴 → 固化）

1. superpowers：

   "设计一个个人记账工具的架构方案，对比三种技术栈。"

   → 获得 3 个方案的权衡分析。

2. 你选一个方案。

3. ai-coding-ok：

   "项目：个人记账工具。技术栈：Python + FastAPI + SQLite。记录决策。"

   → ai-coding-ok 将 ADR-001 写入 decisions-log.md，附选择理由。

效果： 下次会话，AI 读取 decisions-log.md 就知道为什么选 SQLite——无需重新调研。

---

配方 2：修复复杂 Bug（调研 → 修复 → 记录）

1. ai-coding-ok Plan 阶段： AI 读取 project-memory.md → 查"已知问题"表。这个 bug 是不是老熟人？

2. 如果是新 bug，上 superpowers：

   "用 debug 深度分析这个生产环境报错，找到根因。"

3. 修复后，ai-coding-ok Act 阶段： AI 将根因和修复方法写入 project-memory.md 的"常见坑"表 + task-history.md。

效果： 同类 bug 第二次出现 → Plan 阶段 3 秒命中记忆 → 跳过整轮 superpowers 调研。

---

配方 3：架构重构（规划 → 执行 → 归档）

1. superpowers：

   "评估将模块 X 从同步改为异步的成本和收益。"

2. 你拍板。

3. ai-coding-ok 保证执行：

   • Plan 阶段：将重构拆成可验证的小步骤
   • Check 阶段：每步跑测试
   • Act 阶段：写入 ADR-XXX 到 decisions-log.md

效果： 半年后回头看了解决策：为什么重构、怎么做的、踩了哪些坑——decisions-log.md 全有。

---

配方 4：跨天多会话长跑任务

一个功能做 3 天，中间要开好几次 Claude Code。

1. Day 1 开工：

   "添加用户认证" → ai-coding-ok Plan：读取记忆

2. Day 1 收工：

   "更新 task-history，下次继续时从这里开始。"

3. Day 2 开工：

   "继续 TASK-037。" AI 读取 task-history → 立刻知道从哪里继续。

4. 需要新组件？ 上 superpowers：

   "调研最适合我们技术栈的 JWT 库。"

效果： 3 天任务没有一秒钟浪费在"重新建立上下文"上。

---

配方 5：团队新人 Onboarding

新队友接手项目：

1. 他 clone 项目（已有 ai-coding-ok）
2. 他问 Claude：

   "从项目记忆中给我一份 15 分钟上手指南。用 superpowers 深度解析最复杂的模块。"

Claude 会：

• 从 project-memory.md 提取架构摘要
• 从 decisions-log.md 列举关键决策
• 从 task-history.md 总结近期工作
• 用 superpowers 对指定模块做深度解析

效果： 新人 Day-1 即战力，无需老司机陪读文档。

---

反模式：别这么做

❌ 用 superpowers 做日常 CRUD

加字段、修 typo、写简单接口——ai-coding-ok 的 PDCA 足够。用 superpowers 是杀鸡用牛刀，白烧 token。

❌ 用 ai-coding-ok 做头脑风暴

ai-coding-ok 是记录系统，不是思考系统。需要发散思维立刻切 superpowers。

❌ 让两个 skill 写同一个文件

可能冲突。分工：

• superpowers 产出"方案文档"→ 放 docs/
• ai-coding-ok 记录"方案摘要+理由"→ 写 decisions-log.md

---

兼容性细节

ai-coding-ok v2.0+ 内置 superpowers 兼容：

1. AGENTS.md hook： superpowers 的 brainstorming 读取 AGENTS.md 时（第 1 步：探索项目上下文），会命中 PDCA 强制要求

2. writing-plans 集成： superpowers 生成的计划自动在末尾包含"任务 N+1：更新项目记忆"

3. 双路径覆盖： 无论用 superpowers 还是直接 ai-coding-ok，PDCA 都会执行

---

下一步

• PDCA 工作流 — 包裹 superpowers 的循环
• 四种模式 — Mode B/C 如何与 superpowers 集成
• 日常开发流程 — 日常使用实践