用途:为解决方案创建或更新 docs/Architecture/Overview.md,作为全局架构地图。适用于首次建立仓库级架构图、模块/边界/接口/归属变更,以及因缺少简短“从这里开始”的系统地图导致上手缓慢的场景。
主要能力:产出具体项目增量(代码、文档、配置、测试、CI 或评审产物);通过显式规划、验证与最终校验减少歧义;留下可复用项目上下文。
使用方式:先阅读最近的 AGENTS.md 确认范围与约束;从现有 docs/Architecture/Overview.md 开始,缺失时用 references/overview-template.md 搭建;构建简短导航式概览,包含系统或模块图、关键边界与契约、范围提示,以及指向 ADR、功能文档和高信号代码路径的链接;仅使用仓库真实名称,优先 Mermaid 图加小型链接索引,图过于杂乱时按边界拆分。通过 Ralph Loop 执行:先规划,再执行一步并产出具体增量,评审并记录可操作修复,小批量修复并重跑检查,更新计划,重复至可接受。最终按指定结果格式返回 status、plan、actions_taken、validation_skills、verification、remaining。
适用场景:仓库初始化、新人上手、模块拆分后更新概览。
限制:不用于记录单个架构决策及其备选方案,也不用于编写功能级行为细节。校验要求图中节点使用真实仓库名称、每个重要框或边界链接到更深材料、文件保持导航性而非清单堆砌,并使新智能体无需阅读整个仓库即可界定工作范围。