Cathedral Audit

{ “overview_html”: “Cathedral Audit 是一个专为 Cathedral C# 代码库设计的结构化审计流程，旨在系统化地测量和消除规范（spec）与实际代码之间的偏差。该工具适用于在构建波次完成后、重大重构前后或怀疑规范与实现脱节时执行全面代码审查。通过双向审计机制——从规范到代码的正向审计，以及从代码到规范的逆向审计——Cathedral Audit 能够全面识别代码与规范之间的差异，包括缺失的实现、偏离规范的逻辑、未覆盖的代码区域等。整个流程强调可追溯性和可恢复性，要求在每个关键步骤进行详细日志记录，确保任何中断都能被有效追踪和修复。最终目标是提升代码质量、减少技术债务，并增强项目架构的可维护性与一致性。”, “feature_items”: [ “执行完整的规范-代码一致性审计，涵盖正向（spec→code）和反向（code→spec）两个方向”, “自动生成结构化的审计报告，包含分类统计、问题清单及与前次审计的对比分析”, “提供优先级驱动的执行框架，将发现的问题划分为 P0 到 P6 六个等级，指导修复顺序”, “强制要求每一步操作前预写任务简报并记录意图，实现‘先记后做’的安全开发模式”, “支持并行处理以加速审计进程，同时针对低内存环境（如 WSL2）提供顺序执行降级方案”, “集成构建验证机制，确保每次变更后 `dotnet build` 必须成功才能提交，防止引入编译错误” ], “scenarios_html”: “Cathedral Audit 最适用于需要严格维护代码与规格一致性的复杂企业级 .NET 项目，尤其是在 Cathedral 这类经过多次迭代、功能叠加和团队扩展的中大型 C# 系统中。它特别适合在以下场景中使用：首先是每轮构建波次结束后，当多个功能或重构同时落地时，通过审计快速定位因合并冲突或理解偏差导致的规范偏离；其次是在启动全新核心模块开发前，建立当前代码基线的准确快照，避免后续返工；此外，当团队对某些行为是否符合预期产生疑问，或系统出现难以解释的运行时异常时，逆向审计能帮助发现未被文档化的逻辑路径或隐藏的缺陷。该工具尤其适合重视工程纪律、追求长期可维护性的开发组织，能够有效防止‘规范漂移’累积成不可控的技术债务。” }