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 agent1️⃣ 获取配置两种方式任选# 方式一克隆仓库 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-codeeverything-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⭐这是最有价值的一步——对每一个设计决策它都要求记录四要素要素内容✅ Pros收益与优势❌ Cons缺点与局限 Alternatives考虑过的其他方案 Decision最终选择及理由也就是说你问它用 A 还是 B它不会只给你一个答案而是给你一份带推理过程的决策报告——这正是它区别于普通写代码 AI的核心能力。四、技术选型落地架构决策记录ADR对重要选型architect agent 会按标准格式输出ADRArchitecture 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一旦识别就会警告你反模式白话解释Big Ball of Mud大泥球结构混乱、无章可循Golden Hammer金锤子什么问题都用同一个方案Premature Optimization过早优化还没跑通就开始抠性能Analysis Paralysis分析瘫痪规划过度、动手不足God Object上帝对象一个类啥都干Tight Coupling紧耦合组件互相依赖到拆不开八、组合拳与 planner、code-reviewer 等智能体协同architect agent 的真正威力在于团队作战。everything-claude-code 提供了完整的智能体矩阵rules/agents.md智能体定位与架构师的关系planner实现规划架构定调后把方案拆成可执行步骤code-reviewer代码审查实现完成后按架构标准把关security-reviewer安全分析与架构安全原则双重校验tdd-guide测试驱动开发按设计落地代码配合 commands/orchestrate.md一条命令即可串联整条流水线/orchestrate refactor 把支付模块拆成独立服务 # 实际执行: architect 出架构方案 → code-reviewer 审查 → tdd-guide 落地每个智能体之间通过结构化的交接文档上下文、发现、修改文件、遗留问题、建议传递信息最后汇总成一份带 SHIP / NEEDS WORK 结论的编排报告。九、总结你关心的问题architect agent 的答案系统设计怎么做四步审查流程现状 → 需求 → 提案 → 权衡技术选型怎么选强制记录 Pros / Cons / Alternatives / Decision输出 ADR怎么避免架构腐化五大原则 设计清单 8 大反模式红旗怎么落地与 planner、tdd-guide 等智能体编排协同一句话概括让 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
architect agent详解：用everything-claude-code做系统设计、技术选型与权衡分析
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 agent1️⃣ 获取配置两种方式任选# 方式一克隆仓库 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-codeeverything-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⭐这是最有价值的一步——对每一个设计决策它都要求记录四要素要素内容✅ Pros收益与优势❌ Cons缺点与局限 Alternatives考虑过的其他方案 Decision最终选择及理由也就是说你问它用 A 还是 B它不会只给你一个答案而是给你一份带推理过程的决策报告——这正是它区别于普通写代码 AI的核心能力。四、技术选型落地架构决策记录ADR对重要选型architect agent 会按标准格式输出ADRArchitecture 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一旦识别就会警告你反模式白话解释Big Ball of Mud大泥球结构混乱、无章可循Golden Hammer金锤子什么问题都用同一个方案Premature Optimization过早优化还没跑通就开始抠性能Analysis Paralysis分析瘫痪规划过度、动手不足God Object上帝对象一个类啥都干Tight Coupling紧耦合组件互相依赖到拆不开八、组合拳与 planner、code-reviewer 等智能体协同architect agent 的真正威力在于团队作战。everything-claude-code 提供了完整的智能体矩阵rules/agents.md智能体定位与架构师的关系planner实现规划架构定调后把方案拆成可执行步骤code-reviewer代码审查实现完成后按架构标准把关security-reviewer安全分析与架构安全原则双重校验tdd-guide测试驱动开发按设计落地代码配合 commands/orchestrate.md一条命令即可串联整条流水线/orchestrate refactor 把支付模块拆成独立服务 # 实际执行: architect 出架构方案 → code-reviewer 审查 → tdd-guide 落地每个智能体之间通过结构化的交接文档上下文、发现、修改文件、遗留问题、建议传递信息最后汇总成一份带 SHIP / NEEDS WORK 结论的编排报告。九、总结你关心的问题architect agent 的答案系统设计怎么做四步审查流程现状 → 需求 → 提案 → 权衡技术选型怎么选强制记录 Pros / Cons / Alternatives / Decision输出 ADR怎么避免架构腐化五大原则 设计清单 8 大反模式红旗怎么落地与 planner、tdd-guide 等智能体编排协同一句话概括让 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
