用途：当用户要求评审并改进代码库的智能体原生可维护性时使用，例如“给这个仓库打分”“让代码库对智能体友好”“提升代码质量/可维护性”“清理架构”“用 swarm/worktrees 重构”“改进质量循环与结构”。
主要能力：按固定维度给出 0-10 评分并附文件证据，维度包括 agent_native、fully_typed、traversable、test_coverage、feedback_loops、self_documenting；识别 godfile、职责混杂模块、重复热点与功能边界违规；给出类型安全策略（用可辨识联合替代布尔标志堆、对 ID/邮箱/路径等易混值使用品牌类型、在 IO 边界校验后内部传递可信领域类型、从单一事实来源派生类型）；给出 godfile 与边界策略（按功能拆分，再在功能内按关注点分离，共享代码需有明确归属，禁止新建通用 utils 垃圾场）；规划 3-6 条低重叠通道，选择最轻的机制（直接编辑、探索子代理、编码子代理、worktree 或集成分支）；合并后运行全仓库检查并输出最终报告。
使用方式：应用前必须先读 references/scoring-rubric.md（用于任何评分卡、发现清单或严重度排序）和 references/swarm-lanes.md（用于规划发现通道、实现通道、worktree 或子代理拆分）；若参考文件缺失或不可读，需说明并采用最接近的替代方案，不得静默跳过。流程为：确认 git 状态干净、识别 lint/typecheck/test/format:check 等检查命令；用只读发现通道收集证据并自行核实；识别热点；规划通道；实现或协调；合并与稳定；最终报告先按严重度列发现，再给更新后的评分卡、变更日志与剩余风险。
适用场景：TypeScript/JavaScript 仓库的可维护性评审、架构清理、质量循环改进、并行重构协调。
限制：测试仅针对确定性单元（纯转换、reducer/状态机、schema 校验、handler 守卫），除非明确要求否则跳过易碎的 E2E；注释只写不变量、非显然控制流、副作用与顺序约束、边界归属；文档优先一份通道地图而非大量散文；worktree 与提交为推荐而非强制。具体评分细则与通道细节需查阅上述参考文件，资料未提供其内容。