框架迁移架构评审:agents24 中 framework-migration 的 architect-review Agent 深度解析

框架迁移架构评审:agents24 中 framework-migration 的 architect-review Agent 深度解析 框架迁移架构评审agents24 中 framework-migration 的 architect-review Agent 深度解析【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents本篇文章聚焦于 agents24 开源仓库中 framework-migration 插件下的architect-reviewAgentarchitect-review.md系统讲解这个首席架构师角色的设计意图、能力矩阵、评审方法论以及它在遗留系统现代化strangler fig 模式、框架迁移与依赖升级工作流中的具体落地方式。读完本文你将掌握如何复用该 Agent 进行架构一致性评审、模式合规性验证与迁移方案审查并理解其在多 harnessClaude Code、Codex、Cursor、OpenCode、Copilot、Antigravity插件体系中的定位与调用方式。一、architect-review Agent 是什么在 agents24 仓库中每个 Agent 都以一个 Markdown 文件定义文件头部 YAML frontmatter 携带name、description与model三个关键元数据。architect-review.md 的 frontmatter 如下--- name: framework-migration-architect-review description: Master software architect specializing in modern architecture patterns, clean architecture, microservices, event-driven systems, and DDD. Reviews system designs and code changes for architectural integrity, scalability, and maintainability. Use PROACTIVELY for architectural decisions. model: opus ---三个字段各有讲究nameframework-migration-architect-review。根据 docs/authoring.md 的约定Agent 名称必须使用plugin-directory-agent-file-stem的插件级命名避免两个插件安装到一起时同名互相覆盖。仓库 CI 通过tools/check_agent_name_collisions.py --fail-on-duplicates强制保证全树无重名。description包含Use PROACTIVELY for architectural decisions这一标准触发短语。按照 docs/authoring.md 的说明description 必须包含Use when …、Use PROACTIVELY when …等识别短语否则会触发MISSING_TRIGGER静态检查告警该短语正是模型决定是否自动调用该 Agent 的依据。model: opus映射到 Claude 的高端推理模型。根据 docs/agents.md 的模型分布统计Opus 类 Agent 共 54 个承担关键架构、安全、代码评审、生产编码类任务。在跨 harness 适配时tools/adapters/capabilities.py 中的MODEL_ALIASES会将该别名映射为各平台可用模型Codex 映射gpt-5.5、OpenCode 映射anthropic/claude-opus-4-8、Antigravity 映射pro级、Copilot 映射claude-opus-4.8。从角色定位看architect-review 是一个架构评审型专家不直接写业务代码而是对系统设计、代码变更、迁移方案进行架构体检确保系统的完整性integrity、可扩展性scalability与可维护性maintainability。二、能力矩阵八大架构专业域Agent 正文的## Capabilities章节罗列了八个专业域这是它进行评审时依赖的知识框架专业域核心内容现代架构模式Clean/Hexagonal Architecture、微服务边界、事件驱动EDA/事件溯源/CQRS、DDD 限界上下文、Serverless/FaaS、API-firstGraphQL/REST/gRPC、分层架构分布式系统设计Service meshIstio/Linkerd/Consul Connect、事件流Kafka/Pulsar/NATS、Saga/Outbox/Event Sourcing、熔断/舱壁/超时、分布式缓存、负载均衡与服务发现、分布式追踪SOLID 与设计模式五大 SOLID 原则、Repository/Unit of Work/Specification、Factory/Strategy/Observer/Command、Decorator/Adapter/Facade、DI/IoC 容器、防腐层与适配器云原生架构Kubernetes/Docker Swarm 编排、AWS/Azure/GCP/OCI 云模式、Terraform/Pulumi/CloudFormation IaC、GitOps 与 CI/CD、自动扩缩容、多云与混合云、边缘计算安全架构Zero Trust、OAuth2/OIDC/JWT、API 限流、静态/传输加密、Vault 密钥管理、纵深防御、容器与 K8s 安全性能与可扩展性水平/垂直扩展、多层缓存、数据库分片/分区/只读副本、CDN、异步处理与消息队列、连接池、APM 集成数据架构Polyglot persistence、数据湖/仓库/网格、事件溯源与 CQRS、每服务独立数据库、主从/主主复制、分布式事务与最终一致性质量属性评估可靠性/可用性/容错、可扩展性与性能、安全态势与合规、可维护性与技术债、可测试性与部署流水线、可观测性、成本优化一个值得注意的交叉点其中数据架构域同时出现 CQRS、事件溯源与微服务每服务独立数据库而仓库中的 backend-development 插件也提供了event-sourcing-architect、graphql-architect等同类专家。docs/agents.md 的 Architecture System Design 分类下还有 cloud-architect、hybrid-cloud-architect、kubernetes-architect 等角色。这说明 architect-review 在设计上是评审者/守门人身份与其他建设者角色形成互补建设者出方案architect-review 审方案。三、行为特质与知识库评审的价值观与依据Agent 的## Behavioral Traits定义了评审时的价值取向这些特质决定了它的评审口径捍卫干净、可维护、可测试的架构强调演化式架构与持续改进从第一天就优先考虑安全、性能与可扩展性主张合理的抽象层级避免过度设计over-engineering通过清晰的架构原则促进团队对齐以长期可维护性优先于短期便利在技术卓越与业务价值交付之间取得平衡鼓励文档与知识共享关注赋能变化而非阻止变化其中避免过度设计与关注赋能变化尤其关键——这意味着 architect-review 不是教条地要求所有代码都遵循最高复杂度模式而是结合迁移语境给出务实判断。## Knowledge Base则列出了评审的知识依据来源现代架构模式与反模式、云原生技术、分布式系统理论与 CAP 定理、Martin Fowler 与 Sam Newman 的微服务模式、Eric Evans 与 Vaughn Vernon 的 DDD、Robert C. Martin 的 Clean Architecture、SRE 与平台工程实践、事件驱动架构、现代可观测性实践。从源码结构看这些依据与仓库中 docs/architecture.md 及 plugin-eval 框架倡导的以模式与规则驱动评审思路一致。四、评审方法论八步 Response Approach## Response Approach是 Agent 执行评审任务时的标准操作流程共八步分析架构上下文识别系统当前状态评估变更的架构影响High/Medium/Low 三级对照既定架构原则做模式合规性评估识别架构违规与反模式给出带具体重构建议的改进方案考虑面向未来增长的可扩展性影响必要时以架构决策记录ADR沉淀决策提供含具体下一步的实施指导这套流程在 legacy-modernize.md 命令的 Step 2 中有直接印证该步骤以subagent_type: framework-migration-architect-review调用本 Agent输入 Step 1 产出的遗留系统评估报告要求产出依赖图与集成点目录其中明确要求识别需要 facade 模式或适配器层的集成点识别需要解决的循环依赖与紧耦合——这正是 Response Approach 第 4、5 步在迁移场景中的落地。五、示例交互典型的评审触发场景Agent 正文末尾的## Example Interactions列出了 9 个典型触发场景覆盖了它最常被调用的评审类型评审微服务设计的限界上下文边界评估为系统引入事件溯源的架构影响评估 API 设计是否符合 REST 与 GraphQL 最佳实践评审 service mesh 实现的安全与性能分析微服务数据隔离的数据库 schema评估 serverless 与容器化部署的架构权衡评审 OCI 采用或多云扩展与现有架构原则的一致性评审事件驱动系统的解耦设计评估 CI/CD 流水线架构的可扩展性与安全性这些场景的共同特征是变更前的架构把关不是已经写完代码后的代码 review而是在方案层面提前评审正符合description中Use PROACTIVELY for architectural decisions的定位。六、在 framework-migration 插件中的协同定位architect-review 只是 framework-migration 插件plugins/framework-migration 所在目录的一个成员。查看该插件目录结构可以看到完整的角色分工plugins/framework-migration/ ├── agents/ │ ├── architect-review.md # 本文章主角架构评审 │ └── legacy-modernizer.md # 遗留系统现代化执行者 ├── commands/ │ ├── code-migrate.md # 生成迁移计划与脚本 │ ├── deps-upgrade.md # 安全增量依赖升级 │ └── legacy-modernize.md # 完整的现代化编排工作流 └── skills/ ├── angular-migration/ # AngularJS → Angular 迁移技能 ├── database-migration/ # 数据库迁移技能 ├── dependency-upgrade/ # 依赖升级技能 └── react-modernization/ # React 现代化技能与 legacy-modernizer 的分工legacy-modernizer.md 是一个model: fable的执行型 Agent专注于安全的增量升级strangler fig 模式、先补测试再重构、保持向后兼容、用 feature flag 渐进发布。而 architect-review 是model: opus的评审型 Agent。两者在 legacy-modernize.md 的 13 步工作流中各自承担不同环节环节调用的 Agent产出Step 1 遗留系统分析framework-migration-legacy-modernizer技术债清单、组件复杂度评分、现代化就绪报告Step 2 依赖与集成映射framework-migration-architect-review依赖图、集成点目录、需要 facade/适配器层的清单Step 12 去commissioningframework-migration-legacy-modernizer退役检查清单与时间线注意 docs/agents.md 的模型分配说明fableClaude Fable 5是 Opus 之上的层级用于最长时域自主工作大型代码库迁移、过夜重构其他 harness 会将其映射到各自最高可用模型而架构评审这类需要严密推理的任务分配给 Opus 层级。这解释了为什么同一插件内两个 Agent 使用不同模型档位。与命令、技能的配合code-migrate.md面向框架/语言/平台间迁移内置MigrationAnalyzer源码特征统计、复杂度评估、风险模式识别如全局状态、直接 DOM 操作、已废弃 API、MigrationPlanner按复杂度产出 3 阶段或 4 阶段计划、React→Vue、Python 2→3、REST→GraphQL、SQL→NoSQL 等迁移器以及RollbackManager蓝绿/金丝雀/feature flag 三类回滚。architect-review 的评估架构影响识别反模式能力正好为这类迁移提供前置评审。deps-upgrade.md专注于增量依赖升级内置DependencyAnalyzernpm/pip 过时检测与 semver 分类、BreakingChangeDetector扫描 changelog 破坏性变更关键词React 15→16/16→17/17→18 特例、批量更新策略安全更新立即、major 单独处理与回滚脚本。architect-review 的模式合规性评估可作为升级后架构一致性的校验层。angular-migration/SKILL.md讲解 Big Bang、增量ngUpgrade 混合模式、垂直切片三种迁移策略及 controller→component、directive→component、service 升级/降级、路由迁移的代码对照。react-modernization/SKILL.md覆盖 React 16→17→18 破坏性变更清单、class→hooks 迁移、React 18 并发特性新 root API、自动批处理、transitions、Suspense。从源码结构可以推断插件的设计哲学是评审architect-review在前执行legacy-modernizer在中技能skills与命令commands提供方法与工具评审 Agent 作为架构守门人贯穿整个迁移生命周期。七、在多 harness 插件体系中的可移植性architect-review.md 是一个纯 Markdown YAML frontmatter 文件这保证了它在 agents24 的跨 harness 体系中的可移植性。根据 docs/authoring.md该仓库的内容会同时发布到Claude Code、OpenAI Codex CLI、Cursor、OpenCode、Google Antigravity CLIagy与 GitHub Copilot六个 harnessClaude Code 是源真理source-of-truth适配器框架tools/adapters/负责 frontmatter 重写、格式转换与输出路径映射。Agent 正文采用谈动作不谈工具的写法authoring.md明确要求避免Use the Read tool、Use the Bash tool这类 Claude 专属措辞architect-review.md 通篇使用Reviews system designsAssess the architectural impact这类动作化描述天然适配各 harness 的模型词汇表。model: opus属于BARE_MODEL_ALIASinformational 级 lint适配器在生成时隐式映射若想显式控制可改用inherit。该 Agent 未使用hooks:、color:、per-agent 工具白名单等仅部分 harness 支持的特性跨平台表现一致。八、如何实际使用这个评审 Agent根据 docs/agents.md 的 Agent 调用说明有两条使用路径1. 自然语言直接调用模型自行判断是否启用Use framework-migration-architect-review to review this microservice design Have architect-review assess the architectural impact of adding event sourcing2. 在命令工作流中以 subagent 形式调用如 legacy-modernize.md Step 2 所示通过 Task 工具指定subagent_type: framework-migration-architect-review并传入上游产出物作为上下文Task: subagent_type: framework-migration-architect-review description: Create dependency graph and integration point catalog prompt: | Based on the legacy assessment report below, create a comprehensive dependency graph. ## Legacy Assessment [Insert full contents of .legacy-modernize/01-legacy-assessment.md] ## Deliverables 1. Internal module dependencies 2. External service integrations 3. Shared database schemas and cross-system data flows 4. Integration points requiring facade patterns or adapter layers during migration 5. Circular dependencies and tight coupling that need resolution3. 本地验证与生成如果你在插件开发场景中想验证内容可移植性可参考 docs/authoring.md 提供的验证方式# 对插件内容做可移植性 lint 评分 cd plugins/plugin-eval uv run plugin-eval score ../framework-migration/agents/architect-review --depth quick # 为指定 harness 重新生成产物并对比 cd ../.. make generate HARNESScodex PLUGINframework-migration需要说明的是agents24 是一个插件市场仓库Agent 的消费方式由各 harness 的插件机制决定——Claude Code、Cursor 与 Antigravity 拥有 marketplace 注册表.claude-plugin/marketplace.jsonCodex 与 OpenCode 则没有独立 marketplace安装路径各有差异实际使用前应以对应 harness 的插件安装文档为准。九、小结architect-reviewframework-migration-architect-review是 agents24 仓库中 framework-migration 插件内置的首席架构师评审 Agent以 Opus 级模型承载八个架构专业域的知识体系通过八步评审方法论为框架迁移、依赖升级与遗留系统现代化提供架构完整性、可扩展性与可维护性的把关。它与legacy-modernizer执行者以及code-migrate、deps-upgrade、legacy-modernize三个命令、四个迁移技能共同构成了从评审、规划、执行到退役的完整迁移工具链。在多 harness 适配层面其纯 Markdown 结构与动作化措辞使其能够在 Claude Code、Codex、Cursor、OpenCode、Copilot 与 Antigravity 之间低成本移植。对于需要进一步研究的读者建议按以下路径深入先读 architect-review.md 原文理解角色边界再对照 legacy-modernize.md 看它如何在 13 步工作流中被编排最后参考 docs/agents.md 与 docs/authoring.md 了解模型分配逻辑与跨 harness 可移植性约束。【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考