用途
inspect-code 用于在重构前对源码模块做只读的结构性审查,定位结构性技术债和可维护性风险,而不是做语法格式检查或业务规则评估。
主要能力
- 类内聚与单一职责:识别聚合多个不相关领域关注点、字段/方法过多或方法内聚度低的 God Class。
- 方法与流程复杂度:识别过长方法、控制流嵌套≥3 层、箭头反模式和高认知负载。
- 系统性重复:识别跨类、跨文件、跨方法的复制粘贴算法、校验序列或错误处理管线。
- 耦合与封装泄漏:识别 Feature Envy、直接暴露可变内部集合的 getter 等。
- 多态与策略缺失:识别散落在多个类中的并行 switch/if 类型分支。
- 健壮性与资源卫生:识别空 catch 吞异常、未管理流/连接/监听器缺少清理钩子等。
使用方式
提供目标路径(文件、目录或子系统)。小于 10 个文件或单一内聚模块时直接在当前轮次审查;多包子系统或较大仓库时,可分派 2–3 个结构审查子代理并行检查不同切片,再汇总去重。输出遵循固定审查报告契约,包含执行摘要(目标、健康评级 CLEAN/MODERATE_DEBT/CRITICAL_DEBT、主要瓶颈)、技术债清单(严重级别、维度、实体、位置、问题、改进建议)和流程路由建议(/changeset 用于多文件结构重构,/diagnose 用于运行时功能缺陷)。
适用场景
适用于重构前评估、代码评审中的结构问题排查、技术债盘点,以及需要把结构治理与格式检查、业务逻辑诊断分开处理的团队流程。
限制
该技能只读,不修改磁盘文件、不生成代码 diff、不自动应用重构;不检查空白与分号等格式细节;不评估业务规则、定价逻辑或数学公式;缺少权威规格时不判断业务正确性。