维度分析

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用

使用单位/维度注释来注释代码库(例如,D18{tok}、D27{UoA/tok}) 对 DeFi 协议、金融代码或科学计算执行维度分析 寻找因单位不匹配、缺少缩放或精度损失引起的算术错误 审计具有混合十进制精度或定点算术的代码库

何时不使用

没有数值算术或单位转换的代码库 - 没有任何可注释的 纯整数计数逻辑(循环索引、数组长度),没有物理或财务维度 当您只需要快速抽查单个公式时 - 直接读取代码,而不是运行完整的管道

执行模式

该技能仅在一种模式下运行:full-auto。这是一项基于工作流程的技能,通过Task工具将特定步骤的工作委托给专业代理。您可以编排整个流程,管理覆盖范围和状态持久性,并确保通过管道的每个步骤处理每个范围内的文件。始终按以下顺序运行完整管道:步骤 1 -> 步骤 2 -> 步骤 3 -> 步骤 4。当该步骤存在专用子代理时,主要技能上下文不得执行存储库范围的维度分析、注释、传播或错误验证本身。

范围和覆盖范围保证

此技能必须审核所有范围内的算术文件,包括大型存储库。范围内文件由步骤 1 扫描仪输出(files 数组)定义,涵盖所有优先级(CRITICAL、HIGH、MEDIUM、LOW)。如果步骤 1 缩小了词汇发现的输入范围(例如,仅限 CRITICAL/HIGH),则该缩小范围仅适用于发现。它永远不会减少注释或验证范围。 arithmetic-scanner 将范围内文件清单保留到项目根目录中的DIMENSIONAL_SCOPE.json,并且该清单是步骤 2-4 的真实来源。

委托合同

arithmetic-scanner 拥有存储库扫描、算术文件优先级和写入DIMENSIONAL_SCOPE.json。 dimension-discoverer拥有维度词汇发现、单位推理、写作DIMENSIONAL_UNITS.md。 dimension-annotator 拥有注释格式决策、锚点编辑和评论编写行为。 dimension-propagator 拥有传播逻辑、推断注释和跟踪期间的不匹配报告。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@trailofbits · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 dimensional-analysis.preview
{
  "mode": "full-auto",
  "project_root": "<path>",
  "vocabulary": {
    "base_units": ["..."],
    "derived_units": ["..."],
    "precision_prefixes": ["..."]
  },
  "annotations": {
    "total_added": 0,
    "by_file": {}
  },
  "findings": {
    "critical": 0,
    "high": 0,
    "medium": 0,
    "details": []
  },
  "uncertainties_resolved": 0,
  "coverage": {
    "in_scope_files": 0,
    "anchor_reviewed_files": "0/0",
    "propagation_reviewed_files": "0/0",
    "validation_reviewed_files": "0/0",
    "annotated_functions": "0/0",
    "annotated_variables": "0/0",
    "unprocessed_files": [
      {
        "path": "/path/to/repo/contracts/LegacyMath.sol",
        "blocked_step": "step3",
        "reason": "Parser could not process generated source",
        "retry_count": 1
      }
    ]
  }
}

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。