用途:用于整理新项目结构、清理已积累的杂乱文件、统一命名规范、审查 gitignore 缺失模式、评估项目可扩展性与模块化,以及发布前的大规模重组。不做代码重构、不撰写文档、不配置 CI/CD、不设计数据库结构。
主要能力:采用枢纽-辐条多代理架构,遵循 CQRS 模式,分析师只读、整合器写入。Wave 1 由 archive-clutter-analyst 检测生成文件、陈旧内容与组织混乱;Wave 2 并行运行命名规范执行器与结构组织器;Wave 3 由 archive-expandability-reviewer 评估扩展性;Wave 4 由 archive-decision-integrator 合并结果、解决冲突、生成执行计划并需用户批准后执行文件操作。
使用方式:启动前执行 Phase 0 预检,包括 git status --porcelain、分离 HEAD 检查、写权限与磁盘空间检查。运行时以 [Wave N/4] 标记状态,各波输出写入会话目录。执行计划分 A 非破坏性、B 清理、C 删除三类,C 类需逐文件批准。
限制:仓库修改操作须经整合器以记录日志;不可自动删除;命名冲突升级给用户;失败时按提交前或提交后分别回滚。