实用提示：六大科技巨头联合打造AI智能体插件

《实用笔记》操作指南：在MCP之后，六大科技巨头共同制定AI智能体插件打包标准——涵盖合同、校验及即插即用代码。

1548 词

本指南将逐步展示如何从原始材料构建出可运行的系统，内容涉及：在MCP和SKILL之后，六大科技巨头联合制定了AI智能体插件打包标准。重点在于可操作的步骤、明确的检查点，以及可直接放入代码库而无需猜测其用途的代码。在开始修改代码之前，应先明确输入参数、该步骤的负责人以及完成标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测其中的隐藏状态。除了功能结果外，还需记录执行时间以及令牌或查询成本。提前了解成本情况，可避免在系统从演示环境过渡到共享环境时出现意外费用。

目录结构

在设计目录结构时，首先列出相关规范：所需的输入参数、成功信号以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。将配置信息置于应用程序代码之外。环境文件、密钥存储以及功能开关应集中存放于一个位置，这样操作人员无需查看整个系统结构即可进行审计。为每次调用记录工具名称、参数哈希值、延迟时间以及执行结果。如果没有这些记录，调试代理将陷入无止境的循环，耗费大量时间。

reports-plugin/
├── plugin.json                  # Required: The only entry point for the plugin
├── skills/                      # Optional: Collection of skills
│   ├── summarize/               # One individual skill
│   │   ├── SKILL.md             #   Required: Skill definition file
│   │   ├── scripts/             #   Optional: Scripts used by the skill
│   │   │   └── analyze.sh
│   │   └── references/          #   Optional: Reference documentation for the skill
│   │       └── checklist.md
│   ├── deploy/                  # A second skill
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   │   └── rollback.sh
│   │   └── references/
│   │       └── runbook.md
│   └── code-review/             # A third skill
│       └── SKILL.md
├── mcp.json                     # Optional: MCP server configuration
├── com.cursor.tools/            # Optional: Cursor-specific extensions, other clients skip automatically
│   └── hooks/
│       └── hooks.json
├── LICENSE
└── CHANGELOG.md

plugin.json 规范

在处理 plugin.json 规范时，首先需明确相关约定：所需的输入参数、成功信号以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改始终符合要求。同时记录正常流程与异常恢复流程。重试机制、人工审核环节以及死信处理都是产品功能的一部分，而非后续需要补充的内容。需为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试过程将会浪费大量时间。

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hello-plugin"
}

组件发现

在开展组件发现工作时，首先需明确接口规范：所需的输入参数、成功信号以及部分失败时的处理方式。这份清单能确保后续的代码修改保持一致性。相比冗长的脚本，应优先选择小型且可测试的单元。当某个步骤出错时，故障应指向单一责任模块，而非复杂的流程链。需为每次调用记录工具名称、参数哈希值、延迟时间以及执行结果。没有这些记录，调试过程将会浪费大量时间。在开展组件发现工作时，首先需明确接口规范：所需的输入参数、成功信号以及部分失败时的处理方式。这份清单能确保后续的代码修改保持一致性。在功能结果旁还需记录执行时间以及令牌或查询成本。提前了解成本情况，可避免在从演示环境过渡到共享环境时出现意外费用。

MCP配置

MCP配置若被视为可度量的对象，其效果会最佳。在扩大应用范围之前，先记录一份理想的运行日志、一个故障案例以及回滚说明。应将配置与应用程序代码分开。环境文件、密钥存储和功能开关应集中存放于一处，以便操作人员无需查看整个系统结构即可进行审计。需提供具有明确数据结构定义及清晰副作用标注的工具。主机在自动批准操作之前，必须了解哪些调用会改变系统状态。

环境变量与数据持久化

将环境变量与数据持久化视为可度量的对象来处理，效果最佳。在扩大范围之前，先记录一个成功的案例、一个失败案例以及回滚说明。同时记录正常流程与恢复流程。重试机制、人工审核环节以及死信处理都是产品本身的一部分，而非后续需要补充的功能。提供具有明确结构规范和清晰副作用标识的工具。主机需要在自动批准之前知道哪些调用会改变状态。

隔离的局部故障

将“孤立的部分故障”视为可度量的对象来处理效果最佳。在扩大范围之前，先记录一份标准示例、一个故障案例以及回滚说明。优先选择小型且可测试的单元，而非庞大的脚本。当某一步骤出现故障时，故障应指向单一责任模块，而非复杂的流程链。使用具有明确结构规范和清晰副作用标签的工具。主机需要在自动批准之前知道哪些调用会修改状态。将“孤立的部分故障”视为可度量的对象来处理效果最佳。在扩大范围之前，先记录一份标准示例、一个故障案例以及回滚说明。在功能结果之外，还需记录执行时间以及令牌或查询成本。提前了解成本情况，可避免在从演示环境过渡到共享环境时出现意外费用。

未覆盖区域

对于未覆盖的区域，在修改代码之前需明确输入参数、该步骤的负责人以及结束标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。配置信息应置于应用程序代码之外。环境文件、密钥存储以及功能标志应集中存放于一个位置，以便操作人员无需查看整个系统结构即可进行审计。在网关处进行身份验证，在数据层再次授权。仅凭承载令牌并不能作为租户边界。

支持者与缺席者

对于支持者和缺席者，在修改代码之前需明确输入参数、该步骤的负责人以及退出标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。需同时记录正常流程和异常恢复流程。重试机制、人工审核环节以及死信处理都是产品的一部分，而非后续需要补充的功能。在网关处进行身份验证，在数据层进行重新授权。仅凭承载令牌并不能界定租户边界。

实际案例：使用 Google Agents CLI 的完整工作流

实际应用示例：使用 Google Agents CLI 的完整工作流，在修改代码之前需明确输入参数、各步骤的负责人以及结束条件。操作人员应能够从已知的检查点重新运行相应步骤，而无需猜测隐藏状态。优先选择小型、可测试的单元，而非庞大的脚本。当某个步骤失败时，故障应指向单一责任主体，而非复杂的流程链。在网关处进行身份验证，在数据层再次授权。仅凭承载令牌并不足以界定租户边界。实际应用示例：使用 Google Agents CLI 的完整工作流，在修改代码之前需明确输入参数、各步骤的负责人以及结束条件。操作人员应能够从已知的检查点重新运行相应步骤，而无需猜测隐藏状态。在功能结果之外还需记录执行时间以及令牌或查询成本。提前了解成本情况可避免流程发生变化时出现意外账单。

将演示环境迁移到共享环境。

运营检查清单

若将运营检查清单视为可衡量的指标，其效果会更好。在扩大范围之前，先记录一份标准操作流程、一个失败案例以及回滚说明。将此阶段视为输入与验证后输出之间的契约。为相关成果命名，明确成功标准，杜绝默许的部分完成情况。

公开那些具有有限架构且带有明确副作用标签的工具。在自动批准之前，主机必须知道哪些调用会修改状态。

对于那些会花费资金或更改生产数据的操作，必须经过人工审批。编译时的连接方式并不等同于业务功能的完整性。

编写简短的操作手册：包括如何轮换密钥、如何清空队列以及如何回滚上一次的导入操作。

同时记录正常流程和故障恢复流程。重试机制、人工审核环节以及死信处理都是产品不可或缺的部分，而非后续才需要补充的功能。

在升级整个技术栈之前，先冻结版本，为关键流程保存完整的操作记录，并确认好回滚步骤。共享环境需要设置速率限制、进行租户检查，同时明确密钥轮换的负责人。与其追求花哨的一次性演示，不如注重扎实的可靠性。

关于6e2f83d3e5dc的批处理说明：不要将提供者密钥放入代码仓库，为每个会话设置令牌上限，并将转录内容存储在评估测试用例的旁边，以便后续更换模型时仍能保持可比性。

全部文章发送简报