SuperAPI AI 工具集

theater-detection-audit

编程与开发

查看项目

更新于 10-15 21:11

技能介绍

用途:在代码库中系统识别并消除“表演式代码”(theater),即看似可用但依赖假数据、模拟响应、桩实现或占位逻辑的代码,常用于上线前检查、接手陌生代码库、代码评审发现数据异常或快速原型后的收尾阶段。

主要能力:按四阶段审计——基于模式检测(搜索 TODO、FIXME、HACK、XXX、TEMP、STUB、MOCK 等标记,硬编码用户 ID、示例邮箱、固定时间戳、mock/fake/dummy/test 命名、固定 API 响应与简化查询);上下文分析(阅读完整文件,判断真实实现应做什么、依赖哪些数据源与错误条件);依赖映射(梳理占位项之间的依赖链与完成顺序);风险评估(按功能关键性、生产失败概率、用户可见度与影响排序)。随后提供六步补全流程:理解预期行为、设计生产实现、按最佳实践实现、充分测试、评审与精修、更新文档。

使用方式:由主 Claude Code 实例在代码质量审计或上线准备时调用,需提供待审计的代码库或目录路径、已知关注区域、所用编程语言及报告输出格式偏好。技能会按阶段报告进度、即时提示高风险发现、维护检测计数,并在语义不明确时提出澄清问题。结果以结构化审计报告、按优先级排列的待补全清单、带上下文的代码片段及基于依赖与风险的补全顺序建议打包输出。

适用场景:重大发布前、代码质量专项、系统生产加固、接手他人代码库时。

限制:计算密集,需明确范围,超大代码库建议分阶段审计;部分占位因外部系统不可用、需求不清或资源有限而需延期,应记录原因、预期处理时间、风险与缓解措施;测试若本身被 mock 化也会成为新的表演式代码。具体安装命令与调用参数暂未提供。