plugin-import

1# Plugin Import
2 
3用于把 Git、GitHub、外部 marketplace/catalog 等远程 Plugin 来源安全取得到本地。
4 
5`plugin_manage` 直接接受本地目录或 ZIP，并自动识别 AgentDock Portable、OpenAI 和 Claude Plugin 格式；OpenAI/Claude 的兼容性转换由 Core 在审核前完成，不需要模型手工改写 manifest 或重新打包。这个 Skill 只负责远程来源发现/固定/获取，以及 Core 尚不认识的其他格式。最终包的安全校验、规范化摘要、review token、安装事务和运行时激活仍由 `plugin_manage` 负责。
6 
7## 什么时候使用
8 
9以下情况使用本 Skill：
10 
11- 用户给出 Git / GitHub 仓库或仓库子目录；
12- 用户给出外部 marketplace/catalog 条目；
13- 用户要求更新一个需要重新从远程上游取得内容的 Plugin；
14- 来源格式不是 AgentDock Core 已能自动识别的 Portable/OpenAI/Claude。
15 
16如果用户已经提供本地目录或 ZIP，不论它是 Portable、OpenAI 还是 Claude Plugin，都直接使用 `plugin_manage`，不要先手工转换。
17 
18## 职责边界
19 
20本 Skill 负责：
21 
221. 获取外部内容并尽量固定可追踪的 revision/digest；
232. 对明确的远程来源生成根目录 `.agentdock-import.json`，把用户给出的来源和已验证的 revision/ref/subdir 交给 Core；
243. 把目标 Plugin 目录或 ZIP 准备到本地；
254. 对 Core 尚不认识的其他格式，才由模型做显式转换；
265. 调用 `plugin_manage validate`，检查自动识别结果、format、warnings、provenance；
276. 使用 validate 返回的 review token 安装或更新。
28 
29本 Skill 不负责绕过 Core 校验，也不要对 OpenAI/Claude 包做重复转换。
30 
31## 导入流程
32 
331. **取得来源**
34   - 使用宿主已有的命令、文件、浏览器或连接器能力取得内容。
35   - Git 来源应尽量固定到具体 commit；下载归档应尽量记录可验证的 digest。
36   - 不把凭据、token、带密码的 URL 写进包或 provenance。
37 
382. **准备本地输入**
39   - 如果目标已经是一个本地目录或 ZIP，直接保留原样。
40   - OpenAI `.codex-plugin/plugin.json`、Claude `.claude-plugin/plugin.json` 和 AgentDock `plugin.json` 都交给 Core 自动识别。
41   - 不要为了“兼容”先删除 commands/note 或第三方扩展字段；Core 会保留未知内容，只对自己真正执行的语义做严格判断。
42 
433. **交接远程来源**
44   - 只有当来源是用户明确给出的远程地址，或本次获取流程能够可靠证明远程来源时，才在目标 Plugin 根目录写 `.agentdock-import.json`。
45   - sidecar 只允许 `origin`、`ref`、`revision`、`subdir`。
46…