SuperAPI AI 工具集

defense-in-depth

编程与开发

查看项目

更新于 11-13 20:56

技能介绍

用途

defense-in-depth 是一个面向调试与防御性编程的 Claude 技能,触发场景是:无效数据绕过最初的检查,在较深的执行路径中引发失败。它的核心原则是,在数据经过的每一层都进行校验,让缺陷在结构上不可能发生。

核心理念

单一校验只能得出“我们修复了这个 bug”的结论,而多层校验才能做到“我们让这个 bug 不可能发生”。不同层能捕获不同情况:入口校验能捕获大多数问题,业务逻辑校验能捕获边界情况,环境守卫能防止特定上下文中的危险操作,调试日志则在其他层失效时提供帮助。

四个层次

  1. 入口点校验:在 API 边界拒绝明显无效的输入。资料示例中,创建项目时检查工作目录非空、存在且为目录。
  2. 业务逻辑校验:确保数据对当前操作有意义。示例中,初始化工作区时要求 projectDir 非空。
  3. 环境守卫:防止在特定上下文中执行危险操作。示例中,测试环境下拒绝在临时目录之外执行 git init。
  4. 调试插桩:为事后取证捕获上下文。示例中,在 git init 前记录目录、当前工作目录和调用栈。

使用方式

资料给出的应用流程是:追踪数据流,找出坏值从哪来、在哪里被使用;映射所有检查点,列出数据经过的每个位置;在每一层添加校验;逐层测试,尝试绕过第一层并验证第二层能否捕获。

资料中的实例是:空 projectDir 导致 git init 在源代码目录执行。数据流为测试设置传入空字符串,经 Project.create、WorkspaceManager.createWorkspace 后,git init 在 process.cwd() 中运行。随后在四层分别加入校验与日志,最终全部 1847 个测试通过,该缺陷无法复现。资料强调四层缺一不可:测试中不同代码路径绕过了入口校验,mock 绕过了业务逻辑检查,不同平台的边界情况需要环境守卫,调试日志帮助识别结构性误用。

集成与适用场景

该技能被 debug:systematic 使用(阶段 4,修复根因之后),并与 debug:root-cause 搭配,用于确定应在何处添加校验。适用于数据流跨越多个模块、存在多条调用路径或测试 mock 的系统,以降低无效数据深入执行的风险。

限制

资料未说明该技能的安装命令、支持的平台范围、是否需要额外配置或依赖,也未提供价格与收费信息。