software-design-philosophy-skill
基于《软件设计的哲学》一书，为代码和架构设计提供指导的智能体技能。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：software-design-philosophy-skill。 它的用途是：基于《软件设计的哲学》一书，为代码和架构设计提供指导的智能体技能。 完整的 Skill 内容见：https://321skill.com/skills/software-design-philosophy-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请根据《软件设计的哲学》原则，评审我这段用户服务类的代码，它目前有500行，处理注册、登录、资料更新和消息推送。”，它会分析类的复杂度，判断其是否是一个“深模块”，并可能建议将消息推送等功能拆分到独立的模块中，以降低主类的复杂性和提高内聚性。
介绍
本技能旨在解决软件开发中常见的设计难题，如代码结构混乱、模块耦合度过高、命名不规范等。它基于John Ousterhout的经典著作《软件设计的哲学》，将其中关于降低复杂性、提升可读性和可维护性的核心原则，转化为AI Agent在开发过程中可随时调用的指导能力。
使用时，开发者可以在进行代码评审、架构讨论或重构时，向集成了此技能的AI助手提问，获取基于该哲学的具体设计建议。例如，询问某个类的设计是否合理，或者如何分解一个过于庞大的模块。技能会引用书中的核心概念（如深度模块、信息隐藏）来分析和回应。
它非常适合那些追求代码质量、希望系统学习并应用经典设计理念的开发者，尤其是面临复杂系统设计或遗留代码重构挑战的工程师。无论是经验丰富的架构师，还是希望提升设计能力的中级开发者，都能从中受益。
建议将此技能作为设计讨论的“第二意见”或学习工具。它提供的原则性指导需要结合具体的业务上下文和团队规范来应用。对于高度依赖特定框架或领域知识的微观实现细节，可能需要补充其他更具体的技能或专业知识。
核心特点
本技能并非泛泛而谈的“最佳实践”，而是紧密围绕《软件设计的哲学》一书中的具体概念（如“深度模块”、“信息隐藏”、“定义不存在的错误”），提供有理论依据、成体系的设计分析和建议。
注意事项
对于高度依赖特定技术栈（如某个前端框架）的组件级设计细节，或需要深入领域业务逻辑的架构决策，指导可能不够具体。
常见问题
这个技能和普通的代码审查工具有什么不同？
它不检查语法或风格，而是专注于基于经典设计哲学（如降低复杂性）来评估代码结构和模块设计，提供更高层次的设计原则指导。
我需要先读完《软件设计的哲学》这本书才能用吗？
不需要。技能本身会应用书中的概念。但了解书的内容能帮助你更好地理解和运用它的建议。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/software-design-philosophy-skill/raw/index.md 读取 software-design-philosophy-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/software-design-philosophy-skill/raw/index.md（查看排版版本）