senior-architect

senior-architect skill 概览

senior-architect 适合解决什么问题

senior-architect 是一个 Software Architecture skill，用于把模糊的系统设计问题转化为结构化的架构决策、图表、依赖关系审查和实现取舍。它更适合需要架构方案、ADR 风格推理、技术栈对比、可扩展性评审，或代码库级架构评估的用户，而不是只想要一段泛泛的头脑风暴回答。

最适合的用户与任务

当你需要在 monolith、modular monolith、microservices、event-driven、CQRS、hexagonal 或 clean architecture 等架构模式之间做选择时，可以使用 senior-architect skill。它也适合正在评审现有仓库的团队，因为内置的 Python 脚本可以扫描项目结构、推断架构分层、检测耦合，并生成 Mermaid、PlantUML 或 ASCII 图。

它的不同之处

这个 skill 把提示词指导和可落地的仓库分析工具结合在一起。它的参考资料覆盖架构模式、系统设计流程和技术决策矩阵；它的脚本可以生成项目图表、分析依赖关系并进行架构评估。当你需要基于代码库证据做判断时，它比普通的“act as a senior architect”提示词更实用。

采用前需要注意的限制

这些脚本是启发式扫描器，不是正式的架构验证器。它们最适合常规项目结构，以及 Node、Python、Go、Rust、Java、Docker、Kubernetes 等常见生态。对于高度定制的 monorepo，生成结果应作为评审起点，而不是最终决策依据。

如何使用 senior-architect skill

senior-architect 的安装方式和优先阅读文件

通过 GitHub skill directory 安装：

npx skills add alirezarezvani/claude-skills --skill senior-architect

安装后，先阅读 SKILL.md，了解触发范围和命令示例。然后查看：

• references/architecture_patterns.md：了解架构模式取舍，以及“何时不该使用”的建议
• references/system_design_workflows.md：了解容量规划、API 设计、迁移和可扩展性工作流
• references/tech_decision_guide.md：了解数据库、缓存、队列、认证、前端、云平台和 API 风格选择
• scripts/architecture_diagram_generator.py
• scripts/dependency_analyzer.py
• scripts/project_architect.py

这条阅读路径能帮助你在依赖输出之前，同时理解它的推理框架和可运行的分析工具。

哪些输入能产出更好的架构建议

senior-architect skill 在同时获得业务背景和技术约束时效果最好。一个较弱的提示是：“Design a scalable backend.” 更好的提示是：

Use senior-architect for Software Architecture. Design an architecture for a B2B analytics app with 50k tenants, 5M daily events, PostgreSQL today, Python/FastAPI backend, React frontend, AWS deployment, 99.9% availability target, small team of 6, and a requirement to support tenant-level data isolation. Compare modular monolith vs microservices, include risks, ADR summary, and a Mermaid component diagram.

有价值的输入包括：预期用户量、请求量、读写比例、延迟目标、可用性目标、数据保留要求、合规需求、团队规模、部署环境、当前技术栈、迁移约束，以及已经否决过的方案。

senior-architect 的实用工作流

对于新系统，先从参考工作流开始：澄清功能需求、估算规模、识别非功能需求，然后要求给出带取舍分析的候选架构。对于现有代码库，在请求建议之前先运行脚本：

python scripts/architecture_diagram_generator.py ./my-project --format mermaid

python scripts/dependency_analyzer.py ./my-project --output json

python scripts/project_architect.py ./my-project --verbose

把最相关的发现粘贴到提示词里：检测到的架构模式、耦合分数、循环依赖、缺失的分层、包管理器，以及任何建议。这样模型会基于明确证据作答，而不是被迫从模糊描述中猜测架构。

用于决策和评审的提示词模式

对于设计决策，要求使用明确的决策格式：背景、选项、决策标准、推荐方案、被否决的替代方案、风险、迁移计划和开放问题。对于架构评审，要求 skill 区分“观察到的事实”“解释判断”和“建议修改”。这能减少过度自信的架构建议，也更容易把输出转化为 ADR、路线图事项或工程提案。

senior-architect skill 常见问题

senior-architect 只适合大型系统吗？

不是。它也能帮助小团队选择简单架构，避免过早引入 microservices。内置的架构模式参考明确覆盖了 monolith 和 modular monolith 的取舍，因此当最佳答案是“保持简单”时，这个 skill 同样有用。

它比普通架构提示词好在哪里？

普通提示词主要取决于你记得提供哪些信息。senior-architect skill 增加了可复用的决策流程、架构模式参考、技术对比矩阵和代码库扫描脚本。当你需要可重复的架构评审，而不是一次性建议时，这种组合尤其有价值。

新手可以使用这个 senior-architect skill 吗？

可以，但新手应该把它当作引导式决策辅助，而不是权威结论。可以要求它解释取舍、定义术语，并标注假设。如果你还不清楚规模、可用性目标或运维约束，应先让 skill 列出缺失问题，再让它推荐设计。

什么时候不该使用它？

不要把它作为安全关键、重合规或生产迁移决策的唯一依据。它也不能替代性能分析、负载测试、云成本建模，或针对特殊业务领域的专家评审。对于底层实现 bug，使用面向具体语言的调试 skill 可能更合适。

如何改进 senior-architect skill 的使用效果

用可衡量约束改进 senior-architect 输入

最常见的失败模式是架构建议听起来合理，但无法执行。改进结果的方法是补充数字：用户量、每秒请求数、存储增长、峰值倍数、延迟预算、可用性目标、团队规模、发布频率和成本上限。即使是粗略估算，也比“高并发”或“企业级”这类形容词更有帮助。

先使用仓库证据，再请求变更建议

对于现有项目，请包含脚本输出和简短的文件树摘要。说明代码是否使用 controllers/services/repositories、domain/application/infrastructure 文件夹、Docker、Kubernetes、消息队列，或多个可独立部署的服务。这能帮助 senior-architect 区分有意设计的架构和偶然形成的目录命名。

从总体设计迭代到具体交付物

不要停留在第一版架构方案。继续追问 ADR、Mermaid 图、迁移步骤、风险清单、数据库选择、API 边界或服务归属模型。一个有效的迭代路径是：高层设计 → 取舍对比 → 选定架构 → 图表 → ADR → 分阶段实施计划。

警惕过度设计和缺失假设

如果输出建议采用 microservices、event sourcing、CQRS 或分布式消息，追问为什么额外的运维复杂度是值得的。如果假设不完整，要求重新回答，明确未知项，并给出更简单的默认方案。使用 senior-architect 的最佳方式，是让设计与团队能力保持一致，而不只是追求理论上的可扩展性。