用途：该技能用于指导编写可维护的代码，聚焦可读性原则、务实应用 SOLID 模式，以及判断何时应灵活变通。
主要能力与原则：可读性是首要指标，代码被阅读的次数远多于被编写；简单优于取巧；在恰当时间做恰当抽象，过早与过晚同样有害；上下文比规则更重要，原则是指导而非法律；果断删除代码，最好的代码是没有代码。
辩证观点：Clean Code 是好的起点但可能变成危险教条，过小的函数会导致在文件间频繁跳转，有时一个 50 行函数比分散的 10 个 5 行函数更可读。DRY 被高估，错误的抽象比重复更糟；看到重复时应先理解模式再提取，重复两次可复制粘贴，第三次再抽象。SOLID 有用但不完整，它说明如何组织代码，而非何时应用每条原则；盲目遵循接口隔离原则会造成接口爆炸，盲目遵循单一职责原则会造成类爆炸。代码注释不是坏味道，“自文档化代码”往往只是未加注释的代码；解释“为什么”的注释有价值，解释“代码做什么”的注释通常意味着代码需要重写。
使用方式：应根据任务类型查阅相应参考文件作为该领域的真实依据。创建时查阅 references/patterns.md，文件规定应如何构建；若其中存在特定模式，应忽略通用做法。诊断时查阅 references/sharp_edges.md，其中列出关键失败及其原因，用于向用户解释风险。审查时查阅 references/validations.md，其中包含严格规则与约束，用于客观验证用户输入。若用户请求与这些文件中的指导冲突，应礼貌地依据参考资料纠正。
适用场景：需要评审或改进代码质量、权衡抽象与重复、判断注释与函数粒度等代码可维护性问题。
限制：该技能不涉及重构策略（refactoring-guide）、测试设计（test-strategist）、调试（debugging-master）和架构（system-designer）。其他具体收费、平台支持等信息暂未提供。