VouchSpec Agent Skill Evidence

VouchSpec

VouchSpec 是独立的精确 Agent Skill 版本证据索引的临时公开测试版名称。该名称已通过费用为 $0 的明显冲突筛查；尚未获得正式的法律或商标审查许可。

当前 Stage A 目录包含 25 个经过精心挑选的公开 Agent Skill，涵盖 12 个 GitHub 仓库所有者。每个条目都固定到完整的 Git 提交和确切的目录摘要，经过静态检查而不执行制品代码，封装在 DSSE v1.0.2 信封中，并使用 Ed25519 签名。另有一个独立的根密钥为机器可读的生命周期信息流签名。

这是证据，不是安全认证。25 个真实技能中有 6 个未通过至少一项当前结构规则；这些技能仍保留在索引中，并附有失败证据，且不会标记为 STRUCTURE_VALIDATED。

公开 Stage A 分发

• 仓库和安装源：https://github.com/mordiaky/vouchspec
• 机器可读的发现信息：https://raw.githubusercontent.com/mordiaky/vouchspec/main/distribution/discovery.json
• 托管 Agent API：https://vouchspec.plyrium.com/api/vouchspec/v1/health
• 托管 API 发现信息：https://vouchspec.plyrium.com/api/vouchspec/v1/discovery
• OpenAPI 3.1 契约：https://vouchspec.plyrium.com/openapi.json
• 面向大模型的契约索引：https://vouchspec.plyrium.com/llms.txt
• 可安装的 Agent Skill 索引：https://vouchspec.plyrium.com/.well-known/skills/index.json
• 安装前验证 Agent Skill： https://vouchspec.plyrium.com/.well-known/skills/vouchspec-verify-before-install/SKILL.md
• Agentic Resource Discovery 目录（草案／提案）： https://vouchspec.plyrium.com/.well-known/ai-catalog.json
• A2A Agent Card：https://vouchspec.plyrium.com/.well-known/agent-card.json
• A2A JSON-RPC 发现信息：https://vouchspec.plyrium.com/api/vouchspec/v1/a2a
• 远程 Agent 发现（MCP）：https://vouchspec.plyrium.com/api/vouchspec/v1/mcp
• 官方 MCP Registry API：https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.mordiaky%2Fvouchspec
• Agent Tools x402 列表： https://agent-tools.cloud/api/v1/services/vouchspec-plyrium-com-sub91
• Agent Tools MCP 列表： https://agent-tools.cloud/api/v1/mcp/servers/vouchspec-agent-skill-evidence
• Agent Tools A2A 列表： https://agent-tools.cloud/api/v1/a2a/agents/vouchspec-agent-skill-evidence
• Agent 快速入门：https://vouchspec.plyrium.com/vouchspec
• 通过托管 TLS 提供的签名索引：https://raw.githubusercontent.com/mordiaky/vouchspec/main/catalog/public/index.dsse.json
• 根密钥签名的生命周期信息流：https://raw.githubusercontent.com/mordiaky/vouchspec/main/catalog/public/lifecycle.dsse.json
• 带外发布的根密钥／签发者密钥：https://gist.github.com/mordiaky/794e30c1c33ba1663921718cc8d530e1

静态分发会在启用 CORS 的情况下返回已检入的原始签名字节，并拒绝写入。下载签名索引，在本地筛选，然后按 ID 从 catalog/public/receipts/ 获取凭证。若要进行不可变检索，请将 main 替换为目录快照 4404b7a9a2d3dc45b621ea694d2ca7ad666b9898。带外 Gist 与仓库相互独立，但共用同一个 GitHub 账户，因此若账户级别遭到入侵，仍需使用新的可信渠道。

产品阶段

• **阶段 A — 公共制品索引（已上线）：**仅包含精选的公共制品；提供签名回执和只读 REST/MCP 检索；不支持上传、私有仓库或客户机密内容。
• **阶段 B — 公共仓库验证（主网已上线，另有公共测试网沙盒）：**允许列表中的公共主机、完整提交、明确的子目录、范围受限的不可变检索、隔离且无出站网络的工作进程、独立的无出站网络签名、持久化的租户/订单/付款状态、经过身份验证的托管 API，以及精确的 x402 结算。商业订单已在 Base 上线，价格为 0.25 USDC；独立的 1.00 测试 USDC Base Sepolia 沙盒仍可用于集成测试。
• **阶段 C — 私有/任意输入（暂缓）：**只有当需求和收入足以支撑时，才会提供私有存储、身份验证、租户隔离、删除政策，以及扩展的法律/事件控制。

阶段 C 并非阶段 A 或 B 的前提。阶段 A 服务端或 MCP 工具中均不存在任意上传入口。

Publisher CI — 完整的自助示例

公共的 Publisher CI 演示展示了完整的可信工作流路径：不可变的操作固定、精确提交检查、两个 GitHub 制品证明、可下载的证据，以及独立的 gh attestation verify 命令。最新的已验证矩阵运行通过了结构通过案例和有意设置的结构失败案例。通过 gh attestation verify 独立验证了下载的四个证据文件。该演示由运营方控制，不计入外部采用情况。

请使用此操作的不可变且保留证据的快照：

- id: vouchspec
  uses: mordiaky/vouchspec/distribution/github-action@ed812a14cbc62333d59bac319f79d897f14d1b64
  with:
    skill-path: path/to/skill

无论结构检查通过还是明确失败，该操作都会生成回执草稿以及发布者/工作流绑定。请参阅完整的固定版本工作流、权限、验证和故障排除指南。

证据标签

回执使用明确的标签，绝不使用笼统的 VERIFIED 徽章：

• DIGEST_PINNED
• STRUCTURE_VALIDATED（仅当结构配置文件检查通过时）
• STATIC_INSPECTION_COMPLETED
• INDEPENDENT_STATIC_SCAN（仅用于精选的运营方执行配置文件）

PUBLISHER_CI_ATTESTED、SANDBOX_BEHAVIOR_OBSERVED 和 TASK_EVALUATED 专用于已实际生成的独立证据。静态检查绝不意味着这些标签成立。

独立验证公共回执

验证器会在解析 JSON 之前，对精确解码后的回执字节进行身份验证；随后验证回执架构和内部一致性摘要，并可选择应用根密钥签名的生命周期信息源。

vouchspec verify catalog\public\receipts\RECEIPT_ID.dsse.json `
  --key catalog\public\keys\issuer.jwk.json `
  --lifecycle catalog\public\lifecycle.dsse.json `
  --root-key catalog\public\keys\root.jwk.json

生命周期结果包括 CURRENT、SUPERSEDED、EXPIRED、REVOKED_EVALUATOR_DEFECT、REVOKED_KEY_COMPROMISE，以及保守结果 SIGNATURE_VALID_LIFECYCLE_UNKNOWN。签名密钥 ID 仅是查找提示；必须通过独立可信路径获取或固定公共 JWK。

只读目录 API

vouchspec serve-catalog --catalog-root catalog\public --port 8788 `
  --trusted-root-key C:\independently-provisioned\root.jwk.json

可用的 GET 路由：

• /health
• /v1/index（由发行方签名的 DSSE 索引信封）
• /v1/quote?operation=...（价格/可用性响应；付费订单仍处于禁用状态）
• /v1/receipts?q=...&repository_owner=...&limit=...
• /v1/receipts/{receipt_id}
• /v1/receipts/{receipt_id}/status
• /v1/lifecycle
• /v1/keys/root
• /v1/keys/issuer

所有 POST 请求都会收到 405 read_only。内置服务会限制连接数、强制执行截止时间，并且仅监听回环地址；公开部署必须将其置于托管 TLS 代理之后，并设置平台入口限制。每个进程只服务一个经过完整验证的不可变目录快照；要部署新的生命周期/索引版本，需重启进程。已观测到的最高根源馈送序列号及其负载摘要会通过跨进程锁持久化。

本地目录价格卡路由会报告商业价格假设，但不会接受订单。若要进行严格的、针对特定请求的本地预览：

vouchspec quote-fresh-validation docs\examples\fresh-validation-request.json

此预览会验证与托管 API 相同的请求格式。公开沙盒价格特意设为极低额度，即 1.00 测试 USDC。完整的 Agent 市场研究否定了先前提出的 49 美元方案；商业主网首发批次的价格为每次新的验证 0.25 USDC，但尚未经过验证，预先声明的证据门槛见 PRICING.md。

仅限 Agent 的 x402 主网

位于 https://vouchspec.plyrium.com 的商业服务仅供机器使用，没有银行卡表单、托管结账、账户门户或人工审批步骤。Agent 将严格的不可变公开 GitHub 请求发送至 POST /api/vouchspec/v1/validate，收到一项金额恰好为 0.25 USDC（Base） 的 x402 v2 挑战，完成签名后使用 PAYMENT-SIGNATURE 重试。结算成功后会返回一次性传递凭据；随后，定时隔离工作器会生成带签名、内容寻址的收据。发现和健康检查接口均公开，Streamable HTTP MCP 端点提供只读合约发现功能。同一购买合约还以 OpenAPI、llms.txt、A2A、x402 和草案/提案 ARD 目录的形式发布，方便 Agent 通过其已编入索引的协议接入。补救执行仍处于禁用状态，且不是接受或履行普通付费验证的前提条件。

仅限 Agent 的 x402 沙盒

位于 https://vouchspec-sandbox.plyrium.com 的公开服务没有银行卡表单、托管结账或人工审批步骤。Agent：

1. 在 POST /api/vouchspec/v1/tenants 接受条款版本 vouchspec-stage-b-2026-07-14，并保存一次性租户 bearer 密钥；
2. 使用 Authorization 和唯一的 Idempotency-Key，将严格的新鲜验证请求发送至 POST /api/vouchspec/v1/quotes；
3. 在 POST /api/vouchspec/v1/orders 创建订单，并保存返回的传递令牌；
4. 调用该订单的 purchase_path，读取 x402 v2 的 PAYMENT-REQUIRED 挑战，在 Base Sepolia 上对恰好 1.00 测试 USDC 的付款进行签名，然后使用 PAYMENT-SIGNATURE 重试；
5. 轮询经过身份验证的订单，获取精确的 DSSE 结果，并使用公开的发行方 JWK 验证该结果。

成功的信封也会发布在一个内容寻址的免身份验证 URL 上。Agent 可以缓存并共享这些不可变字节。失效检查刻意单独处理：每次将收据用于新的决策时，都应检查对应的 no-store /status URL。机器可读发现文档包含所有路由模板、标头、网络、价格、信任、缓存和产品边界字段。

托管证明由所有者控制且仅限测试网，因此它仅用于演示操作机制，不计作客户、请求、买家或收入。请参阅 Stage B 运营边界、付款流程、托管部署边界、退款政策以及主网补救操作。

本地 commerce 测试框架

仓库仍包含一个用于回归和安全测试的回环测试框架。它存储带密钥的凭证摘要，从不存储明文令牌，并将每个报价和订单绑定到一个不透明租户。使用经批准的密钥管理器生成两个不同的 32 字节密钥，仅向进程提供其十六进制值，然后配置一个本地沙盒凭证：

$env:VOUCHSPEC_AUTH_PEPPER_HEX = '<64 hex characters>'
$env:VOUCHSPEC_DELIVERY_SECRET_HEX = '<different 64 hex characters>'
vouchspec provision-commerce-tenant --database C:\vouchspec\sandbox-commerce.db
vouchspec serve-commerce-sandbox --database C:\vouchspec\sandbox-commerce.db --port 8789

本地 API 绑定到 127.0.0.1，不允许 CORS，并提供经过身份验证的报价、订单、状态、签名结果、能力轮换和能力撤销路由。其模拟支付通道永不结算，且每个生成的订单均保持 counts_for_goal: false。

显式不结算的 Stripe 测试适配器仍可用于回归覆盖，但仅限于此。它不是 VouchSpec 的上线支付通道，也不会由托管 Agent 服务公开：

vouchspec serve-commerce-stripe-test `
  --database C:\vouchspec\stripe-test-commerce.db --port 8789

不要直接公开内置监听器。主网启用使用 x402、独立的实时状态和密钥，以及部署边界中的实时门控。

只读目录 MCP

远程 Agent 可以通过无状态 Streamable HTTP 端点 https://vouchspec.plyrium.com/api/vouchspec/v1/mcp 发现商业托管合约。它仅公开 get_vouchspec_discovery：一个匿名只读工具，返回公开路由、价格、x402、 收据、缓存和失效说明。它无法提交工件、获取代码仓库、结算付款或读取私有数据。付费验证仍通过托管 x402 REST 路由进行。

支持开放 Agent Skills 格式的 Agent 可以直接添加仓库中原样提供的 验证后再安装工作流：

npx skills add mordiaky/vouchspec --skill vouchspec-verify-before-install

该技能也通过上述众所周知的机器端点发布。它会在执行操作前发现实时合约，先检查是否已有签名证据，并且仅当调用 Agent 已有 x402 钱包和明确的支出授权时，才会购买一次新的 0.25 USDC 验证。如果缺少其中任一项，它会返回 payment_required；没有人工结账或人工转交环节。

仓库中检入的 server.json 为官方 MCP Registry 描述了此远程端点，使用当前名称 io.github.mordiaky/vouchspec。发布通过仅面向主分支的手动工作流使用 GitHub OIDC，因此无需门户登录、手机验证码或专用 Registry 密钥。

对于偏好本地固定目录的 Agent，stdio 服务仍可用：

公开安装：

git clone https://github.com/mordiaky/vouchspec.git
cd vouchspec
python -m venv .venv
.venv\Scripts\python -m pip install .
.venv\Scripts\vouchspec mcp-catalog --catalog-root catalog\public `
  --trusted-root-key C:\independently-provisioned\root.jwk.json

vouchspec mcp-catalog --catalog-root catalog\public `
  --trusted-root-key C:\independently-provisioned\root.jwk.json

工具包括 search_receipts、get_receipt、get_receipt_status、 get_verification_material 和 get_price_quote。它们只接受标识符、搜索文本和命名价格卡操作，不接受工件内容。此本地只读 MCP 不会下达付费订单；Agent 使用托管 x402 API 进行新的验证。

本地检查器和构建器

开发安装：

python -m venv .venv
.venv\Scripts\python -m pip install -e ".[dev]"

兼容性命令和 Python 包名 capabilityproof 仍可使用，同时也提供公开的 vouchspec 命令。

vouchspec inspect C:\path\to\skill --output receipt.json
vouchspec inspect-git C:\checkout\skills\example `
  --repository-root C:\checkout --output receipt.json

本地检查绝不会安装、导入、渲染或执行工件内容。仓库中检入的目录构建器仅接受精选清单以及固定在完整 40 字符提交上的公开 HTTPS GitHub 仓库。采集过程无需密钥，签发方签名是独立的无网络阶段，恢复根生命周期签名则是独立的离线阶段。加密私钥保存在本仓库之外；仅发布 RFC 8037 公共 JWK。

参见方法论、收据架构和威胁模型。