用途：在代码仓库中安装、配置、审计和运行 Agent Package Manager（APM），管理智能体相关包、依赖与 MCP 服务器，并支持编译与打包分发。
主要能力：初始化项目（apm init、apm init --yes）、维护 apm.yml 与 apm.lock.yaml、安装/更新/删除/清理包、依赖树与信息查询、MCP 服务器发现与选择、编译校验与监听、运行脚本与运行时管理、打包解包分发。安装时会扫描包安全威胁（如隐藏 Unicode、内容哈希校验），默认阻止未声明的传递性 MCP 服务器；组织策略 apm-policy.yml 会在安装时施加额外限制。
用法要点：先执行 apm --version 与 apm config 确认环境；用 apm install、apm install <package>、apm install --update、apm deps update 管理依赖，改动前用 --dry-run 预览；用 apm deps list/tree/info 校验，apm.lock.yaml 作为已解析提交与部署文件的真源，建议提交以保障团队与 CI 复现；MCP 用 apm mcp list/search/show；编译用 apm compile --validate、--dry-run、--watch；脚本用 apm list、apm preview、apm run；运行时用 apm runtime status/list/setup；打包用 apm pack、apm unpack。
适用场景：仓库引入或修复 APM 配置、多运行时/多工具族的依赖与指令文件生成、CI 扇出、离线交付与发布追溯，以及需要安全审计与组织策略约束的包管理。
限制：apm 缺失需先安装；组织策略阻止时不得绕过，需联系管理员；认证失败需先修复主机认证；文件冲突需检查诊断，--force 仅在明确覆盖时使用；本地路径依赖在打包前须替换为远程引用；apm compile 主要用于生成 AGENTS.md/CLAUDE.md 等指令文件，无需要时不必添加。