用途:该技能在系统设计、代码质量评审、实现与重构时提供软件工程最佳实践参考,帮助避免常见反模式。
主要能力:给出核心原则(简单、单一职责、自解释、快速失败、以行为为测试对象、一致性);SOLID 及其违规信号;分层架构(表现层→应用层→领域层←基础设施层,依赖只向下,领域层不依赖任何东西,基础设施实现领域接口,禁止循环依赖);常用设计模式及适用场景;安全实践(校验所有外部输入、加密敏感数据、不记录密钥、参数化查询、转义输出);命名与自解释代码规范;错误处理规则(禁止空 catch、只捕获能处理的、崩溃优于静默失败);文件组织与同事测试;代码坏味道与修复方式;lint 工具分类;测试金字塔、测试内容取舍、BDD 结构与反模式;评审清单(正确性、设计、可读性、安全、性能、测试);重构手法;技术债处理;性能优化时机;文档取舍;AI 生成代码特有问题(重复陈述注释、样板膨胀、过早抽象、约定漂移、仪式化错误处理、孤立接口、占位逻辑、过度类型化、幻觉 API、复制粘贴签名);机械与主观两类代码健康维度;修复优先级 T1-T4。
使用方式:资料未提供安装命令、调用方式或接口,仅作为知识型技能内容使用。
适用场景:设计系统、评审代码质量、编写新代码、重构和维护、评审 AI 生成代码。
限制:资料未说明平台支持、许可、收费或运行环境;内容为通用指导,具体项目约定应优先遵从现有惯例。