software-architect-plugin
基于经典设计哲学，提供结构化代码架构分析与优化建议。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：software-architect-plugin。 它的用途是：基于经典设计哲学，提供结构化代码架构分析与优化建议。 完整的 Skill 内容见：https://321skill.com/skills/software-architect-plugin/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
`/software-architect red-flags`，它会扫描当前代码上下文，并生成一份报告，列出代码中可能存在的九大类设计“红旗”问题，例如信息泄露、浅模块等，并给出具体的代码位置和改进建议。或者，你可以说`/software-architect review app.js`，让它对指定文件进行全面的架构审查。
介绍
Software Architect Plugin 旨在帮助开发者系统性地分析和改进代码架构质量。它基于 John Ousterhout 的《软件设计的哲学》和 Jeff Dean 的性能提示等经典理论，将抽象的架构原则转化为可执行的检查项，帮助识别代码中的设计缺陷和潜在风险。
该插件提供多种分析模式，用户可以通过简单的命令（如 /software-architect red-flags 或 /software-architect depth）对代码库进行扫描。它会生成结构化的报告，指出诸如“浅模块”、“信息泄露”、“临时分解”等九大设计“红旗”，并评估模块深度、复杂度、功能核心/命令外壳模式（FCIS）的遵循情况，以及代码注释、命名、一致性等细节质量。
它非常适合那些希望提升代码可维护性、减少技术债务的软件工程师、架构师和技术负责人。无论是审查新代码、重构遗留系统，还是在日常开发中培养良好的设计习惯，这个插件都能提供基于理论的、客观的评估视角。
建议将此插件作为代码审查流程的补充工具。它提供的是一种诊断视角，而非绝对标准。最佳实践是将分析结果作为团队讨论和改进的起点，结合具体业务上下文来权衡和采纳建议，避免机械地追求理论上的“完美”。
核心特点
其核心区别在于严格遵循《软件设计的哲学》等经典著作的理论体系，提供了系统化、可量化的架构质量评估框架（如九大红旗、模块深度分析），而非零散的最佳实践提示。同时，它针对 Claude Code 子代理场景进行了优化，输出高度结构化，便于集成到自动化流程中。
注意事项
该工具侧重于架构和设计层面的静态分析，不适合用于检查代码语法错误、运行性能剖析或进行动态测试。
常见问题
这个插件和普通的代码检查工具（如 ESLint）有什么区别？
ESLint 等工具主要检查代码风格和语法问题，而本插件专注于更高层次的架构设计质量，如模块划分、依赖关系、复杂度控制等，基于软件设计理论进行诊断。
我需要安装其他依赖才能使用吗？
不需要额外依赖。它是一个 Claude 插件，安装后即可在 Claude Code 环境中通过特定命令调用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/software-architect-plugin/raw/index.md 读取 software-architect-plugin 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/software-architect-plugin/raw/index.md（查看排版版本）