用途：审计或设计面向智能体的产品能力，核心方法包括动作对等、上下文对等、稳定对象标识、有界输出、验证与恢复。强调文档化能力不等于已实现能力，清单目录不等于智能体能完成任务。
审计现有界面：选5–10个代表性任务及预期结果，覆盖读取、授权变更、拒绝操作、中断恢复。映射每个任务所需上下文、对象ID、可用动作、权限、成功证据与重试/恢复路径，用名词测试：发现、识别、读取、适当变更、验证、恢复。先检查源码/契约，再仅执行授权检查，记录观察属于源码信号、文档声明还是运行时证明。比较人类与智能体路径，保留人类专属的同意、MFA、验证码、生物识别边界，不将绕过计为对等。优先处理已证明的阻塞点，并在相同任务上测试修复。
设计最小有用契约：优先使用产品原生界面。小型CLI可能只需帮助、结构化输出和明确退出码，而非A2A服务器；HTTP集成可能只需现有OpenAPI契约和SDK。写入需定义超时、部分成功、并发编辑、重复投递后的行为；请求ID不自动等于幂等键；确认结果与未知结果分开；预览或哈希不能授权额外工作。长任务需持久ID、明确终态和有界等待。
不执行技能即可检查：将SKILL_DIR解析为包含本文件的已安装目录。运行 python "$SKILL_DIR/scripts/validate_agent_assets.py" --skill-dir /absolute/path/to/skill 前，需在授权环境安装声明的PyYAML依赖，或用支持PEP 723的运行器。校验解析真实YAML、检查必填字段、JSON/Python语法和常规相对Markdown链接，不执行脚本、不写字节码、不联系服务、不验证完整协议模式。旧的--run-help和--py-compile模式已移除。
生成草稿而非已部署发现端点：python "$SKILL_DIR/scripts/generate_agent_assets.py" --output /private/existing-parent/new-drafts --project-name "Example" --base-url https://example.com --surface a2a。默认预览不创建目录，需显式选择surface并加--write才创建新私有草稿目录，不覆盖现有路径。发布前用实际SDK/模式验证，仅声明已实现能力和已实施认证。
维护证据：运行 python -m unittest discover -s "$SKILL_DIR/tests" -v 做本地回归检查。保留领域参考、评估种子、能力映射和MIT许可。限制：扫描器和评分标准是启发式清单辅助，非协议验证器或实测智能体成功率；缺少可选发现约定不构成互操作缺陷，除非有消费者实际要求。