zai-org / zai-org/feedback

[Bug] 官方 github 插件 0.1.2 的 plugin.json 未声明 skills 组件,安装启用后技能不生效

Open Beginner friendly
#550 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2
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

  1. 打开 ZCode 3.11.2 → Settings → Plugin Management → Discover → 安装 github 插件(v0.1.2)
  2. 确认 Installed 页显示已启用(config.json 中 enabledPlugins: {"github@zcode-plugins-official": true}
  3. 新开会话,查看可用技能/命令
  4. 结果:没有任何 github 相关技能(预期 /github:setupgithub:pr 等均不存在)

期望表现 · Expected behavior

安装并启用后,会话中应出现插件提供的 10 个技能(如 github:prgithub:issuegithub: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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.