插件市场 — OHOS SDD

这个仓库是什么？

ohos-marketplace 是一个插件市场发布仓（Release / Marketplace Repository），类似于 npm 的 registry 角色。它本身不做插件开发，而是将两个独立开发仓库的构建产物统一聚合、提交版本控制，供 AI 编码工具一键安装。

核心定位：metadata registry + committed built plugins。开发在各插件自己的仓库进行，dist/ 被 gitignore，构建产物复制到这里提交，使 marketplace 的 source 能解析到完整插件。参考 obra/superpowers-marketplace。

两个插件

📦 ohos-delivery-kit (ODK)

v0.6.6

OpenHarmony 交付产物规范层 — 定义必须沉淀的最小契约。提供 structured spec、design、review、validation 全链路交付模板与校验工具。

→ oshunter/ohos-delivery-kit

📦 ohos-sdd

v0.4.0

OpenHarmony 规格驱动开发工作流 — 在编码前通过 .codespec 对齐需求/设计/任务。包含 intake → spec → design → execution-plan → code 全流程 skill。

→ oshunter/ohos-sdd

维度	ohos-delivery-kit (ODK)	ohos-sdd
定位	交付规范层 — 定义"产出什么"	开发工作流 — 定义"怎么做"
核心能力	spec / design / review 模板 + 自动化校验	4 阶段交付件依赖图（Define → Specify → Design → Plan）+ validate A-E 校验
Skills 数量	24 个	10 个
发布分支	两者均从各自 dev 分支发布（main 落后）

架构设计

两个开发仓库各自构建 → marketplace 统一聚合分发 → 三平台用户安装

📝 源仓

ohos-delivery-kit

交付规范层

v0.6.6

24 skills

ohos-sdd

SDD 工作流

v0.4.0

10 skills

publish-plugins.sh

🏪 marketplace

plugins/<name>/

single-tree 架构

.claude-plugin/

.codex-plugin/

.opencode/

共享内容只存一份

npx oh-skillhub

👥 用户平台

Claude Code

npx oh-skillhub plugin install

Codex CLI

npx oh-skillhub plugin install

OpenCode

npx oh-skillhub plugin install

🏆 single-tree 架构（v0.1.3）：之前每个插件有三份拷贝（plugins/ + codex-plugins/ + opencode-plugins/），文件数 396。重构后合并为 plugins/<name>/ 单棵树，三端 manifest 共存，共享内容只存一份，文件数降至 229（-42%）。

安装指南

通过 oh-skillhub 一键安装，支持 Claude Code、Codex CLI、OpenCode 三大平台

Bash

# 🚀 一键安装到三端（推荐）
npx oh-skillhub@latest plugin install ohos-delivery-kit --agent all --scope user
npx oh-skillhub@latest plugin install ohos-sdd --agent all --scope user

# 预览计划（不写入文件）
npx oh-skillhub@latest plugin install ohos-delivery-kit --agent all --scope user --dry-run

中立源 + 宿主投影：oh-skillhub 从远端 openharmony-skills#release 获取中立源 workflow plugin，自动为 Codex、Claude Code、OpenCode 生成对应宿主载荷。

Bash

# 安装
npx oh-skillhub@latest plugin install ohos-delivery-kit --agent claude --scope user
npx oh-skillhub@latest plugin install ohos-sdd --agent claude --scope user

# 安装后启用插件（Claude 原生命令）
claude plugin install ohos-delivery-kit@ohos-delivery-kit-local
claude plugin install ohos-sdd@ohos-sdd-local

# 更新
npx oh-skillhub@latest plugin update ohos-delivery-kit --agent claude --scope user
npx oh-skillhub@latest plugin update ohos-sdd --agent claude --scope user

# 卸载
npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent claude --scope user
npx oh-skillhub@latest plugin uninstall ohos-sdd --agent claude --scope user

Claude 行为：生成 Claude Code 原生 plugin projection → 注册 Claude marketplace → 通过 claude plugin install <plugin>@<marketplace>-local 启用。插件记录在 enabledPlugins 中，每次 session 自动加载。

Bash

# 安装
npx oh-skillhub@latest plugin install ohos-delivery-kit --agent codex --scope user
npx oh-skillhub@latest plugin install ohos-sdd --agent codex --scope user

# 更新
npx oh-skillhub@latest plugin update ohos-delivery-kit --agent codex --scope user
npx oh-skillhub@latest plugin update ohos-sdd --agent codex --scope user

# 卸载
npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent codex --scope user
npx oh-skillhub@latest plugin uninstall ohos-sdd --agent codex --scope user

Codex 行为：生成 Codex 原生 plugin projection → 注册 Codex marketplace → 更新 CODEX_HOME/config.toml 中 plugin enable 配置。卸载时自动清理。

Bash

# 安装
npx oh-skillhub@latest plugin install ohos-delivery-kit --agent opencode --scope user
npx oh-skillhub@latest plugin install ohos-sdd --agent opencode --scope user

# 更新
npx oh-skillhub@latest plugin update ohos-delivery-kit --agent opencode --scope user
npx oh-skillhub@latest plugin update ohos-sdd --agent opencode --scope user

# 卸载
npx oh-skillhub@latest plugin uninstall ohos-delivery-kit --agent opencode --scope user
npx oh-skillhub@latest plugin uninstall ohos-sdd --agent opencode --scope user

OpenCode 行为：生成 OpenCode plugin projection → 写入 OpenCode config 的 plugin 数组 → 自动加载。卸载时删除 projection 并从 config 移除。

状态与诊断

Bash

# 查看插件安装状态
npx oh-skillhub@latest plugin status ohos-delivery-kit --scope user
npx oh-skillhub@latest plugin status ohos-sdd --scope user

# 详细状态
npx oh-skillhub@latest plugin status ohos-delivery-kit --scope user --verbose

# 执行诊断（检查 registry、digest、projection、marketplace 注册等）
npx oh-skillhub@latest plugin doctor ohos-delivery-kit --scope user
npx oh-skillhub@latest plugin doctor ohos-sdd --scope user

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

npx oh-skillhub@latest plugin install ohos-sdd --agent all --scope project

💡 安装后重启 Agent — 安装、更新、卸载后建议重启对应 Agent 或打开新会话，确保插件正确加载。

仓库结构

ohos-marketplace/ ├── .claude-plugin/marketplace.json # Claude marketplace 元数据 ├── .agents/plugins/marketplace.json # Codex marketplace 元数据 ├── plugins/<name>/ # 单树：三端 manifest 共存 │ ├── .claude-plugin/ # Claude plugin.json + hooks │ ├── .codex-plugin/ # Codex plugin manifest │ ├── .opencode/ # OpenCode JS 插件入口 │ └── skills/ templates/ ... # 共享内容（只存一份） ├── scripts/ │ ├── publish-plugins.sh # 维护者：重建 + 拷贝 + 版本检查 │ ├── install-opencode-odk.sh # [已废弃] 旧 ODK 安装脚本 │ └── install-opencode-ohos-sdd.sh # [已废弃] 旧 ohos-sdd 安装脚本 ├── docs/ logs/ CHANGELOG.md README.md

发布流程（维护者）

在各开发仓库 bump 版本 — 修改 plugin.json 中的 version，重新构建 dist。

在本仓库刷新构建产物

Bash

scripts/publish-plugins.sh                          # 拷贝已有 dist
scripts/publish-plugins.sh --rebuild                # 先重建
scripts/publish-plugins.sh --rebuild --branch dev     # 指定分支
scripts/publish-plugins.sh --rebuild --plugin ohos-sdd  # 单插件

脚本是幂等的，会自动检查跨平台版本一致性。

Review diff → commit → push → tag
用户更新 — npx oh-skillhub@latest plugin update <plugin> --agent all --scope user

版本演进

版本	关键变更	影响
v0.1.3	single-tree 架构合并三份目录拷贝；publish-plugins.sh 重写；hooks.json 合并	396→229 文件（-42%）
ohos-sdd 0.4.0	仓迁移 spec-for-ai → ohos-sdd；结构精简约 66%；plugin.yaml + CHANGELOG + hooks 新增	~300 → ~102 文件
ohos-sdd 0.3.0	新增 spec-for-validation 引擎 + 模板 + artifact	SDD 补齐验证规格能力
skill 对齐	34 个 skills 添加 `license: MIT`，对齐 Anthropic skill 格式	标准 name + description + license

常见问题

Q: ODK 和 ohos-sdd 是什么关系？

互补关系。ODK 定义"产出什么"（模板和校验规则），ohos-sdd 定义"怎么做"（完整工作流编排）。协同使用效果最佳。

Q: 为什么 main 分支的版本比 dev 旧？

两个源仓的 main 都落后于 dev。publish-plugins.sh 默认从 dev 分支拉取构建。main 作为稳定基线。

Q: 三端安装的插件内容一样吗？

核心内容完全一致，差异仅在 manifest 格式和加载机制。oh-skillhub 使用"中立源 + 宿主投影"的方式，为各平台生成各自原生 plugin payload，共享同一份 canonical store。

Q: 如何查看插件状态和排查问题？

使用 oh-skillhub 内置的诊断工具：

npx oh-skillhub@latest plugin status <plugin> --scope user --verbose
npx oh-skillhub@latest plugin doctor <plugin> --scope user

诊断会检查：scope registry、canonical store digest 一致性、各 agent projection 存在性、宿主 marketplace/config 注册、散装 skill 冲突。

Q: 如何添加新插件到 marketplace？

运行 publish-plugins.sh --plugin <name> --rebuild
在两个 marketplace.json 中添加条目
在 README.md PLUGINS 表格添加一行