[Bug] 官方 github 插件 0.1.2 的 plugin.json 未声明 skills 组件,安装启用后技能不生效
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 22
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
问题类别 · Category
其他 / 插件打包 · Other / Plugin packaging
涉及的 Agent 框架 · Agent framework
ZCode Agent(自研)
严重程度 · Severity
阻塞使用 · Blocking(该插件的核心功能 = 技能,全部不可用)
复现频率 · Reproducibility
必现 · Always
问题描述 · Description
zcode-plugins-official marketplace 中的 github 插件 v0.1.2,其 .zcode-plugin/plugin.json 与 .claude-plugin/plugin.json 均未声明任何组件字段(无 skills / commands / hooks)。插件安装并启用后不提供任何技能,尽管插件包内 skills/ 目录下 10 个技能(commit / pr / issue / repo / release / codespace / workflow-run / secret / gist / setup)文件齐全且格式标准。
对照同插件体系中可正常工作的官方插件(skill-creator、zcode-guide、browser-use 等),其 manifest 均声明 "skills": "skills"。
复现步骤 · Steps to reproduce
- 打开 ZCode 3.11.2 → Settings → Plugin Management → Discover → 安装
github插件(v0.1.2) - 确认 Installed 页显示已启用(config.json 中
enabledPlugins: {"github@zcode-plugins-official": true}) - 新开会话,查看可用技能/命令
- 结果:没有任何 github 相关技能(预期
/github:setup、github:pr等均不存在)
期望表现 · Expected behavior
安装并启用后,会话中应出现插件提供的 10 个技能(如 github:pr、github:issue、github:setup)。
实际表现 · Actual behavior
插件安装、启用均成功,但技能完全不出现。已排除本地损坏:manifest 内容与市场分发 zip 内一致(sha256: 7320f15886d83625ed8eec944a7a2ab09fe99d64a42131ccec427eeecfd769b6),且将 "skills": "skills" 手工补入 .zcode-plugin/plugin.json 后技能即可被新会话发现——证明仅是 manifest 缺字段。
ZCode 版本 · ZCode version
3.11.2 (build 3.11.2.6792),ZCode Protocol agent 0.16.5
设备 / 系统 · Device / OS
macOS 14.6 (Intel x64),ZCode 桌面版;gh CLI 2.100.0
截图 / 日志 · Screenshots / Logs
无截图。相关文件路径(插件缓存):
~/.zcode/cli/plugins/cache/zcode-plugins-official/github/0.1.2/.zcode-plugin/plugin.json(仅 name/version/description/author/keywords,无组件字段)~/.zcode/cli/plugins/cache/zcode-plugins-official/github/0.1.2/skills/<10 个技能>/SKILL.md(文件齐全)
修复建议
发布流水线在生成 .zcode-plugin/plugin.json 时应补上组件声明("skills": "skills";如含 commands/hooks 一并声明),或客户端对插件根目录 skills/ 采用约定式发现作为兜底。
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the cached github v0.1.2 manifests at .zcode-plugin/plugin.json and .claude-plugin/plugin.json, then inspect the marketplace package or release pipeline that produced them. Confirm the manifest declares the skills directory and install the packaged plugin in ZCode 3.11.2; done means the ten bundled skills, including github:pr and github:setup, appear in a new session.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github
- Domain
- tooling
- Issue type
- Bug
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 72/100