Skip to content

第 34 章事实核验:团队级 Skill Library

核验范围

本轮逐项检查正文中可归因给格式规范、Codex、Anthropic 或 Semantic Versioning 的陈述。技能注册记录(Skill Registry Record)、技能契约(Skill Contract)、准入审查(Admission Review)、质量等级(Quality Tier)、兼容性声明(Compatibility Declaration)、反馈记录(Feedback Record)与弃用记录(Deprecation Record)均是本书工程模型;三个候选也均是虚构教学输入,不作为外部事实核验对象。

可归因陈述

编号正文中的陈述来源与核验范围核验结论
FC-01Agent Skills Specification 将 Skill 规定为至少含有 SKILL.md 的目录;其 frontmatter 要求 namedescription,并定义了可选的兼容性、元数据与实验性 allowed-tools 字段。REF-024,2026-07-16 通过 AgentReach 的网页读取路径重读规范。可作为目录、格式字段和按需资源组织的有限背景;不支持任一客户端均实现同一校验、加载顺序、工具策略或团队治理流程。
FC-02Codex 文档说明其 Skill 可从仓库、用户、管理员和系统位置发现;description 参与隐式触发;直接 Skill 面向本地创作,而 plugin 用于可复用分发。REF-106,2026-07-16 通过 AgentReach 重读 OpenAI 官方 Codex 文档。可作为 Codex 产品语境中的发现、描述与分发边界;不支持其他产品具有相同路径、插件格式、上下文预算或触发结果。
FC-03Anthropic 的企业指南要求在部署第三方或内部贡献的 Skill 前进行审查,并把不受信任来源的 Skill 安装按生产软件同等严格对待。该指南还列出触发准确性、隔离、共存和输出质量等部署前评估维度。REF-108,2026-07-16 通过 AgentReach 重读 Anthropic 官方企业指南。可作为安全审查、评估、所有权、版本、监测和弃用的组织层背景;不是跨供应商合规标准、运行时授权、隔离保证或实际部署证明。
FC-04Semantic Versioning 2.0.0 要求先声明清晰的 public API;不兼容 API 改动、向后兼容新增和向后兼容缺陷修复分别对应主、次、补丁版本语义;已发布版本不可原地修改。REF-109,2026-07-16 通过 AgentReach 重读规范。可作为“先声明可观察契约,再讨论版本意图”的受限类比;不支持从自然语言 Skill 的版本号推断模型选择、输出质量、安全属性、外部工具结果或迁移已经兼容。

CH34-REF-01、CH34-REF-02、CH34-REF-04 与 CH34-REF-05 分别映射 REF-024、REF-106、REF-108 与 REF-109;上述映射只支持本表中的有限陈述。

来源受阻与收紧措施

CH34-REF-03/REF-107 的 Anthropic overview 本轮经 AgentReach 读取时未返回可核验的正文;改用带有可读正文的企业指南只能核对其自身的治理与审计陈述,不能代替 overview 的目录结构或产品表面结论。因此正文已移除对 REF-107 的重新确认性表述,且本轮不以该来源支撑任何正文事实。该来源保留在 Research Brief 和参考资料中作为既有研究追溯,不等于本轮已重新核验。

本书工程模型,不归因来源

编号工程模型或教学输入写作限制
EM-01Skill Registry Record、Skill Contract、Admission Review、Quality Tier、Compatibility Declaration、Feedback Record 与 Deprecation Record。是本书为团队治理提出的可审查工件,不称为 Agent Skills、Codex、Anthropic 或 SemVer 的固定 schema 或已运行服务。
EM-02proposallimitedmaintainedstoppedrequires_approvalrequires_reviewnot_ready_to_publish是本章教学路由,不是任何产品的状态枚举、风险分级、授权或执行结论。
EM-03API 契约测试、文档事实核验和发布检查三个候选。是注入的虚构教学记录;不读取仓库、网络、凭证、产品账户或外部系统,也不代表任何 Skill 已安装、发布、选择或执行。
EM-04Mermaid 生命周期图和计划中的纯内存准入评估器。只表达本书的证据缺口、人工复核和保守停止路线,不代表发现、工具调用、发布、外部动作或效果已经发生。

明确未核验或不覆盖的范围

  • 未验证任何真实 Skill 的发现、安装、打包、发布、产品配置、插件市场、组织登记、网络、MCP、浏览器、文件写入、凭证、运行时权限、生产评估、使用分析、迁移或弃用执行。
  • 未把 Agent Skills 的格式、Codex 的产品发现、Anthropic 的企业治理建议或 SemVer 的版本语义拼接成通用平台行为、安全认证、选择准确率或业务效果保证。
  • 本次不重跑示例或全仓 npm run validate;示例运行与全仓验证由其独立阶段及主线程统一记录。

从同一套 Markdown 书稿生成。