用途
Contract-driven 是一个用于在本地代码中加固边界与约束的 Claude 插件技能。触发场景包括:跨越公共 API 边界、守卫复杂不变量、加固不可信输入或集成接缝。它明确不适用于远程操作或不可逆变更。
主要能力
- 从需求或规范中提取前置条件(PRE)、后置条件(POST)和不变量(INV),并为每个契约分配 ID 和一行描述(例如 PRE-1: amount > 0;POST-1: balance == old(balance) - amount;INV-1: balance >= 0)。
- 为每个契约选择验证层级,优先静态而非运行时:静态类型系统或 static_assert 用于类型大小、对齐、空值/类型安全与穷尽性;测试断言用于开销较大的 O(n) 或以上性质;仅调试期不变量用于内部不变量;运行时守卫用于公共 API 输入,以及始终用于外部或不可信输入。若某性质可静态验证,则不再添加运行时契约。
- 在目标本地代码中按所选层级实现每个 PRE、POST、INV,运行时契约必须处于启用状态,不得被编译掉或禁用。
- 验证:运行类型检查器、静态分析和构建,契约必须通过编译与 lint。
- 测试:为每个 PRE/POST/INV 编写一个违规测试,证明契约能捕获坏输入或坏状态;静态契约由类型检查器验证,运行时契约由断言边界显式失败的违规测试验证。
使用方式
输入需要包含:待设计契约的操作的需求或规范(必需);包含公共 API 边界、不变量或不可信接缝的目标源文件或模块(必需);必须继续通过的现有测试(可选)。流程依次为计划、选择验证层级、创建、验证、测试。
失败与恢复
契约 lint 或构建失败时,修复契约或实现,不得禁用或编译掉运行时契约来使其通过。违规测试未触发时,说明契约未在所选层级被强制执行,应重新选择层级或加强检查,不得删除测试来使其通过。若契约只是琐碎地复述实现(例如为 subtract(x, y) 确保 result == x - y),应删除该契约,这属于契约疲劳而非边界保证。部分无法实现时,应停止并报告缺失的需求,不得发明契约或扩大范围。回滚方式是删除新增的本地类型、断言、校验器或测试,或还原边界变更;不触及远程、凭据、已发布或已部署的产物。
完成标准
每个计划的契约都在适当的静态/测试/调试/运行时层级实现,违规在边界显式失败,且每个契约都有一个违规测试,每个契约可按 ID 追溯到需求。
限制
不适用于远程或不可逆变更;仅写入指定的本地类型、断言、校验器和测试,回滚即撤销;若需求缺失导致部分契约无法实现,需报告而非自行补全。