用途:为已有 Claude/Copilot/智能体插件引入 APM 治理、锁文件与审计就绪能力,以及多运行时包管理,采用 Overlay-First 迁移策略,避免不必要的重新打包。
主要能力与迁移模式:
- Overlay 模式(默认):适用于插件处于活跃状态且偏好现有布局时,在根目录添加 apm.yml 与 docs/governance.md,对现有 npx skills 或 Claude Code 工作流零干扰。
- Hybrid 模式:保留插件布局,同时开始添加 APM 原生资产,新增 .apm/ 目录用于新治理资产,现有原语保持原位。
- Full Conversion:创建新目录并将所有原语迁移到 .apm/,始终保留原始插件不被改动。
主要指令:除非用户明确要求,否则不强制将 .apm/ 作为新的唯一事实来源。
使用方式:转换后运行校验命令:python scripts/validate_apm_package.py --path <target-path>
Full 模式映射规则:.claude-plugin/plugin.json 映射为 apm.yml 的元数据;skills/* 映射到 .apm/skills/;agents/ 映射到 .apm/agents/;commands/ 映射到 .apm/prompts/*(APM 标准);hooks/hooks.json 映射到 .apm/hooks/hooks.json。
适用场景:需要为现有插件增加 APM 治理、审计准备或多运行时包管理的用户。
限制:资料未提供具体依赖版本、支持平台范围、收费信息及更多使用示例,暂未提供。