marketplace-dev 是一个面向 Claude Code 插件市场的开发与维护技能,目标是把一个包含 skills/ 目录(其中每个技能目录含 SKILL.md 文件)的技能仓库,转换为官方插件市场,使用户能够通过 claude plugin marketplace add 安装技能并获取自动更新。其输入是带有 SKILL.md 的技能仓库,输出是经过验证、安装测试并可直接提交 PR 的 .claude-plugin/marketplace.json。
用途与任务路由 该技能首先根据用户意图选择处理路径:为尚无市场支持的仓库创建市场支持时,执行 Phase 0–4;添加或更新普通插件条目时,参考“维护已有市场”并执行 Phase 3;将独立技能整合为套件、从已有技能创建套件、在套件间移动技能或重命名并移动技能时,需完整阅读并遵循 references/suite_consolidation_workflow.md;合并套件迁移后对已安装缓存进行对账时,调用 daymade-skill:skill-governance 的迁移后工作流;对整个仓库进行代码、文档、安全、PR、issue 和清单完整性审计时,仅在用户明确要求广泛健康检查时调用 marketplace-health-check。
主要能力 技能覆盖市场构建的完整生命周期:Phase 0 收集证据,包括读取现有 marketplace.json、仓库规则、官方文档,并在用户明确批准时挖掘本地 Claude Code 会话记录;Phase 1 分析目标仓库,发现所有 SKILL.md、提取 frontmatter 中的 name 和 description、读取 VERSION、README、LICENSE 和 git remote,确定分类并选择插件边界(单技能插件或套件插件);Phase 2 生成 marketplace.json,遵循官方 schema,注意 $schema 会被拒绝、metadata 仅含 description/version/pluginRoot、strict:false 的使用条件、source 指向技能目录等规则;Phase 3 验证,运行捆绑的 check_marketplace.sh 执行四项检查,并进行安装测试、缓存足迹测试和 GitHub 安装测试;Phase 4 涉及维护已有市场时的版本递增、描述更新、CHANGELOG 条目等。
使用方式 使用该技能时,用户提供技能仓库路径,技能会按阶段执行。验证阶段可运行 bash scripts/check_marketplace.sh 或指定目标仓库路径。安装测试使用 claude plugin marketplace add .、claude plugin install <plugin-name>@<marketplace-name>、claude plugin list、claude plugin update、claude plugin uninstall 和 claude plugin marketplace remove 等命令。缓存足迹测试通过 jq 读取 ~/.claude/plugins/installed_plugins.json 获取 installPath,再用 find 检查缓存内容。GitHub 安装测试使用 claude plugin marketplace add <github-user>/<repo>。
适用场景 适用于需要将 Claude Code 技能仓库发布为可安装插件市场的开发者,以及需要维护已有市场、添加插件条目、整合技能套件、迁移技能或进行市场健康检查的场景。
限制 该技能依赖 Claude Code CLI 和 claude plugin 命令;部分检查脚本有特定的退出码语义(如 check_version_progression.py 的 exit 2 表示用法错误,validate_changed_skills.sh 的 exit 1 表示用法错误);CHANGELOG 条目没有自动检查器,需要手动确认;某些操作(如缓存对账)需调用其他技能;挖掘本地会话记录需用户明确批准。