SuperAPI AI 工具集

cowork-plugin-engineer

安全与审计

查看项目

更新于 10-16 00:31

技能介绍

Copilot Cowork Plugin Engineer 用于构建可上传的 Cowork 插件,并将 Microsoft 365 应用包、其认证配置与部署视为彼此独立的关卡。

用途:创建、导入、修复、认证、打包、校验、侧载、评估、升级或排障 Microsoft Copilot Cowork 插件。

主要能力与流程:先阅读 package-contract.md,并在选择清单版本或做发布、预览、认证、许可相关判断前检索 Microsoft Learn 当前文档;清单基线升级需遵循 manifest-upgrade-instructions.md。检查源码但不修改,识别原生 Microsoft 365 应用包、Claude/Cursor/Agent Plugin 包、仅含技能的文件夹或现有 Agents Toolkit 项目;新项目用 scripts/new_cowork_plugin_project.py,开放插件导入参考 import-and-normalization.md,已有项目先校验再编辑,已有 ZIP 用 scripts/test_cowork_plugin_package.py 且不信任解压无保护路径。若存在 MCP 连接器,通过 initialize、notifications/initialized、tools/list 发现工具,不得臆造工具名或 schema,并阅读 authentication.md;未解析的 OAuth 占位符不得产出可部署 ZIP。有源码项目时先跑 scripts/test_cowork_plugin.py,再用 scripts/build_cowork_plugin.py 通过 Microsoft 365 Agents Toolkit (atk) 打包与校验;纯 ZIP 请求不重新校验或重建,以通过校验的 ZIP 为最终候选并返回其准确路径。需要评估时阅读 evaluations.md 并用 scripts/new_cowork_plugin_evals.py,生成的用例视为草稿。仅在用户明确要求时侧载或部署,租户级部署需审批。

标准命令:python3 scripts/test_cowork_plugin.py --project-path <project>;python3 scripts/test_cowork_plugin_package.py --package-path <package.zip>;python3 scripts/set_cowork_oauth_reference.py --project-path <project> --connector-id <connector-id> --oauth-configuration-id <generated-id>;python3 scripts/build_cowork_plugin.py --project-path <project>;python3 scripts/new_cowork_plugin_evals.py --project-path <project>。Cowork Linux 运行时及 Linux/macOS 用 python3,Windows 用 py -3。

限制:不得修改导入的源码树,须从临时暂存副本导入;不得在清单、技能、脚本或 ZIP 中放置密钥、令牌、客户端密钥或 API 密钥;技能文件夹根目录只能有一个 SKILL.md,嵌套文档须改用 REFERENCE.md 等文件名;frontmatter name 须为小写 kebab-case 并与文件夹一致;manifest.json 须位于 ZIP 根目录且无外层目录;升级须保留应用 ID 并递增包版本;不得以原始 Compress-Archive 作为最终验收;不得由包校验推断 MCP 连接成功;配置错误不得反复重试。排障按 troubleshooting.md 将 HTTP 状态、端点与响应体映射到具体层级。Learn MCP 不可用时可用 npx --yes @microsoft/learn-cli search/fetch/code-search 替代。