SuperAPI AI 工具集

pawl-review

编程与开发

查看项目

更新于 10-15 17:29

技能介绍

用途:pawl-review 负责执行一次独立的评审器运行(reviewer lane),产出不可变请求、传输中立的通道结果与证据,并移交给 ao pawl。它不决定评审团结论;多样性、评审团判定、提交绑定与准入均由 ao pawl 负责。评审者不修改被评审对象,作者也不能充当自己的评审者。

主要能力与约束:分发前将请求绑定到确切的 head、契约摘要、diff 摘要与 nonce;要求全新评审器上下文与只读执行,并产出被包含的非空证据;传输失败与语义上的 CONFIRMED / REFUTED 判定严格区分。

使用方式:在确定性测试产生可评审的 commit 与 diff 后,用于全新上下文或多模型 pawl 通道;评审通道使用冷 Codex/AGY 适配器,Gas City 可在明确选择的 quest 内实现同一端口。Agent Mail 对独立活动者是可选的协调手段,单条本地通道不需要身份、预留或确认。构造 review-request.v1(subject id、head_sha、契约路径与 SHA-256、diff 路径与 SHA-256、作者上下文/家族、多样性模式、nonce、证据目录、read_only=true),分发前立即按摘要校验文件;无内容摘要的路径属可变输入,不得运行。产出 review-lane-result.v1,包含 lane/family/context id、回显 nonce、只读证明、证据路径、发现项以及 CONFIRMED 或 REFUTED 之一;结果由适配器在内存返回,不持久化结果文件。证据文件名约定为 review-evidence-<digest-prefix>.txt,digest-prefix 为 subject_id + NUL + head_sha + NUL + nonce 的 SHA-256 前八字节约十六进制编码。

限制与校验:传输失败不构成判定,提供方丢失、超时、缺失证据或标记畸形只产生传输类结果,不含语义处置;不得伪造 REFUTED、降低请求层级或写出评审团结论来推动流程。运行时校验边界为 ReviewLaneResultV1.ValidateAgainst(review-request.v1),在返回前复核请求摘要、nonce、全新上下文、只读证明、证据包含性、非空常规文件证据及传输/语义分离。校验命令:go -C cli test ./internal/ports ./internal/adapters/reviewlane_worker -run '^(TestReviewRequestV1RejectsMutableOrSelfReview|TestNTMReviewLaneFreshReadOnlyNonce|TestReviewLaneResultV1SeparatesTransportFromSemanticFailure|TestReviewLaneTransportFailureIsNotRefutation)$'。下游交接:将校验后的通道结果与证据路径交给 ao pawl 即停止;是否 CONFIRM、REFUTE、HOLD 或再请求通道由膜层决定。具体安装步骤与收费信息暂未提供。