Skip to content

有好几处 superpowers: 没替换成 superpowers-zh: 导致 claude code 调用技能失败 #124

Description

@1027663760
Image

[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.mdCLAUDE.mdRELEASE-NOTES.md
RELEASE-NOTES.zh.mdtests/subagent-driven-dev/*/plan.md

建议修复

  1. 全局替换 superpowers:superpowers-zh:(skills/ 目录及上述文档);
  2. copilot-tools.md 中的 code-reviewer 单独改为 chinese-code-review
  3. 建议在 CI 中加一个 grep 校验,防止未来新增/翻译的技能再次引入上游前缀。

复现步骤

  1. 安装 superpowers-zh 1.7.10 并启用;
  2. 新开 Claude Code 会话(或执行 /clear 触发 SessionStart hook);
  3. 按注入的 using-superpowers 指示调用任意 superpowers:xxx 技能;
  4. 观察 "Unknown skill" 错误;改用 superpowers-zh:xxx 则成功。

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions