code-quality-principles
应用KISS/YAGNI/SOLID原则编写简洁代码
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：code-quality-principles。 它的用途是：应用KISS/YAGNI/SOLID原则编写简洁代码 完整的 Skill 内容见：https://321skill.com/skills/code-quality-principles-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请检查我这段React组件代码是否符合KISS和SOLID原则，特别是单一职责和接口隔离。' 它会逐行分析并标记出违反原则的地方，例如指出一个组件同时负责数据获取、UI渲染和事件处理，建议拆分为三个独立组件。然后给出重构后的代码片段。
介绍
在开发过程中，代码复杂度往往随着功能迭代而失控，导致维护成本激增、Bug频出。本技能通过系统化应用KISS（保持简单）、YAGNI（你不会需要它）和SOLID五大设计原则，帮助你从源头降低代码复杂度，产出结构清晰、易于理解和扩展的代码。它能自动审查代码是否符合这些原则，并给出具体改进建议，避免过度设计和过早优化。
使用时，只需在编码过程中或代码审查阶段调用该技能，它会分析当前代码片段或整个模块，检测违反KISS、YAGNI、SOLID原则的模式，例如不必要的抽象、冗余的接口、违反单一职责的类等。然后它会输出具体的重构建议，甚至直接生成符合原则的代码示例，让你在真实场景中快速应用。
本技能尤其适合后端开发、前端开发和全栈开发人员，特别是那些在长期维护的项目中面临代码腐化问题的团队。对于正在学习设计原则的初中级开发者，它也能作为实时校验工具，帮助你理解每条原则在代码中的具体体现。
使用建议：不要一次性对整个大型代码库运行，建议按模块或功能切分后逐步审查。同时，该技能输出的建议需结合项目上下文判断，例如在性能敏感场景下可能需要适当权衡。定期（如每周）运行一次，可有效防止代码质量滑坡。
核心特点
不同于其他仅检查代码风格或语法的工具，本技能聚焦于KISS/YAGNI/SOLID原则的深层逻辑违规，能识别出过度设计、无用抽象、职责分散等复杂问题，并给出重构方向。
注意事项
不适合对已经高度耦合的遗留系统做全量自动重构，建议结合人工判断逐步改进。
常见问题
这个技能和SonarQube有什么区别？
SonarQube侧重代码质量指标和漏洞，本技能侧重设计原则层面的违规，比如类是否违反了单一职责、接口是否过度设计等。
能直接自动修复代码吗？
目前提供建议和示例代码，自动修复需要人工确认，因为涉及设计决策，不建议完全自动化。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/code-quality-principles-x-4/raw/index.md 读取 code-quality-principles 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/code-quality-principles-x-4/raw/index.md（查看排版版本）