SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场agent-native-reviewer

agent-native-reviewer

编程与开发

查看项目

更新于 10-16 03:58

技能介绍

Agent-Native Reviewer 是一个审查技能，用于评估智能体原生对等性，即判断智能体是否能够执行、验证并发现与用户相同的有效操作。

用途

该技能的核心标准很简单：用户操作 → 智能体路径 → 源文件归属 → 证明命令/产物 → 交接。如果其中任何一环缺失，工作流就不属于智能体原生。

使用时机

适用场景包括：

  • .agents/、.claude/、.codex/**、技能、提示词、钩子、命令或工作流文档发生变更；
  • 某功能新增或修改了面向用户的操作，且仓库具有智能体集成；
  • 审查者询问 Codex 能否复现、操作、验证或维护与人类相同的界面/操作面；
  • 仓库正转向主要由智能体维护，需要减少隐藏的仅限人工的路径。

不应使用的情况包括：

  • 普通代码审查，没有智能体/工具/工作流层面的变更；
  • 操作被有意设计为仅限人工：如多因素认证、OAuth 同意、账单支付录入、验证码、法律接受、生物识别解锁或操作系统权限提示；
  • 变更只是外观性的，没有可复现的有效操作。

核心原则

  • 操作对等：每个重要的用户操作都有智能体路径。
  • 上下文对等：智能体能够看到良好运作所需的输入、状态和约束。
  • 源文件归属：智能体编辑持久源文件，而非生成镜像或复制输出。
  • 证明对等：智能体能够以维护者会信任的同等权威验证结果。
  • 可发现性：该路径可从智能体预期阅读的技能、AGENTS 文件、命令文档、工具 schema 或公共 API 文档中看到。
  • 共享工作区：智能体创建的产物位于人类可查看、编辑和提交的位置。

Codex 能力阶梯

除非仓库另有说明，假定 Codex 是智能体运行时。优先选择能覆盖该操作的最可重复的证明与交互层：

  1. 测试与脚本优先。单元测试、集成测试、浏览器测试、基准测试、类型检查、lint、导入冒烟测试、生成镜像审计和源审计是默认证明层。若行为可在此证明，应先于此而非手动驱动应用。
  2. 其次 Browser。当测试无法完全证明渲染行为、原生选择、焦点、导航、截图、控制台/网络状态或真实路由行为时，使用 Browser 插件进行应用/浏览器交互证明。
  3. Browser 之后用 Chrome。当任务依赖用户已有的 Chrome 状态、配置文件、标签页、扩展、cookie，或 Browser 无法访问的站点状态时使用 Chrome。
  4. Computer Use 最后。用于测试、Browser 和 Chrome 都无法触及的操作系统级或原生应用操作。它强大但脆弱；需记录精确的人工证明和任何限制。

当聚焦的测试、命令或源审计能提供更强证据时，不要直接跳到 UI 自动化。除非所选层可重跑或能精确描述到让另一个智能体重复，否则不要声称某行为是智能体原生的。

Dotai 集成

  • 对持久或可度量的工作使用 autogoal；首个检查点必须在实现前将对等性要求复制到计划中。
  • 当技能、规则、模板或生成镜像跨越仓库边界时使用 sync-skills；共享行为归 dotai，仓库策略保留在本地。
  • 当缺失的对等性是可复用的品味或准则而非单个任务的机制时，使用 sync-vision。
  • 对 PR 审查反馈使用 resolve-pr-feedback；不要嵌套强制自动审查；仅在完整的端到端功能之后，可选独立二次审查能实质性帮助时才推荐它。
  • 当过时的兼容、虚假别名、失效命令或重复的智能体路径应被删除而非包装时，使用 hard-cut。
  • 当对等性缺口是真实的行为缺陷、不稳定证明或失败路径不清晰时，使用 tdd 或 diagnosing-bugs。

审查流程

1. 识别变更面

对操作面进行分类：技能/工作流（SKILL.md、.mdc、计划模板、生成镜像、锁文件）；命令/工具（CLI 命令、脚本、MCP 工具、GitHub 工作流、包脚本）；公共 API（导出的包 API、文档示例、发布产物）；产品操作（按钮、表单、键盘快捷键、浏览器路由、操作系统/设备路径）；维护者操作（问题分诊、PR 反馈、安全公告、发布通道）。增量审查时，从变更文件出发，仅扩展到证明对等性所需的源文件归属、生成镜像、锁文件、命令或文档。

2. 构建对等映射表

对每个有效操作使用如下映射：用户操作 | 智能体路径 | 源文件归属 | 镜像/锁/文档 | 证明 | 状态。状态规则：pass 表示源文件归属、路径、证明和可发现性均存在；gap 表示智能体无法安全执行或验证该操作；N/A 表示有意仅限人工或超出当前仓库权限，并附具体原因。

3. 检查源文件归属

标记任何要求智能体编辑输出而非源文件的工作流。常见源边界：.agents/skills//SKILL.md 已安装镜像对应外部技能包或 .agents/rules/ 源文件；.claude/skills/**/SKILL.md 同理；根 AGENTS.md 生成块对应 .agents/AGENTS.md 或仓库生成器输入；生成的 barrel/导出文件对应包源加 barrel 生成器命令；生成的文档/模板输出对应仓库策略指定的 registry/包/文档源；跨仓库复制的技能对应 dotai 源加 Skills CLI 安装/更新。当错误的归属会导致未来智能体在同步时丢失修复时，严重级别为高。

4. 检查智能体路径

路径必须无需隐藏的人工上下文即可使用：技能名或工具可从可用技能列表、AGENTS.md、README 或命令文档中发现；参数足够明确，智能体能正确调用；所需的凭据、浏览器状态、本地环境或外部访问均已指明；权限边界清晰：只读、打补丁、提交、推送、评论、合并、发布、删除。不要为每个小操作都要求一个包装技能；当现有路径合适时，优先修补归属技能、AGENTS 路由或命令文档。

5. 检查证明

每个重要的智能体操作都需要验证路径：精确的命令、工作目录和预期结果；生成镜像或锁文件审计；UI 行为变更时的浏览器路由/截图/控制台注意事项；公共维护者状态变更时的问题/PR/安全获取；结构性声明时的源审计；无自动化证明适用时的 N/A 原因。证明必须在所属工作区运行。下游安装不能仅凭源包验证来证明，源包变更也不能仅凭下游命令来证明。

6. 检查上下文

智能体需要与人类维护者相同的操作上下文：相关愿景/准则文件已链接或路由；项目特定命令位于项目中而非 dotai 中；最终交接告知用户改动了什么、需要注意什么、哪些未验证；反复出现的遗漏写入持久归属文件，而非留在聊天中。若缺失的上下文是可复用品味，路由至 sync-vision；若是工作流机制，修补技能/模板；若是一次性的，记录在活动计划或最终交接中。

发现分级

按后果分级：P0 表示智能体可在无权限或无证明的情况下执行破坏性/公开操作；P1 表示重要的用户或维护者操作没有安全的智能体路径，或源/生成边界错误；P2 表示路径存在但难以发现、缺少证明，或会在同步时腐化；P3 表示措辞或文档上的润色，能提高智能体成功率但非阻塞。抑制低置信度猜测；若需运行时观察，应请求或运行证明，而非编造发现。

不应标记的内容

仅限人工的安全/法律/支付流程；无操作意义的外观性 UI 操作；当仓库没有为智能体提供安全权限模型时，罕见管理任务缺失自动化；有意将产品策略排除在 dotai 之外的仓库本地分支；仅因所需同步命令尚未运行而过期的生成镜像——应请求同步/证明。

输出格式

输出 Agent-Native Review，包含：Verdict（PASS 或 NEEDS WORK）；Capability Map 表格（用户操作、智能体路径、源文件归属、镜像/锁/文档、证明、状态）；Findings 列表（含 P1 等分级、标题、file:line、影响、修复、证明）；Accepted/Rejected 部分；Verification 部分（命令或源审计 → 结果）；Needs Attention 部分。