[Issue] 技能引用前缀错误:SKILL.md 中仍使用上游 superpowers: 前缀,插件实际名为 superpowers-zh
环境
- 插件:superpowers-zh v1.7.10(经 Claude Code 插件市场安装,市场源
jnMetaCode/superpowers-zh)
- 宿主:Claude Code(Windows)
现象
SessionStart hook 注入 using-superpowers 技能全文后,按其中指示调用
Skill("superpowers:systematic-debugging"),宿主返回 "Unknown skill: superpowers:systematic-debugging"。
而调用 Skill("superpowers-zh:systematic-debugging") 正常加载。
根因
Claude Code 按 <插件名>:<技能名> 注册插件技能。本插件在
.claude-plugin/plugin.json 中 "name": "superpowers-zh"(上游 obra/superpowers
的插件名为 superpowers),但 skills/ 内各 SKILL.md 的技能引用仍写的是上游前缀
superpowers:,导致这些引用全部无法解析。
影响范围(v1.7.10)
共 11 个文件、约 30 处错误前缀(grep superpowers:[a-z-] 统计):
| 文件 |
引用 |
| using-superpowers/SKILL.md |
brainstorming / systematic-debugging / chinese-code-review / chinese-git-workflow / chinese-documentation / chinese-commit-conventions / mcp-builder |
| using-superpowers/references/copilot-tools.md |
code-reviewer(该技能在 zh 版中不存在) |
| using-superpowers/references/gemini-tools.md |
subagent-driven-development / requesting-code-review |
| using-superpowers/references/qoder-tools.md |
requesting-code-review |
| systematic-debugging/SKILL.md |
test-driven-development / verification-before-completion |
| executing-plans/SKILL.md |
subagent-driven-development / using-git-worktrees / finishing-a-development-branch |
| subagent-driven-development/SKILL.md |
finishing-a-development-branch / using-git-worktrees / requesting-code-review |
| test-driven-development/writing-good-tests.md |
writing-skills |
| writing-plans/SKILL.md |
subagent-driven-development / executing-plans |
| writing-skills/SKILL.md |
test-driven-development / systematic-debugging |
| writing-skills/testing-skills-with-subagents.md |
test-driven-development |
其中 superpowers:code-reviewer 尤为特殊:上游的 code-reviewer 技能在 zh 版已被
chinese-code-review 替代,目录中没有 code-reviewer 技能,改前缀也无法解析,
应改为 superpowers-zh:chinese-code-review。
另有非功能性文档残留同样问题(不影响技能解析,建议一并修):
.github/PULL_REQUEST_TEMPLATE.md、CLAUDE.md、RELEASE-NOTES.md、
RELEASE-NOTES.zh.md、tests/subagent-driven-dev/*/plan.md。
建议修复
- 全局替换
superpowers: → superpowers-zh:(skills/ 目录及上述文档);
copilot-tools.md 中的 code-reviewer 单独改为 chinese-code-review;
- 建议在 CI 中加一个 grep 校验,防止未来新增/翻译的技能再次引入上游前缀。
复现步骤
- 安装 superpowers-zh 1.7.10 并启用;
- 新开 Claude Code 会话(或执行 /clear 触发 SessionStart hook);
- 按注入的 using-superpowers 指示调用任意
superpowers:xxx 技能;
- 观察 "Unknown skill" 错误;改用
superpowers-zh:xxx 则成功。
[Issue] 技能引用前缀错误:SKILL.md 中仍使用上游
superpowers:前缀,插件实际名为superpowers-zh环境
jnMetaCode/superpowers-zh)现象
SessionStart hook 注入
using-superpowers技能全文后,按其中指示调用Skill("superpowers:systematic-debugging"),宿主返回 "Unknown skill: superpowers:systematic-debugging"。而调用
Skill("superpowers-zh:systematic-debugging")正常加载。根因
Claude Code 按
<插件名>:<技能名>注册插件技能。本插件在.claude-plugin/plugin.json中"name": "superpowers-zh"(上游 obra/superpowers的插件名为
superpowers),但skills/内各 SKILL.md 的技能引用仍写的是上游前缀superpowers:,导致这些引用全部无法解析。影响范围(v1.7.10)
共 11 个文件、约 30 处错误前缀(grep
superpowers:[a-z-]统计):其中
superpowers:code-reviewer尤为特殊:上游的 code-reviewer 技能在 zh 版已被chinese-code-review替代,目录中没有 code-reviewer 技能,改前缀也无法解析,应改为
superpowers-zh:chinese-code-review。另有非功能性文档残留同样问题(不影响技能解析,建议一并修):
.github/PULL_REQUEST_TEMPLATE.md、CLAUDE.md、RELEASE-NOTES.md、RELEASE-NOTES.zh.md、tests/subagent-driven-dev/*/plan.md。建议修复
superpowers:→superpowers-zh:(skills/ 目录及上述文档);copilot-tools.md中的code-reviewer单独改为chinese-code-review;复现步骤
superpowers:xxx技能;superpowers-zh:xxx则成功。