用途:当有人提供描述已实现内容的文档(论文、设计文档、README 章节、笔记),需要核对代码是否与文档声明一致时使用。目标是发现“声明漂移”(代码未实现所描述的算法或行为)和“默认漂移”(默认或基线行为被无意改变)。
主要能力:从文档中提取 3-10 条可测试声明,区分算法步骤、定义(符号、损失、调度)、默认行为、预期输出或指标,并用一句话可测试语言重述;将每条声明映射到实现位置(文件与符号)、触发方式(配置、标志、入口)、默认行为以及有意省略或近似之处;检查新代码路径是否按需加门控、默认配置是否保持基线行为;评估证据质量,判断所报命令是否真正走通所述算法路径,优先采用算法未实现即会失败的证据(断言、特征日志、形状或数值不变量),无证据时提出最小决定性检查;识别常见算法保真陷阱,如损失项符号、缩放或归一化错误,缺少 detach 或 stop-gradient,调度差异(warmup、EMA、退火),采样差异(teacher forcing 与自由运行、掩码),批归约差异(均值与求和),随机性或种子位置差异;检查集成接缝,如配置传递、检查点加载保存、分布式包装、dtype 与设备迁移、形状约定。
使用方式:需请求缺失输入,包括带章节标题(及页码、图号、公式号)的文档摘录、实现上下文(变更文件或 diff、新标志与配置键、预期入口)、声明的兼容性约束(环境版本、依赖策略)。按审计清单执行,最终输出表格:文档声明(含引用)→ 实现(文件:符号 + 门控/默认)→ 证据 → 风险/不匹配,并以 Verdict: PASS | FAIL 结尾,若 FAIL 给出最小修复清单。
适用场景:论文或设计文档与代码库的对照审计、代码评审中的声明一致性检查、默认行为回归排查。
限制:资料未提供具体安装命令、平台支持、收费或价格信息;该技能为流程性审计方法,不包含自动化工具或代码实现细节。