Skip to content

docs(readme): 手动安装段加 low-fidelity 警示 - #24

Merged
jnMetaCode merged 1 commit into
mainfrom
docs/clarify-manual-install-fidelity
May 10, 2026
Merged

docs(readme): 手动安装段加 low-fidelity 警示#24
jnMetaCode merged 1 commit into
mainfrom
docs/clarify-manual-install-fidelity

Conversation

@jnMetaCode

Copy link
Copy Markdown
Owner

Summary

回应群友疑问:「superpowers-zh 是不是只有 skills、没 hooks/commands/agents 不完整?」

真正的根因

不是 plugin 缺失:v1.3.0 起 superpowers-zh 包含 skills/ + hooks/ + 4 套 plugin manifest(Claude Code / Cursor / Codex / Marketplace),是完整 plugin。commands/agents/ 是上游 v5.1.0 主动删的(deprecated stubs + agent 已 lift 进 skill),能力没缩水。

是 README 误导:「方式二:手动安装」段只展示 cp -r skills,没说还要复制 hooks/ 和生成 bootstrap 引导文件。用户照着做,skills 物理存在但不会自动触发——这才是群友直觉里"丢失价值"的真正来源。

改动

README.md 第 149 行附近:

  • 标题改为「方式二:手动安装(low-fidelity,仅作备选)」
  • 顶部加 ⚠️ 提示框:
    • 说明 plugin 完整组成(skills + hooks + bootstrap + 4 套 manifest)
    • 说明 cp -r skills 实际丢什么(hooks 不配置、bootstrap 不生成、skills 不自动触发)
    • 强烈推荐回方式一 npx superpowers-zh
    • 把手动 cp 定位为「npx 不可用的极端无网络环境」备选

Test plan

  • markdown 格式 OK(无 syntax error,✨提示框格式正常)
  • 不影响功能代码、CI 不需要重新 verify
  • CI 跑过(pure docs change,应秒过)

不在本 PR 内

  • 不展开手动 hooks 复制步骤(每个工具 hook 路径不同,写完会让 README 翻倍;用户走 npx 即可)
  • 不改主 README 上方的"对比表"和"工具支持表"(那两个表已经隐含推荐 npx)

群友反馈:「superpowers-zh 是不是只有 skills,没 hooks/commands/agents 不完整?」

实际原因不是 plugin 缺失(v1.3.0 起 skills + hooks + 4 套 manifest 齐全;
commands/ agents/ 是上游 v5.1.0 主动删的 deprecated 内容,能力已收敛进 skills),
而是本仓库 README "方式二:手动安装" 段只展示 cp -r skills,没说还要复制
hooks/ 和生成 bootstrap,导致用户自己 cp 后 skills 不会自动触发。

改动:
- 标题改为「方式二:手动安装(low-fidelity,仅作备选)」
- 顶部加 ⚠️ 提示框,列清 plugin 完整组成(skills + hooks + bootstrap + manifest)
  与手动 cp 实际丢失的内容(hooks 不配置、bootstrap 不生成、skills 不自动触发)
- 强烈推荐回方式一 npx superpowers-zh,把手动 cp 限定在「npx 不可用的极端
  无网络环境」备选位
@jnMetaCode
jnMetaCode merged commit 31fb8e3 into main May 10, 2026
1 check passed
@jnMetaCode
jnMetaCode deleted the docs/clarify-manual-install-fidelity branch May 10, 2026 15:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant