利用 Uncle Bob 软件工艺原则优化代码质量与架构 #

通过将 Robert C. Martin（Uncle Bob）的软件工艺体系（Clean Code, Clean Architecture, SOLID 等）集成到 AI 工作流中，解决代码质量低下、架构边界模糊以及过度设计等问题。

为什么需要这个技能 #

在快速迭代的开发中，代码容易陷入“僵化”和“脆弱”的状态：微小的改动可能引发大面积崩溃，或者为了增加一个功能需要修改大量不相关的文件。

虽然 Linter 和 Formatter 可以解决缩进和语法风格问题，但它们无法告诉你“依赖方向是否正确”或“类是否承担了过多职责”。本技能让 AI 扮演一个资深的软件架构师，基于 SOLID 原则、依赖规则（Dependency Rule）和代码味道（Code Smells）来审视代码，确保软件在长期演进中依然保持灵活且可维护。

适用场景 #

• 深度代码评审 (Code Review)：检查依赖是否向内指向，识别 SOLID 原则违背之处。
• 架构方案讨论：定义层级边界，确保业务逻辑不与数据库或 UI 等细节耦合。
• 代码重构决策：决定何时该提取函数、何时该引入设计模式，避免盲目地进行“企业级”过度设计。
• 专业实践指导：在估时、应对压力和 TDD（测试驱动开发）流程中应用《The Clean Coder》的专业主义标准。

核心工作流 #

1. 代码评审模式 #

当要求 AI 评审代码时，重点关注以下维度：

• 边界与依赖：检查依赖是否指向核心业务逻辑（向内），而非外围实现。
• 上下文 SOLID：在具体代码段中寻找单职责原则（SRP）或依赖倒置原则（DIP）的违例。
• 识别味道：扫描代码是否存在僵化（Rigidity）、脆弱（Fragility）或不透明（Opacity）等特质。
• 具体建议：要求 AI 提供 1-2 个具体的重构动作（如：“将此逻辑提取为名为 X 的函数”）。

2. 编写与重构模式 #

• 极小化原则：优先编写职责单一的小函数。
• 按需引入模式：仅在出现第三次重复或第二个变更维度时才引入设计模式，拒绝“为了用模式而用模式”的货B崇拜（Cargo Cult）。
• 小步快跑：确保每次重构步骤极小且测试始终通过。

3. 评审提示词示例 #

你可以直接要求 AI： 请使用 @uncle-bob-craft 标准评审此变更：1. 检查依赖规则与边界；2. 识别 SOLID 违例；3. 列出代码味道（如僵化、脆弱等）；4. 提供 1-2 个具体的重构建议。不要关注格式问题，专注于结构与设计。

下载和安装 #

下载 uncle-bob-craft 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要 #

暂无推荐