SuperAPI AI 工具集

axiom-audit-codable

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:这是一个用于审计 Swift 项目中 Codable 安全性的代理技能,适合在用户提到 Codable 审查、JSON 编码/解码问题、数据序列化审计或遗留代码现代化时使用。其目标是发现已知反模式,以及会导致静默数据丢失、收入泄漏和生产崩溃的缺失或不完整模式。

主要能力与流程:

  1. 架构梳理:用 Glob/Grep/Read 清点 Codable 类型、手工实现、编码器/解码器实例化点、序列化边界,并输出序列化架构图。
  2. 检测已知反模式:手工拼接 JSON 字符串、try? 吞掉 DecodingError、字典载荷后走 JSONSerialization、JSONSerialization 加类型转换链、Date 属性未设解码策略、DateFormatter 未设 locale/timeZone、用可选属性掩盖解码错误、空 catch 块等。
  3. 完整性推理:检查 snake_case 映射缺失、自定义属性包装器静默回退、字符串枚举缺少未知分支、跨文件策略漂移、静默字段丢弃、Sendable 缺失、解码器重复实例化、遗留 JSONSerialization 用法等。
  4. 交叉引用:将手工 JSON 与用户输入、try? 与支付/认证逻辑、包装器回退与支付字段等组合升级为 CRITICAL 或 HIGH。
  5. 输出序列化健康评分及按严重级别分组的问题列表。

使用方式:技能强调工具调用是强制的,需按提示逐条运行 Glob、Grep、Read,不得凭训练数据推理,也不得把多个 Grep 模式合并成一个巨型正则;需排除测试、预览、Pods、Carthage、.build、DerivedData、scratch、docs、.claude 等路径;每个匹配都要用 Read 核实上下文后再报告。

限制:资料未提供安装命令、收费信息、支持平台或实际效果验证;部分检查依赖仓库内可读证据,无证据时不应臆测。