构建或重用技能

如果你有可重复的任务和目标 Microsoft 体验,请使用本文来决定是构建技能还是调整现有技能内容。 然后,选择产品的创作步骤。 你正在 生成或重用。 结果是一个技能实现及其依赖项和测试证据,在 包 & 测试之前可以集成。

重用或扩展技能

对于声明式代理,代理生成器和代理工具包不支持跨代理重用。 遵循 声明式智能体技能中的支持矩阵;不要假设附加到一个代理的技能可以与另一个代理共享。

创建技能前:

  1. 查看已执行所需作业的已批准技能。
  2. 确认目标代理或 Microsoft 体验支持技能格式和功能。
  3. 查看其说明、资源、脚本、工具和数据访问。
  4. 在调整现有技能内容之前,请检查目标体验记录的重用限制。
  5. 确认所有权、版本控制、共享、支持和更新预期。
  6. 使用有代表性的输入和预期输出来测试技能。

如果没有现有已批准的技能满足要求或目标体验不支持重复使用,则创建新技能。

选择实现路径

从 Work IQ Dev Tools 开始,进行专业开发。 为您的目标体验和项目类型选择路线;共享 SKILL.md 格式不会建立跨代理重用或发布资格。

开发方法 技能项目和范围 开始于
工作 IQ 开发工具 独立插件中的顶级技能文件夹,或添加到现有声明式代理项目的技能。 这些是单独的创作路由。 使用 Work IQ Dev Tools 生成插件 ,路线详情如下
Copilot 对话助手技能创作和插件分发 遵循特定于产品的创作和分发指南。 为 Copilot 对话助手构建技能
代理生成器 上传到声明式代理的完整技能 ZIP,或根据智能体生成器中的描述创建的技能。 使用智能体生成器添加技能
Microsoft 365 代理工具包 添加到现有声明式代理项目的技能目录,而不是独立的技能 ZIP。 使用代理工具包添加技能
Copilot Cowork 在 Microsoft 365 应用包中注册的技能文件夹。 使用 Cowork 程序包要求和限制。 为 Copilot Cowork 生成插件

将项目与其发布路由匹配

遵循工件的发布指南:

支持一个工件并不能为每个插件包建立发布资格。 发布不会完成用户访问、同意或连接设置。

GitHub Copilot 可协助提供技能说明、支持脚本、资源、测试和存储库更改。 目标体验和创作工具确定支持的技能格式和运行时。

工作 IQ 开发工具

WIQD 提供两种不同的技能创作途径。

  • wiqd plugin add skill 将顶级技能添加到独立插件项目。 插件可以仅限技能,也可以将技能与受支持的代理或远程 MCP 连接器组合使用。 单独确认目标产品的支持。
  • wiqd agent add skill 向现有声明式代理项目添加技能。 此路由使用 agent-skills 功能标志,该标志默认关闭。

这两种路由都创建了 SKILL.md基于功能,但它们对不同的项目类型进行操作。 在 WIQD 插件格式中,技能名称必须与其文件夹名称匹配,并且其说明应包含激活它的短语。 请参阅 什么是插件? 和 插件创作参考。

WIQD 源验证 (wiqd plugin validate --mode source) 不检查技能内容。 打包后,使用实际的 ZIP 路径运行 wiqd plugin validate --mode package --package-file "<path-to-existing-zip>" 。 程序包验证会将该 ZIP 的捕获副本上传到 Microsoft 365 验证服务,并且可能需要身份验证。 查看返回的结果;传递不会建立运行时行为。 请参阅 验证和 MVL。

实现技能

完成适用的工作:

  1. 定义作业、输入、预期输出、边界和成功标准。
  2. 创建或导入技能说明。
  3. 添加所需的支持资源和脚本。
  4. 配置任何必需的工具、远程 MCP 服务器、API、标识、权限或数据依赖项。
  5. 确认支持的文件类型、脚本类型、沙盒行为、存储和敏感度要求。
  6. 测试预期的、不明确的、不受支持的和失败方案。
  7. 记录技能版本、所有者、依赖项、已知限制和支持过程。

有关直接在 Copilot 对话助手中使用的技能,请参阅为 Copilot 对话助手构建技能。 有关声明式代理中的当前支持和运行时约束,请参阅 声明式代理中的技能。 对于 Copilot Cowork,请参阅伴侣文件限制。 将技能分配给多个体验时,应用每个目标主机的要求。

确认技能是否有效

在以下情况下,该技能已准备好进行集成:

  • 目标代理或体验可以加载和使用它。
  • 其指令一致地执行定义的作业。
  • 所需的资源、脚本、工具和数据可用。
  • 权限和外部依赖项在开发或测试环境中工作。
  • 不受支持或失败的操作会产生可理解的行为。
  • 记录所有权、版本控制、限制和测试证据。

继续执行计划中的任何其他组件。 完成后, 集成并测试您的组件,然后转到 “包 & 测试 ”以 创建插件包。