用途
该技能用于维护一个项目的验证技能（verification skill）及其产品/智能体访问映射，使其与当前源代码和真实证据保持对齐。它面向 /maintain-verification-skill 场景，也用于审计验证技能与映射的一致性。
主要能力
- 读取映射契约、功能索引（feature index）和智能体访问索引（agent access index）。这些是 maps/ 下的同级映射，使用相同的区域文件名和能力 ID。
- 配对同名功能文件与智能体访问伴随文件，匹配稳定子功能 ID，修复孤立/缺失条目和失效引用。
- 区分不同证据类型：API 端点、OpenAPI actor 标签、声明的场景工具、已准入的生产智能体路径属于不同证据；分别跟踪源码审查、操作审查和已执行证明。
- 报告结果时分别说明源码范围、实时范围和剩余缺口，结果分为 clean、changed、blocked 三类。
- 定向审计只覆盖其命名区域，不呈现为完整通过；完整通过需从源码读取每个区域并执行每个可达功能，以及相关的已准入智能体和拒绝路径。
使用方式
- 定位目标与范围：找到项目本地的验证技能（通常位于 .agents/skills/verify-*/）。若有多个候选，询问选择哪一个；若没有，指向 /create-verification-skill。尊重请求的更窄审计范围。
- 使用 Git diff/history 识别受影响的源码，在 PR 或证据报告中记录源码修订和审查证据，而非共享映射台账。
- 检查两个索引：配对同名功能与智能体文件，匹配稳定子功能 ID，修复孤立/缺失条目和失效引用。对于 Paperclip，运行 node scripts/check-maps.mjs。该检查只验证结构，不验证 API 授权、真实工具绑定或实时行为。
- 源码波次：按区域使用只读子智能体，每个读取者负责功能文件及其访问伴随文件；读取者不编辑、不驱动应用。返回内容包括用户能力/源码入口点、可能的漂移及引用、有意义的操作及其 API、actor/grant/resource/run/mode 边界、按界面划分的真实智能体入口点、缺失的访问/发现/策略决策，以及简明的验证配方。
- 调和两个映射：抽查引用的漂移，将配方合并为尽可能少的应用状态。每个受影响的业务操作都需要一个 API 和一个已准入的智能体路径，或明确标记缺口。区分原生/远程访问与旧版 REST 及个人助理 OAuth。记录字段/范围限制、不可用客户端、协议要求和原生回退限制。
- 实时通过：验证维护通过所必需，即使源码看起来干净。协调者负责串行驱动，使用目标技能现有的启动/诊断/证据/清理工作流以及 Paperclip 现有的 API/runner/MCP 夹具。分别执行真实用户路径和相关的实际智能体路径。
- 保持三个不变量：驱动前和出现意外后做健康检查；验证捕获的证据在清理后仍保留；驱动所拥有的一切在不再需要后清理干净。
- 分类与记录：用户描述/配方漂移更新产品映射；端点/路径/权限/发现漂移更新其伴随文件。缺失或损坏的产品行为保持为产品缺口，并附证据。
- 审查修正：重新阅读更改的文件，检查配对的 ID/引用，运行最小的相关验证。如实报告结果和源码/实时覆盖情况。
编辑范围
对于 Paperclip，可编辑目标验证技能、必要时这些维护说明、maps/ 以及映射特定的结构检查脚本 scripts/check-maps.mjs / scripts/check-maps.test.mjs。当映射位置/ID 变化时，修复贡献者文档或技能说明中对这些映射的引用。将映射保留在 maps/{feature-map,agent-access-map}/ 下，位于技能目录之外。
对于其他项目，维护其现有的验证技能和映射位置；Paperclip 的目录约定不授权迁移其他仓库。维护运行中绝不编辑产品 API、权限执行、工具绑定或 UI 行为。将产品/访问缺口单独记录以供实现；权限拒绝不是扩大访问的授权。
适用场景
- 对验证技能及其映射进行定向审计或完整通过。
- 在源码变更后检查功能映射与智能体访问映射是否漂移。
- 需要区分源码证据与实时证据、并如实报告覆盖缺口时。
限制
- 结构检查脚本只验证结构，不验证 API 授权、真实工具绑定或实时行为。
- 仅源码基线有用，但不能证明完整覆盖或实时行为。
- 板级请求或板级 test-as-agent 不能替代智能体凭证证明。
- 不得假设可选客户端被准入到原生运行。
- 不得为了通过维护报告而实现访问策略更改。
- 生成的 maps/generated/coverage.json 是页面引用清单，不是通过的测试证据。
- 不提交临时运行日志作为映射内容。
- 来源与许可：NOTICE.md。