背景

oh-skillhub@latest 支持从远端 openharmony-skills#release 获取中立源 workflow plugin，并为 Codex、Claude Code、OpenCode 生成对应宿主载荷。

当前支持的 workflow plugin：

Plugin	说明
ohos-delivery-kit	ODK/OpenHarmony 交付件工作流插件

通用规则

• 默认远端源：https://gitcode.com/openharmonyinsight/openharmony-skills
• 默认分支：release
• 默认 scope：建议使用 user
• 支持 agent：codex、claude、opencode、all
• 建议安装、更新、卸载后重启对应 Agent 或打开新会话。

交付结构

oh-skillhub 使用“中立源 + 宿主投影”的方式管理 plugin：

层级	作用
canonical store	保存插件中立源内容，按内容 digest 归档
projection	为 Codex、Claude Code、OpenCode 生成各自原生 plugin payload
registry	记录插件、digest、已安装 agent、projection 路径和宿主注册信息

一键安装到三端

安装 ODK：

npx oh-skillhub@latest plugin install ohos-delivery-kit --agent all --scope user

只查看计划，不写入文件：

npx oh-skillhub@latest plugin install ohos-delivery-kit --agent all --scope user --dry-run

Codex

安装

npx oh-skillhub@latest plugin install ohos-delivery-kit --agent codex --scope user

更新

npx oh-skillhub@latest plugin update ohos-delivery-kit --agent codex --scope user

Dry-run：

npx oh-skillhub@latest plugin update ohos-delivery-kit --agent codex --scope user --dry-run

卸载

npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent codex --scope user

Dry-run：

npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent codex --scope user --dry-run

Codex 行为说明：

• 生成 Codex 原生 plugin projection。
• 注册 Codex marketplace。
• 更新 CODEX_HOME/config.toml 中对应 plugin enable 配置。
• 卸载时删除 Codex projection，并移除对应 marketplace/config 注册。

Claude Code

安装

npx oh-skillhub@latest plugin install ohos-delivery-kit --agent claude --scope user

安装后，通过 Claude Code 原生命令启用插件：

claude plugin install ohos-delivery-kit@ohos-delivery-kit-local

查看 Claude 插件状态：

claude plugin list

更新

npx oh-skillhub@latest plugin update ohos-delivery-kit --agent claude --scope user

如果 Claude 侧已经启用该插件，可继续执行 Claude 原生更新：

claude plugin update ohos-delivery-kit@ohos-delivery-kit-local

卸载

npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent claude --scope user

如需手动执行 Claude Code 原生命令，使用完整坐标：

claude plugin uninstall ohos-delivery-kit@ohos-delivery-kit-local

Claude 行为说明：

• 生成 Claude Code 原生 plugin projection。
• 注册 Claude marketplace。
• Claude Code 插件启用、更新、卸载遵循 Claude 自身生命周期机制。
• 本地 marketplace 插件使用完整坐标 <plugin>@<marketplace>，例如 ohos-delivery-kit@ohos-delivery-kit-local。

OpenCode

安装

npx oh-skillhub@latest plugin install ohos-delivery-kit --agent opencode --scope user

更新

npx oh-skillhub@latest plugin update ohos-delivery-kit --agent opencode --scope user

Dry-run：

npx oh-skillhub@latest plugin update ohos-delivery-kit --agent opencode --scope user --dry-run

卸载

npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent opencode --scope user

Dry-run：

npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent opencode --scope user --dry-run

OpenCode 行为说明：

• 生成 OpenCode plugin projection。
• 将生成的 plugin path 写入 OpenCode config 的 plugin 数组。
• 卸载时删除 OpenCode projection，并从 OpenCode config 中移除对应 plugin path。

Project scope

如果只希望当前项目可用，使用 --scope project：

npx oh-skillhub@latest plugin install ohos-delivery-kit --agent codex --scope project
npx oh-skillhub@latest plugin update ohos-delivery-kit --agent codex --scope project
npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent codex --scope project

三端同理：

npx oh-skillhub@latest plugin install ohos-delivery-kit --agent all --scope project
npx oh-skillhub@latest plugin update ohos-delivery-kit --agent all --scope project
npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent all --scope project

状态与诊断

查看插件安装状态：

npx oh-skillhub@latest plugin status ohos-delivery-kit --scope user

查看详细状态：

npx oh-skillhub@latest plugin status ohos-delivery-kit --scope user --verbose

执行诊断：

npx oh-skillhub@latest plugin doctor ohos-delivery-kit --scope user

诊断会检查：

• scope registry 是否存在并可读。
• canonical store digest 与 projection 记录是否一致。
• 各 agent projection 是否存在。
• 宿主 marketplace/config 是否已经注册。
• 是否存在独立安装的同名 skill，避免 plugin projection 与散装 skill 冲突。

常见组合

安装两个插件到所有 Agent：

npx oh-skillhub@latest plugin install ohos-delivery-kit --agent all --scope user

更新两个插件到所有 Agent：

npx oh-skillhub@latest plugin update ohos-delivery-kit --agent all --scope user

卸载两个插件到所有 Agent：

npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent all --scope user

安全策略

• oh-skillhub 只管理自身生成的 canonical store、projection 和 registry 记录。
• 卸载指定 agent 时，只删除该 agent 的 projection 和宿主注册信息。
• 同一 plugin 安装到多个 agent 时，卸载其中一个 agent 不影响其他 agent。
• canonical store 暂时保留，用于支持多 agent 引用和后续诊断。
• 建议先用 --dry-run 查看计划，再执行实际安装、更新或卸载。

Agent 中如何使用

安装完成并重启 Agent 后，可以直接通过自然语言触发。

ODK 示例：

我要用 ODK 初始化一个 OpenHarmony 交付件。
请用 ODK 为当前改动生成 proposal、spec、design 和 execution-plan。
请用 ODK 校验当前 .codespec 交付件是否满足要求。

README 同步项

README 的 Workflow plugin 使用章节应同步到以上命令：

• plugin install <plugin>
• plugin update <plugin>
• plugin uninstall <plugin>
• plugin status <plugin>
• plugin doctor <plugin>