用途：为 GitHub Copilot 技能/智能体仓库编写 apm.yml 根清单或 packages/* 子清单，将 MCP 服务器配置打包进 APM 包，使安装时自动接入 MCP；也可用 APM CLI 从 GitHub 仓库安装包，并排查安装失败问题。不适用于一般 Copilot 定制问题、创建 SKILL.md（应使用 skill-creator）或编写 MCP 服务器实现代码。
主要能力：支持单关注点包（packages/<topic>/apm.yml）与元包（根 apm.yml 引用其他包）两种结构；清单必填字段包括 name、version、description、author、license、target: vscode 及 dependencies.apm；apm 依赖路径必须使用完整 owner/repo/... 虚拟路径，相对路径无效；WIP 技能应注释排除并注明原因；技能需要 MCP 时添加 mcp: 块。
使用方式：安装 CLI 用 curl -sSL https://aka.ms/apm-unix | sh（macOS/Linux）或 irm https://aka.ms/apm-windows | iex（Windows PowerShell），用 apm --version 验证。每个包目录需创建 .apm/.gitkeep 占位，否则 APM 可能无法写入安装缓存。安装命令示例：apm install owner/repo/packages/<name> --runtime vscode；指定分支加 #branch-name；强制刷新加 --update；安装整仓用 apm install owner/repo --runtime vscode。--runtime vscode 确保即使未检测到 VS Code 也写入 .vscode/mcp.json。
限制与排查：缺少 .vscode/ 目录且 code 不在 PATH 时不会生成 mcp.json，可先 mkdir -p .vscode 或加 --runtime vscode；Codex CLI 对 HTTP MCP 服务器的警告属外观问题，安装仍成功，target: vscode 不会抑制该警告；404 多为路径或分支未推送；缓存陈旧可加 --update；apm compile 输出格式错误通常是缺少 target 字段；技能已装但 Copilot 不显示，需确认 copilot-instructions.md 引用了技能目录。测试建议在干净临时目录执行后清理。