企业官网建设流程全解析

architect agent详解：用everything-claude-code做系统设计、技术选型与权衡分析

【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-code

在 AI 辅助开发越来越普及的今天，很多人只让 AI 写代码，却忽略了"动手之前先设计"这一步。everything-claude-code 是一款专为 Claude Code 打造的开源配置工具箱（agents、commands、skills、rules、hooks 一应俱全），其中的architect agent（架构师智能体）就是为系统设计、技术选型与权衡分析而生的"虚拟首席架构师"。它能自动审查现有架构、输出设计提案、记录决策依据（ADR），并帮你识别"大泥球"等 8 大架构反模式。

本文将带你快速上手这个架构师智能体，看懂它的四步审查流程、权衡分析方法，以及如何让它与项目中的其他智能体协同工作。

一、architect agent 是什么？

architect agent 定义在 agents/architect.md 中，本质是一份"角色提示词"：它让 AI 扮演一位专注于可扩展、可维护系统设计的资深软件架构师。

它的职责清单非常明确（见 agents/architect.md）：

值得注意的两个细节：

• 只读工具集：它只配备Read、Grep、Glob三个工具，不会直接改代码，而是输出分析和建议，天然避免了"AI 一边设计一边乱改"的风险；
• 顶级模型驱动：配置中指定model: opus，用最强模型处理最重要的架构决策。

二、快速上手：安装与调用 architect agent

1️⃣ 获取配置

两种方式任选：

# 方式一：克隆仓库 git clone https://gitcode.com/GitHub_Trending/eve/everything-claude-code

# 方式二：在 Claude Code 中直接安装为插件 /plugin marketplace add affaan-m/everything-claude-code /plugin install everything-claude-code@everything-claude-code

若手动安装，只需把 agents 目录下的文件复制到你的配置目录即可：

cp everything-claude-code/agents/*.md ~/.claude/agents/

2️⃣ 调用方式

项目通过 rules/agents.md 定义了智能体调度规则：当你提出"架构决策"类需求时，Claude Code 会无需额外提示自动调用 architect agent（原文即 "Architectural decision - Use architect agent"）。

实际使用时，你只需要自然语言描述需求，例如：

"我们要给系统加一层消息队列，帮我评估一下用 Kafka 还是 Redis Stream？"

"这个大模块准备重构，先做架构层面的分析和权衡。"

此外，项目还提供了 commands/orchestrate.md 编排命令，其中refactor工作流的起点正是架构师：

refactor: architect -> code-reviewer -> tdd-guide security: security-reviewer -> code-reviewer -> architect

三、系统设计四步法：architect 的分析流程

architect agent 不是拍脑袋出方案，它内置了一套标准架构审查流程（agents/architect.md），每一步都有明确的交付物：

Step 1：现状分析（Current State Analysis）

• 审查现有架构，识别既有模式和约定
• 记录技术债务
• 评估当前的可扩展性局限

Step 2：需求收集（Requirements Gathering）

• 功能需求 + 非功能需求（性能、安全、可扩展性）
• 集成点、数据流要求

Step 3：设计提案（Design Proposal）

• 高层架构示意图
• 各组件职责划分
• 数据模型与 API 契约
• 集成模式

Step 4：权衡分析（Trade-Off Analysis）⭐

这是最有价值的一步——对每一个设计决策，它都要求记录四要素：

也就是说，你问它"用 A 还是 B"，它不会只给你一个答案，而是给你一份带推理过程的决策报告——这正是它区别于普通"写代码 AI"的核心能力。

四、技术选型落地：架构决策记录（ADR）

对重要选型，architect agent 会按标准格式输出ADR（Architecture Decision Record，架构决策记录），格式定义见 agents/architect.md。

以它内置的一个真实示例为例——为语义搜索选择向量存储：

# ADR-001: 使用 Redis 存储语义搜索向量 ## 背景 需要存储和查询 1536 维的嵌入向量，用于语义市场搜索。 ## 决策 选用支持向量搜索的 Redis Stack。 ## 后果 ✅ 正面：向量相似性搜索 <10ms、内置 KNN、部署简单 ❌ 负面：内存存储成本高、无集群时是单点、仅限余弦相似度 ## 备选方案 - PostgreSQL pgvector：更慢，但持久化 - Pinecone：托管服务，成本更高 - Weaviate：功能更多，配置更复杂 ## 状态：Accepted

💡为什么 ADR 很重要？几个月后团队争论"当初为什么选 Redis"时，这份记录就是答案。技术选型不只是"选什么"，更是"留痕"。

五、五大架构原则：它的设计底线

architect agent 内置了五类架构原则作为评审标尺（agents/architect.md），你可以把它理解成"自动检查清单"：

六、内置设计模式工具箱

除了原则，它还自带一份常用设计模式清单，覆盖前后端与数据层（agents/architect.md）：

• 前端模式：组件组合、容器/展示器分离、自定义 Hooks、Context 全局状态、代码分割
• 后端模式：仓储模式、服务层、中间件、事件驱动架构、CQRS（读写分离）
• 数据模式：规范化/反规范化取舍、事件溯源、缓存层、最终一致性

这些模式与项目中的 skills/frontend-patterns/SKILL.md、skills/backend-patterns/SKILL.md 技能包以及 rules/patterns.md 通用模式规则（如统一 API 响应格式、仓储接口定义）相互呼应，形成完整的知识体系。

七、设计清单与 8 大"危险信号"

architect agent 在评审时还会跑一份四段式检查清单（agents/architect.md）：

• ✅功能需求：用户故事、API 契约、数据模型、UI 流程
• ✅非功能需求：性能指标、安全要求、可用性目标
• ✅技术设计：架构图、数据流、错误处理、测试策略
• ✅运维：部署策略、监控告警、备份恢复、回滚方案

同时，它内置了 8 大架构反模式"红旗"清单（agents/architect.md），一旦识别就会警告你：

八、组合拳：与 planner、code-reviewer 等智能体协同

architect agent 的真正威力在于"团队作战"。everything-claude-code 提供了完整的智能体矩阵（rules/agents.md）：

配合 commands/orchestrate.md，一条命令即可串联整条流水线：

/orchestrate refactor "把支付模块拆成独立服务" # 实际执行: architect 出架构方案 → code-reviewer 审查 → tdd-guide 落地

每个智能体之间通过结构化的交接文档（上下文、发现、修改文件、遗留问题、建议）传递信息，最后汇总成一份带 SHIP / NEEDS WORK 结论的编排报告。

九、总结

一句话概括：让 architect agent 先当"架构师"，再让其他智能体当"工程师"——这正是 everything-claude-code 这套配置工具想要传达的 AI 辅助开发理念：先设计、后编码，每一步决策都有据可查。

想深入了解整套体系的安装与用法，可以参考项目说明 README.md 与贡献指南 CONTRIBUTING.md。

【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-code