ub-mode

ub-mode 是什么

ub-mode 是 Uncle Bob（Robert C. Martin）发布的一个 AI 代理技能（agent skill）。它的目标很直接：当 AI 代理帮你写代码或改代码时，强制它遵守一套有纪律的软件工程原则，而不是随手生成一堆能跑但难维护的代码。

它参考了 @poteto 的 poteto-mode / pstack 规则并做了精简，同时搭配几个确定性的质量门禁工具，让「好不好」不再只靠感觉。

核心理念：三步走

1. 先让它能工作（First Make it Work）

包括惰性协议、基础性思考、TDD、从第一性原理重新设计、攻击前提、先减后加、结果导向执行、构建杠杆，以及架构层面的纪律：

• 为领域建模
• 边界纪律
• 类型系统纪律
• 让操作幂等
• 共享状态先分离再序列化

2. 再让它正确（Then Make it Right）

• 修复根因而非症状
• 把工作拆成可验证的小单元
• 测试行为而非实现
• 用配套工具做量化门禁
• 持续重构

3. 日常实践（Practice）

• 保持工作日志
• 守护上下文窗口
• 清理 worktree
• 小步、有序地提交并推送

配套质量门禁工具

ub-mode 本身是规则，真正的「硬约束」来自这些工具：

这些工具把「代码质量」变成了可测量、可比较的数字，代理和人都无法轻易糊弄过去。

如何接入

项目以单个 SKILL.md 文件分发。基本做法是把该文件放到你所使用代理的技能目录下，例如：

~/.claude/skills/ub-mode/SKILL.md
~/.cursor/skills/ub-mode/SKILL.md
~/.grok/skills/ub-mode/SKILL.md

然后在代理中调用 /ub-mode 即可启用。具体目录名与调用方式请以你所使用代理工具的文档为准。

适合谁用

• 已经在用 Claude Code、Cursor 等代理工具写代码的开发者
• 希望把 TDD、重构、小步提交等纪律固化进 AI 工作流的团队
• 关注复杂度、重复度、变异测试等量化指标的技术负责人

注意点

ub-mode 更偏方法论与规则集，本身不提供一键安装脚本；配套工具需要分别获取和配置。建议先在小项目上试用，确认代理行为符合预期后再推广到团队。