用途:当 AI 智能体声称任务、阶段或功能已完成时,用来自非该智能体所写证据的裁决来替代其自述。它核对的是“声称的改动是否真的落地”,而非代码是否正确——正确性仍由测试套件负责。
主要能力:dos commit-audit 按提交实际 diff 评估提交主题,判定 OK、CLAIM_UNWITNESSED 或 ABSTAIN;dos verify 确认某个具名计划/阶段是否真正发布,返回 shipped 与 source 字段。source 为 registry 或 grep-artifact 属不可伪造证据,可据此关闭声明;grep-subject 或裸 grep 属可伪造(提交主题可被人为写入),只能视为“按主题已发布”,需再用 commit-audit 佐证;none 表示无正面证据,应视为未完成而非工具故障。
使用方式(安装一次): python3 -m venv .dos-venv . .dos-venv/bin/activate python -m pip install 'dos-kernel==<reviewed-version>' 审计最近提交:dos commit-audit --workspace . HEAD --json,读取数组中第一个元素的 verdict。验证阶段:dos verify --workspace . PLAN PHASE --json --no-ci,--no-ci 强制仅走 git 路径、确保无网络。仅当第 2/3 步得到佐证时才接受“完成”。
适用场景:提交后立即核验提交信息与 diff 是否一致、汇总多个子智能体结果时逐一核验其声称效果、关闭工单前确认功能阶段确已发布。
限制:不替代环境相关验证、测试或专家评审;不判断代码正确性;无提交的仓库无从取证(会如实返回 source: none)。DOS 为确定性工具,无需 API key、不调用 LLM。dos commit-audit 只读 git 历史与工作树、不联网;dos verify 通常仅读 git,若工作区在 dos.toml 中配置了 [verify] non_git_oracle,则可能执行网络检查(如 gh api),此时传 --no-ci 可强制仅走 git 路径。安装须用 PyPI 名称 dos-kernel(PyPI 上裸 dos 是无关包,勿装),并固定已审查版本,避免向全局 Python 环境安装未固定版本。命令只读,不会改动仓库或推送。若缺少必要输入(git 仓库、dos CLI),应停止并请求澄清。