用途:在加入既有项目或生成新代码前,系统分析代码库以识别项目自身的编码约定,并在后续生成与审查中保持一致。
主要能力:分析项目结构(项目命名、分层方式、测试项目命名、共享项目位置);识别类型命名模式(类修饰符、接口前缀、后缀约定、record 与主构造函数用法);扫描目录结构(功能文件夹或分层文件夹、共享与配置位置);检测显式约定配置(Directory.Build.props、.editorconfig、global.json);汇总为结构化约定摘要;生成代码时匹配检测到的模式,审查代码时标记偏离;建议 .editorconfig 规则以自动执行;通过 detect_antipatterns 跟踪反复出现的质量问题。
使用方式:按检测流程依次调用 get_project_graph、get_public_api(对 3-5 个关键类型)、detect_antipatterns 等 MCP 工具,并结合文件系统扫描与配置文件读取。检测后建议将约定写入项目 CLAUDE.md。
适用场景:加入既有项目、生成新代码、代码审查、新成员入职、约定冲突处理、反复出现的反模式跟踪。
限制与原则:先观察再执行,项目约定优先于通用规则,显式 .editorconfig 与 Directory.Build.props 规则始终优先;仅记录跨多个文件确认的模式,不基于单个文件下结论;一致性优先于理论上的完美;未检测到约定时使用套件默认值并记录。具体工具可用性与配置细节以实际项目环境为准。