用途:对当前代码库进行多代理架构分析,评估架构健康度,适用于大型重构前、接手陌生仓库、快速扩张后或规划改造时。仅做诊断,不提出修复方案。
主要能力:并行调度五个专家代理,分别聚焦结构边界、耦合依赖、集成数据、错误处理与可观测性、安全与代码质量;每个发现需经阅读实际代码验证、置信度不低于60、具备具体证据(路径、符号、摘录),并校验影响级别与分类,合并重复项;最终产出兼顾优点与缺陷的报告。
使用方式:调用时先声明“Running paad:agentic-architecture v2.0.0”,随后按阶段执行。支持可选参数:/agentic-architecture 分析整个仓库;/agentic-architecture src/ 限定目录;/agentic-architecture packages/api/ packages/shared/ 分析多个目录。若会话已有实质历史,建议新开会话以避免上下文腐化。
流程:侦察(识别仓库、概览、依赖结构、扫描 CLAUDE.md/AGENTS.md 等引导文件、估算规模)→ 按规模分派专家(小/中直接分派,大仓库将文件分区给每个专家的两个实例)→ 验证与过滤 → 写入报告至 paad/architecture-reviews/。安全相关发现仅写入 paad/security/,需确保该目录下 .gitignore 仅含 * 且 git 未跟踪任何内容,否则不写入并询问用户。
限制:不适用于已有近期报告或仅少量文件的范围;配置为实验性,配置不得改变子代理类型或授予写权限;引导文件可能过时,与代码矛盾时应标记为发现。