我为什么把这两个 AI 编程技能开源了?
基于 Superpowers 框架增强的双模型开发技能包,包含计划审阅和代码审阅两大核心技能。让 AI 在写代码前先问清楚需求,在写代码时强制执行 TDD,在提交前自动审查。

我为什么把这两个 AI 编程技能开源了?
它不是让 AI 写得更快,而是让 AI 写得更对。
上周我做了一个决定:把我自己打磨了快一个月的两个 AI 编程技能开源了。
事情是这样的。自从开始用 AI 编程,我经历过几乎所有"AI 写的代码不能用"的经典场景:
- AI 二话不说开始写代码,写到一半发现需求理解错了
- 代码能跑,但没测试,改一行就怕崩三行
- 做着做着就跑偏,两小时后发现方向完全不对
- 代码越堆越多,最后成了一坨没人敢动的屎山
直到我遇到了 **Superpowers** 框架。
用了一周后,我的 AI 编程工作流彻底被重塑了。然后我基于 Superpowers 做了两个自己的技能,每天用,越用越顺手。现在,我把它们开源了。
项目地址:github.com/ddong0417lin-prog/My_skills
一、前置条件:你需要什么?
在开始之前,有几样东西需要先准备好。
必需条件
┌─────────────────────────────────────────────────────────┐
│ ✅ Claude Code 或兼容的 AI 编程助手 │
│ → 这是运行技能的基础平台 │
├─────────────────────────────────────────────────────────┤
│ ✅ Codex 访问权限 │
│ → 用于双重审阅(Codex 独立审查代码) │
├─────────────────────────────────────────────────────────┤
│ ✅ 基础 Git 知识 │
│ → 理解分支、提交、审阅流程 │
└─────────────────────────────────────────────────────────┘推荐条件
┌─────────────────────────────────────────────────────────┐
│ 🌟 Superpowers 框架 │
│ → 我的技能是基于 Superpowers 增强的 │
│ → 安装:/plugin install superpowers@superpowers-marketplace │
├─────────────────────────────────────────────────────────┤
│ 🌟 多 Agent 协作经验 │
│ → 理解主 Agent 和 teammate 的角色分工 │
├─────────────────────────────────────────────────────────┤
│ 🌟 TDD 实践经验 │
│ → 理解 RED-GREEN-REFACTOR 循环 │
└─────────────────────────────────────────────────────────┘安装步骤
# 1. 克隆或下载技能文件
git clone https://github.com/ddong0417lin-prog/My_skills.git
# 2. 将技能文件复制到你的技能目录
cp -r My_skills/dm-plan-review ~/.claude/skills/
cp -r My_skills/dm-code-review ~/.claude/skills/
# 3. 重启 Claude Code,技能自动加载就这么简单。
二、功能:这两个技能能做什么?
我的项目包含两个技能,一个管**计划**,一个管**代码**。
技能架构
My_skills
│
┌───────────────┴───────────────┐
↓ ↓
┌───────────────────┐ ┌───────────────────┐
│ dm-plan-review │ │ dm-code-review │
│ 双模型计划审阅 │ │ 双模型代码审阅 │
├───────────────────┤ ├───────────────────┤
│ 需求澄清 │ │ TDD 强制约束 │
│ PRD 文档生成 │ │ 并行/串行执行 │
│ Plan 制定 │ │ 任务间审查 │
│ Codex 双重审阅 │ │ 四阶段调试 │
└───────────────────┘ └───────────────────┘
│ │
└───────────────┬───────────────┘
↓
Implement.md
(状态跟踪文件)dm-plan-review - 双模型计划审阅
**核心功能:** 在写代码之前,先搞清楚要做什么、怎么做。
触发命令:/dm-plan-review <需求描述>
执行流程:
1. 需求澄清(使用 brainstorming)
└─ 苏格拉底式提问,确保需求明确
2. 编写 PRD 文档
└─ 功能需求、非功能性需求、技术方案
3. PRD 审阅(Codex)
└─ 检查完整性、可行性、一致性
4. 任务拆分(使用 writing-plans)
└─ 拆分为 2-5 分钟可完成的小块
5. 制定 Plan
└─ 阶段划分、并行任务识别、PRD 索引映射
6. Plan 审阅(Codex)
└─ 检查阶段划分、依赖关系、任务独立性
7. 创建 Implement.md
└─ 状态跟踪表格、PRD 需求覆盖追踪**输出文件:**
文件 | 用途
`prd.md` | PRD 需求分析文档
`plan.md` | 实施计划(含阶段划分、并行任务)
`Implement.md` | 实施状态跟踪
dm-code-review - 双模型代码审阅
**核心功能:** 在实现过程中,强制执行 TDD 和代码审查。
触发命令:/dm-code-review
执行模式选择:
┌─────────────────────────────────────────────────────────┐
│ 🔄 并行模式(子任务互不依赖) │
│ → 启动多个 teammate 并行执行 │
│ → 每个 teammate 独立实现,主 Agent 统一提交 │
├─────────────────────────────────────────────────────────┤
│ ➡️ 串行模式(子任务有依赖) │
│ → 主 Agent 按顺序执行 │
│ → 每个 task 完成后更新状态,最后统一提交 │
└─────────────────────────────────────────────────────────┘
TDD 强制流程(每个子任务):
1. RED: 编写测试用例,运行确认失败
2. GREEN: 实现功能代码,运行确认通过
3. REFACTOR: 重构代码,运行确认仍通过
4. 任务间审查:自我审查代码质量
5. 更新状态:📝 待提交
6. 等待阶段完成后统一 git commit**集成的 Superpowers 技能:**
Superpowers 技能 | 集成点
test-driven-development | TDD 强制约束
subagent-driven-development | 并行执行模式
requesting-code-review | 任务间审查
systematic-debugging | 四阶段调试
三、价值:这两个技能解决了什么问题?
让我用对比来说说。
问题一:AI 太"积极"了
**使用前:**
用户:帮我加个登录功能
AI:好的,开始写代码...
(写了 500 行后)
AI:完成了!
用户:等等,我要的是 OAuth 登录,不是邮箱密码...**使用后:**
用户:/dm-plan-review 帮我加个登录功能
AI:让我先确认几个问题:
- 你希望的登录方式是?邮箱密码、OAuth、还是无密码?
- 需要记住登录状态吗?
- 有什么安全要求?
(确认后再生成 PRD 和 Plan)**价值:** AI 先问清楚再动手,避免方向错了重写。
问题二:代码没有测试
**使用前:**
AI:功能完成了!
用户:有测试吗?
AI:呃...你需要我写测试吗?
用户:(心里一沉)**使用后:**
AI:子任务 1.1 完成!
TDD 流程记录:
- RED: 编写测试 src/parser.test.ts,测试失败 ✅
- GREEN: 实现 src/parser.ts,测试通过 ✅
- REFACTOR: 重构代码,测试仍通过 ✅**价值:** TDD 强制执行,每个功能都有测试覆盖。
问题三:做着做着就跑偏
**使用前:**
AI:(连续工作 2 小时后)
AI:完成了!
用户:这和我最初说的不太一样...**使用后:**
AI:阶段 1 完成,已提交 (commit: abc123)
请手动让 Codex 审阅:git show HEAD
(Codex 审查:发现与 PRD 需求不符)
AI:发现问题,正在修复...**价值:** 每个阶段都有 Codex 独立审查,提前发现偏差。
问题四:任务拆得太粗
**使用前:**
Plan:
- 实现用户系统(预计 8 小时)做到一半就乱成一团。
**使用后:**
Plan:
阶段 1: 基础架构 (2 小时)
├─ 1.1 初始化项目配置 | 🔄 可并行 | teammate-1
├─ 1.2 配置样式系统 | 🔄 可并行 | teammate-2
└─ 1.3 配置数据库连接 | 🔄 可并行 | teammate-3
阶段 2: 用户模块 (3 小时)
├─ 2.1 实现用户注册 | ➡️ 串行 | teammate-1
└─ 2.2 实现用户登录 | ➡️ 串行 | teammate-2**价值:** 任务拆分为 2-5 分钟小块,每个任务都有明确交付物。
四、实用性:真的能用吗?
实际使用场景
我这两个月用下来,典型的触发场景:
"做个新功能" | `/dm-plan-review 需求描述` | 先出 PRD 和 Plan,确认后再开始
"开始实现" | `/dm-code-review` | 按阶段执行,TDD 强制
"代码有问题" | `/dm-code-review --strict` | 严格审查,强制修复
"快速验证" | `/dm-plan-review --fast` | 一轮审阅,快速出计划
一些真实感受
**好的地方:**
- ✅ 需求澄清阶段真的会问问题,不再盲目开干
- ✅ TDD 强制执行,测试覆盖率有保障
- ✅ Codex 审阅确实能 catching 问题(尤其是边界情况)
- ✅ 阶段提交让 commit 历史很清晰
**需要适应的地方:**
- ⚠️ 流程比较长,简单改动会觉得繁琐
- ⚠️ 需要习惯"先签字确认再执行"的节奏
- ⚠️ 每阶段都要手动触发 Codex 审阅(我认为是优点)
适合谁用?
**强烈推荐:**
- 用 AI 做正经项目开发的人
- 希望代码有测试、可维护的人
- 经常被 AI 生成代码坑的人
- 需要多 Agent 协作的大型项目
**可能不适合:**
- 只想快速生成 snippets 的人
- 做原型验证、throwaway 代码的人
- 不喜欢被流程约束的人
总结
做这个项目的初衷很简单:
**我不想再被 AI 生成的代码坑了。**
Superpowers 给了我一个框架,我在这个框架上做了两个技能,每天用,越用越顺手。
现在我把它们开源了,希望能帮到更多被 AI 代码坑过的人。
如果你也在用 AI 编程,而且受够了"AI 写的代码不能用"这个问题,不妨试试这两个技能。
项目地址:github.com/ddong0417lin-prog/My_skills
**最后更新:** 2026-03-05
**相关文章:** Superpowers for Claude Code