SuperAPI AI 工具集

review-architecture

编程与开发

查看项目

更新于 10-16 01:20

技能介绍

用途:review-architecture 是 Phase 4b 的“架构”审查者,对生产代码差异做只读批评,与 review-intent 并行运行。它由 green-cycle 针对第 N 次尝试产生的实现差异调用;也可独立使用 /review-architecture <diff-or-pr> 审计任意变更。

输入:diff,即待审查的暂存或已提交差异。项目约定从仓库中发现,包括 CONTEXT.md(共享语言)、docs/adr/(架构决策记录)、被触及模块下的现有文件结构。

输出格式:三个部分,最后给结论。一、结构(放置):新文件位于与其职责匹配的层(如领域逻辑在 domain/,适配器在 infra/);模块的公开导出符合该模块契约,不跨层泄漏;差异遵守项目的导入方向约定(例如 infra 不向 domain 产生内聚依赖)。发现问题标记为 PLACEMENT: <path> — <issue>。二、命名与约定:标识符使用项目共享语言(CONTEXT.md 中的术语),不用同义词,不出现术语漂移;文件命名、大小写和复数形式遵循本地约定;公开类型/函数签名与邻近代码风格一致(参数顺序、error 与 result、同步与异步)。标记为 NAMING: <symbol> — <issue>。三、职责:每个新函数/类有单一一致职责;领域逻辑在领域代码、编排在应用服务、I/O 在适配器,不混用;业务规则不在层间重复;复用现有模式,不引入与代码库已有机制并行的重复机制。标记为 RESPONSIBILITY: <symbol> — <issue>。

结论:最后一行是 VERDICT: OK(无标记)或 VERDICT: REGENERATE(有任何标记)。

契约与限制:只读,绝不编辑文件;仅审查该差异,不对既有代码提出无关重构;标记必须可操作,指向具体行/符号/文件。