superpowers-zh 1.7.12 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/.claude-plugin/plugin.json +2 -2
  3. package/.codex-plugin/plugin.json +1 -1
  4. package/.cursor-plugin/plugin.json +2 -2
  5. package/.opencode/INSTALL.md +82 -14
  6. package/.opencode/plugins/superpowers.js +319 -31
  7. package/GEMINI.md +3 -2
  8. package/README.md +68 -36
  9. package/README.zh-Hant.md +66 -37
  10. package/RELEASE-NOTES.zh.md +154 -0
  11. package/assets/sponsors/88api.jpg +0 -0
  12. package/assets/sponsors/apinebula.png +0 -0
  13. package/assets/sponsors/logo-infistar-icon.png +0 -0
  14. package/assets/sponsors/logo-sidrune-ai.png +0 -0
  15. package/assets/sponsors/logo-volcengine-icon.png +0 -0
  16. package/assets/sponsors/volcengine.png +0 -0
  17. package/bin/superpowers-zh.js +21 -2
  18. package/docs/README.aider.md +2 -2
  19. package/docs/README.claw.md +1 -1
  20. package/docs/README.cline.md +3 -3
  21. package/docs/README.codearts.md +1 -1
  22. package/docs/README.codebuddy.md +1 -1
  23. package/docs/README.codex.md +26 -0
  24. package/docs/README.crush.md +1 -1
  25. package/docs/README.deepseek-harness.md +1 -1
  26. package/docs/README.deerflow.md +1 -1
  27. package/docs/README.hermes.md +1 -1
  28. package/docs/README.kilocode.md +3 -3
  29. package/docs/README.kiro.md +1 -1
  30. package/docs/README.opencode.md +128 -19
  31. package/docs/README.qoder.md +1 -1
  32. package/docs/README.qwen.md +1 -1
  33. package/docs/README.trae-cn.md +62 -0
  34. package/docs/README.vscode.md +1 -1
  35. package/docs/README.zcode.md +2 -2
  36. package/gemini-extension.json +1 -1
  37. package/hooks/run-hook.cmd +34 -18
  38. package/hooks/session-start +45 -9
  39. package/index.js +9 -0
  40. package/package.json +4 -3
  41. package/skills/brainstorming/SKILL.md +111 -181
  42. package/skills/brainstorming/builder-check-prompt.md +15 -0
  43. package/skills/brainstorming/scripts/server.cjs +1 -1
  44. package/skills/brainstorming/visual-companion.md +36 -33
  45. package/skills/chinese-code-review/SKILL.md +1 -1
  46. package/skills/chinese-commit-conventions/SKILL.md +1 -1
  47. package/skills/diagnosing-superpowers/SKILL.md +102 -0
  48. package/skills/diagnosing-superpowers/prompts/analyst-common.md +32 -0
  49. package/skills/diagnosing-superpowers/prompts/cost-and-time.md +20 -0
  50. package/skills/diagnosing-superpowers/prompts/plan-adherence.md +21 -0
  51. package/skills/diagnosing-superpowers/prompts/quality-evidence.md +20 -0
  52. package/skills/diagnosing-superpowers/prompts/repeated-work.md +24 -0
  53. package/skills/diagnosing-superpowers/prompts/request-conflicts.md +14 -0
  54. package/skills/diagnosing-superpowers/prompts/scrub-audit.md +26 -0
  55. package/skills/diagnosing-superpowers/prompts/scrub.md +22 -0
  56. package/skills/diagnosing-superpowers/prompts/similar-session.md +34 -0
  57. package/skills/diagnosing-superpowers/prompts/skill-timeline.md +23 -0
  58. package/skills/diagnosing-superpowers/prompts/stumbles.md +20 -0
  59. package/skills/diagnosing-superpowers/references/context-safety.md +20 -0
  60. package/skills/diagnosing-superpowers/references/github-issues.md +46 -0
  61. package/skills/diagnosing-superpowers/references/redaction-policy.md +29 -0
  62. package/skills/diagnosing-superpowers/references/session-discovery.md +23 -0
  63. package/skills/diagnosing-superpowers/templates/bundle-README.md +65 -0
  64. package/skills/diagnosing-superpowers/templates/case.md +61 -0
  65. package/skills/diagnosing-superpowers/templates/issue.md +48 -0
  66. package/skills/diagnosing-superpowers/templates/report.md +78 -0
  67. package/skills/executing-plans/SKILL.md +176 -125
  68. package/skills/executing-plans/scripts/task-done +52 -0
  69. package/skills/executing-plans/scripts/task-start +28 -0
  70. package/skills/mcp-builder/SKILL.md +1 -1
  71. package/skills/requesting-code-review/SKILL.md +2 -2
  72. package/skills/requesting-code-review/code-reviewer.md +8 -0
  73. package/skills/subagent-driven-development/SKILL.md +17 -17
  74. package/skills/subagent-driven-development/re-review-prompt.md +1 -1
  75. package/skills/subagent-driven-development/scripts/review-package +8 -1
  76. package/skills/subagent-driven-development/scripts/sdd-workspace +51 -4
  77. package/skills/subagent-driven-development/scripts/task-brief +3 -1
  78. package/skills/subagent-driven-development/task-reviewer-prompt.md +2 -2
  79. package/skills/systematic-debugging/CREATION-LOG.md +1 -1
  80. package/skills/systematic-debugging/SKILL.md +2 -2
  81. package/skills/systematic-debugging/root-cause-tracing.md +1 -1
  82. package/skills/test-driven-development/SKILL.md +2 -0
  83. package/skills/using-superpowers/SKILL.md +19 -14
  84. package/skills/using-superpowers/references/claude-code-tools.md +11 -0
  85. package/skills/using-superpowers/references/muse-tools.md +35 -0
  86. package/skills/writing-plans/SKILL.md +34 -27
  87. package/skills/writing-skills/SKILL.md +5 -3
  88. package/assets/sponsors/apimart.jpg +0 -0
  89. package/assets/sponsors/compshare.jpg +0 -0
  90. package/assets/sponsors/logo-apimart-icon.png +0 -0
  91. package/assets/sponsors/logo-compshare-icon.png +0 -0
  92. package/skills/brainstorming/spec-document-reviewer-prompt.md +0 -48
  93. package/skills/writing-plans/plan-document-reviewer-prompt.md +0 -49
@@ -6,6 +6,160 @@
6
6
 
7
7
  ---
8
8
 
9
+ ## v1.8.0 (2026-10-19)
10
+
11
+ **同步上游 v7.0.0,所有用户建议更新。** brainstorming 按上游从头重写,另有一批 hook、脚本和示例修复。
12
+
13
+ ### 🔁 brainstorming 重写:先弄清你想要什么
14
+
15
+ - 先判断"我到底知道多少":要紧的信息都在请求里("把图标改成矢车菊蓝"),就直接做;缺了东西才开始对话
16
+ - 第一条消息只有两件事:告诉你可以跳过提问让它直接开始,以及一个让你开始描述的开放问题
17
+ - 每条消息只问一个问题,先让你描述,只在你卡住时才给选项;你说"你猜一个吧""你觉得呢",它就直接提方案
18
+ - 理解一部分就复述一部分(约 200-300 字),标明哪些是它的猜测,请你纠正
19
+ - 意图清楚后再定规模:快速明确的任务 / 小改动(对话里定)/ 需要书面设计的项目,你可以推翻
20
+ - 书面设计交给你之前,先由一个扮演该领域建造者的子代理检查(builder check),只把必须由你回答的问题一次性带回来;取代原来的 spec 审查(`spec-document-reviewer-prompt.md` 已删除,新增 `builder-check-prompt.md`)
21
+ - 不再限于软件:一场分享、一门生意、一次装修也适用
22
+ - 硬门槛保留:完整描述获批之前不构建;唯一例外是你同意的一次性 spike,要保留它的代码算新需求
23
+
24
+ **本 fork 的补充(上游没有):** 中文里"你看着办""你定吧"是请它拿主意,不是让它跳过提问直接动手。eval 中未加这句说明时,智能体两次把"反正你看着办吧"当成跳过流程、未经批准就开始写代码;补充后复测未再出现。
25
+
26
+ **eval 摘要:** 8 个场景(含非软件、施压、spike、"你看着办"),对比旧中文版、新中文版和上游英文原文,被测模型 claude-opus-5-5。新中文版与英文原文表现一致,都明显优于旧版:旧版普遍先给 A–E 选项菜单、一条消息问多个问题;新版一次一个开放问题并分块复述。受账号额度限制,每组样本为 1–2 次。
27
+
28
+ ### 🐛 修复
29
+
30
+ - **SessionStart hook**:Claude Code 以空 PATH 启动 hook 时,不再因找不到 `dirname`/`cat` 而丢失 bootstrap;Windows 上不再误选 WSL 启动器或执行当前目录下的同名程序,hook 退出码不再丢失(同步上游 v7)
31
+ - **executing-plans**:测试成功但没有输出时,`task-done` 也会记账(此前返回 1 且不记账)
32
+ - **subagent-driven-development**:`sdd-workspace` 不再覆盖你自己的 `.superpowers/sdd/.gitignore`;Windows Git Bash 下计划标记改为仓库相对路径
33
+ - **视觉伴侣**:内容里的 `$&`、`$'` 等不再被当作替换模式篡改
34
+ - **带参数调用 skill**:Claude Code 会把正文里的 `$1` 等替换成参数。requesting-code-review 的 BASE_SHA 示例(同步上游),以及本 fork 的 chinese-code-review(参数化查询示例)、chinese-commit-conventions(husky 命令)都已改写;CI 新增检查防止再出现
35
+ - **systematic-debugging**:诊断示例只报告变量是否设置,不再把凭据值打印到日志
36
+ - **OpenCode 文档**:「固定到特定版本」示例此前写 `#v1.7.13`,这个 tag 不存在,照抄会安装失败;已改为 `#v1.7.14`,audit 会检查文档引用的 tag 是否存在
37
+ - **发版脚本**:`npm version` 同步了 `.kimi-plugin/plugin.json` 的版本号,但没把它加入提交
38
+
39
+ ### 🌐 官网
40
+
41
+ - 繁体界面的分类标签与简介修正;skill 数、工具数、中国原创数改为构建时自动生成
42
+ - 404 页的样式此前被 CSP 拦截而错位,已修复,并加上英文与繁体提示
43
+ - 首页发布提示条此前一直显示 v1.7.12 的内容,已更正,并改为发版时必须同步更新(否则构建失败)
44
+ - FAQ 补充:各安装方式(npx 项目级 / 全局 / Claude Code 插件市场)的更新与卸载、装完怎么确认生效、没生效怎么排查
45
+ - skill 详情页:`<HARD-GATE>` 等标签块此前结构错误(结束标签落进段落,后面整页被嵌进去),现在显示为带标签名的提示框,`<Good>`/`<Bad>` 正反例分别标绿、标红
46
+ - 浅色主题:代码块文字此前几乎看不见(对比度 1.33:1),链接、行内代码、标签、页脚文字也偏淡,已全部调到 4.5:1 以上
47
+ - 手机端:此前 320px 宽度下 16 个页面需要横向滑动,现在全部 70 个页面都不会
48
+
49
+ ### 📦 包体积
50
+
51
+ 删除 5 张已无引用的赞助商图片,Sidrune 横幅从 924 KB 压到 19 KB(显示效果不变)。
52
+
53
+ ---
54
+
55
+ ## v1.7.14 (2026-09-26)
56
+
57
+ **同步上游 v6.4.2(含 v6.4.1),OpenCode 用户尤其建议更新。** 对应 [#133](https://github.com/jnMetaCode/superpowers-zh/issues/133)、[#131](https://github.com/jnMetaCode/superpowers-zh/issues/131)。
58
+
59
+ ### ✨ 新 skill:diagnosing-superpowers(第 21 个)
60
+
61
+ 会话跑偏时——重复劳动、无视计划、太慢、太贵、某个技能没触发——让它读磁盘上的会话记录,按 7 个维度并行分析,出一份**每条结论都带 `path:line`** 的报告;需要时整理成 issue、打包脱敏材料。它只报告发生了什么,不替你诊断 skill 本身。
62
+
63
+ 与上游唯一的有意偏离:**issue 目标是本仓 `jnMetaCode/superpowers-zh`**,不是 obra/superpowers——你跑的是译文,问题先在这里分流,确认是上游行为再转报。
64
+
65
+ ### 🔁 executing-plans 重写:内联执行
66
+
67
+ 从「单独会话 + 检查点」改成**在当前会话里自己当实现者**:`task-start` 取简报和 BASE,`task-done` 跑测试、只有通过才记账本,最后派一个最强模型做整分支审查。与 SDD 共用工作区和账本,中途可以换执行方式。遇到计划缺陷**自己裁决并记账**,只有 4 类硬停止。
68
+
69
+ 旧版里本 fork 自加的「常见异常处理」(计划有误就停下问)与此直接冲突,已删除。
70
+
71
+ ### ✂️ writing-plans:更短的计划
72
+
73
+ - 步骤只写实现者**无法自己决定**的东西:签名、文件、规格取值、测试断言;函数体由实现者写
74
+ - 新增「审查重点」:规格隐含、但没有测试覆盖的 5 个最可能伤人的输入,交给最终审查逐条检查
75
+ - 自检新增「比例」:计划比规格长好几倍,就是把程序抄了一遍
76
+ - 执行交接改为「子代理驱动 / 原生执行」二选一,并要求先审阅计划
77
+
78
+ ### 其他上游变更
79
+
80
+ - **brainstorming**:「建立共同理解」——先弄清意图并写回给你确认;HARD-GATE 按路径细分(架构级:设计批准只许写规格,规格批准只许写计划)
81
+ - **code-reviewer**:规格是愿景文档,规格没提的行为按正常人的期待来判;列出「不予判断的项」交执行者裁决
82
+ - **TDD**:宣称完成前跑整个项目测试套件,看到的失败必须写进报告
83
+ - **SDD**:`sdd-workspace` 解决同名计划(`docs/a/plan.md` vs `docs/b/plan.md`)共用工作区的问题;`review-package` 拒绝空区间和非后代 HEAD
84
+ - 技能自带脚本一律经解释器调用(`bash scripts/…`)——有些插件打包器会去掉可执行位
85
+ - 新增 Claude Code、Muse 工具参考;SessionStart hook 支持 Muse
86
+
87
+ ### 🐛 OpenCode 工具映射过期(#131)
88
+
89
+ 插件还停在 v5.0.7:告诉模型用 `@mention` 派子代理——那是 TUI 里用户的输入方式,模型没有这个工具。现已换成上游 v6.4.2 插件:V1 映射到 `task` + `subagent_type`,V2(OpenCode 2.0.4+)映射到 `subagent`,并通过 `setup()` 原生注册 skill;新增根目录 `index.js` 供 V2 目录形式加载。安装文档同步更新。
90
+
91
+ ### 🐛 visual-companion.md 一直是旧版
92
+
93
+ 中文版比 v6.3.0 还旧:教你读 `$SCREEN_DIR/.server-info`,而实际脚本写的是 `$STATE_DIR/server-info`;缺 `--open`、会话 key、4 小时空闲超时等说明。标题数没变,所以 audit 看不出来。已整篇按上游重译。
94
+
95
+ ### 已知问题(上游未修,原样同步)
96
+
97
+ - `task-done` 在测试命令**完全没有输出**时会误判失败(上游 #2385)
98
+ - `task-done` 账本记的是日志最后一行,`node --test` 会记成 `# duration_ms …`(上游 #2342)
99
+
100
+ ---
101
+
102
+ ## v1.7.13 (2026-09-08)
103
+
104
+ **只有 TRAE 国内版用户需要更新。** 处理 [#35](https://github.com/jnMetaCode/superpowers-zh/issues/35) 时发现 Trae 此前**完全没有全局安装**,而国内版的全局目录还跟国际版不同构。
105
+
106
+ ### 🐛 TRAE CN 全局目录是 `~/.trae-cn/skills`,不是 `~/.trae/skills`
107
+
108
+ [TRAE CN 官方文档「技能所在目录」](https://docs.trae.cn/ide/skills):
109
+
110
+ | 作用域 | 路径 |
111
+ |---|---|
112
+ | 全局(macOS/Linux) | `~/.trae-cn/skills` |
113
+ | 全局(Windows) | `%userprofile%/.trae-cn/skills` |
114
+ | 项目 | 项目所在路径下的 `.trae/skills/` 目录 |
115
+
116
+ 全局是 **`.trae-cn`**,差一个后缀就是又一次「装了 20 个文件、工具一个都不读」。而[国际版文档](https://docs.trae.ai/ide/skills)**没有给出全局路径** —— 按本仓一贯口径不猜,所以国际版不做全局。
117
+
118
+ ```bash
119
+ npx superpowers-zh --tool trae # 项目级,两版通用(.trae/skills/)
120
+ npx superpowers-zh --global --tool traecn # 全局,仅国内版(~/.trae-cn/skills/)
121
+ ```
122
+
123
+ 别名 `traecn` / `trae-cn` / `trae-china`。`%userprofile%` 就是主目录,两平台在「主目录下的 `.trae-cn/skills`」这点上同构,不需要 `dirWin`。
124
+
125
+ **为什么单独成一条而不是挂到 Trae 上**:挂上去,国际版用户跑 `--global --tool trae` 就会装进一个 TRAE 根本不扫的目录 —— 正是这个 issue 想避免的事。项目级两版同构,仍由 `--tool trae` 一条覆盖。
126
+
127
+ ### 🐛 拒绝文案说了假话
128
+
129
+ 全局-only 工具的项目级拒绝此前是一段写死的通用文案,内容是 ZCode 的情况(「项目级导入是应用内 UI 动作、不暴露磁盘路径」)。**这对 TRAE CN 是假的** —— 它的项目级路径文档写得清清楚楚。
130
+
131
+ 改成按工具可覆盖,TRAE CN 现在说的是真实原因:
132
+
133
+ ```
134
+ ❌ TRAE CN 不支持项目级安装。
135
+
136
+ TRAE CN 的项目级技能目录与国际版 TRAE 相同(.trae/skills/),
137
+ 已经由 Trae 这一条覆盖,请直接用:
138
+ npx superpowers-zh --tool trae
139
+ 本条目只用于 TRAE CN 独有的**全局**目录(~/.trae-cn/skills)。
140
+ ```
141
+
142
+ ### 🧮 工具数仍是 26,不是 27
143
+
144
+ `TRAE CN` 在安装器里占一条,但它是**同一个 IDE 的国内发行版**,单独成条只为承载独有的全局路径。计进产品数就是灌水,站点工具墙还会出现两张同名 Trae 卡片让人不知道点哪个。
145
+
146
+ 新增 `editionOf` 标记,audit 的计数口径把这类条目排掉 —— 这是 Copilot CLI 那条例外(共用 `.claude/skills` 但单独计数)的镜像另一半。
147
+
148
+ ### 🛡️ 门禁自己的两个 bug
149
+
150
+ | 问题 | 后果 |
151
+ |---|---|
152
+ | `verify-release` J 节用 `$( )` 取全局-only 工具名 | 含空格的「TRAE CN」被词分割成 `trae` + `cn` 两个不存在的目标,门禁自己造了两条假失败 |
153
+ | 外链验活不带 User-Agent | `docs.trae.cn` 对默认 curl UA 一律 400、带浏览器 UA 返回 200,新文档的引用被误判成死链 |
154
+
155
+ 加 UA **不是**放宽判活口径:400 仍算死链,只是不再因为「对方不接待 curl」而误判。往文档里塞一条 `reasonix.io` 的真 404 做负向测试,照样被抓。
156
+
157
+ 另外补了一条 dot 流程图门禁:graphviz 遇到「边引用了未声明的节点」不报错、只会静默新建一个孤儿框。同步上游 v6.3.0 时改了 SDD 流程图的节点文案,正是这个场景。
158
+
159
+ `audit` 163 pass / 0 warn,`verify-release` 163 → **164 pass**。
160
+
161
+ ---
162
+
9
163
  ## v1.7.12 (2026-09-07)
10
164
 
11
165
  **通过 Claude Code 插件市场安装的用户请更新。** 本版修的是一个「装了,但技能之间互相调不动」的问题,
Binary file
Binary file
Binary file
@@ -84,7 +84,23 @@ const TARGETS = [
84
84
  // 检出从来没被自动检测到过。改认 skills/public:它是 skills 机制本身、随仓库版本
85
85
  // 控制,任何 DeerFlow 检出都有;deer_flow 保留作 1.x 兼容。
86
86
  { name: 'DeerFlow', dir: 'skills/custom', detect: ['skills/public', 'deer_flow'] },
87
+ // Trae 的项目级路径国际版与国内版**相同**(docs.trae.cn/ide/skills「技能所在目录」:
88
+ // 「项目技能:项目所在路径下的 .trae/skills/ 目录」),所以项目级一条覆盖两版。
89
+ // 全局则**不同构,且只有国内版有一手路径**:
90
+ // docs.trae.cn/ide/skills:macOS/Linux `~/.trae-cn/skills`,Windows `%userprofile%/.trae-cn/skills`
91
+ // (%userprofile% 就是 home,所以两平台同为 home 下的 .trae-cn/skills,不需要 dirWin)
92
+ // 国际版 docs.trae.ai/ide/skills **没有给出全局路径** —— 不猜,因此国际版无全局。
93
+ // 于是全局单独成一条 global-only 条目「TRAE CN」,而不是挂到 Trae 上:挂上去会让
94
+ // 国际版用户 --global 装进一个 TRAE 不扫的目录,正是 issue #35 想避免的那种「装了不生效」。
87
95
  { name: 'Trae', dir: '.trae/skills', detect: '.trae' },
96
+ { name: 'TRAE CN', dir: null, detect: [], editionOf: 'Trae', global: { dir: '.trae-cn/skills', detect: '.trae-cn' },
97
+ // 这一条只承担「全局」。TRAE CN 的项目级路径不是没有,而是与国际版同构
98
+ // (都是 .trae/skills/),已由上面的 Trae 条目覆盖 —— 所以拒绝理由必须说实话,
99
+ // 不能套用 ZCode 那句「项目级不暴露磁盘路径」。
100
+ noProjectReason: ` TRAE CN 的项目级技能目录与国际版 TRAE 相同(.trae/skills/),
101
+ 已经由 Trae 这一条覆盖,请直接用:
102
+ npx superpowers-zh --tool trae
103
+ 本条目只用于 TRAE CN 独有的**全局**目录(~/.trae-cn/skills)。` },
88
104
  // Antigravity 无 global:其全局 skills 加载路径未在 docs 证实(全局规则走 ~/.gemini/GEMINI.md),
89
105
  // 不确认能生效就不写,避免「装了不生效」。用户用项目级安装。
90
106
  { name: 'Antigravity', dir: '.agents/skills', detect: '.agents' },
@@ -1101,6 +1117,9 @@ const TOOL_ALIASES = {
1101
1117
  'kiro': 'Kiro',
1102
1118
  'deerflow': 'DeerFlow',
1103
1119
  'trae': 'Trae',
1120
+ 'trae-cn': 'TRAE CN',
1121
+ 'traecn': 'TRAE CN',
1122
+ 'trae-china': 'TRAE CN',
1104
1123
  'antigravity': 'Antigravity',
1105
1124
  'vscode': 'VS Code',
1106
1125
  'vs-code': 'VS Code',
@@ -1633,8 +1652,8 @@ function install(forceToolName, force, isGlobal) {
1633
1652
  console.log(`
1634
1653
  ❌ ${target.name} 不支持项目级安装。
1635
1654
 
1636
- 其官方文档只给出用户级技能目录,项目级导入是应用内的 UI 动作、不暴露磁盘路径。
1637
- 猜一个路径装进去只会「装了不生效」,所以这里直接拒绝。
1655
+ ${target.noProjectReason || ` 其官方文档只给出用户级技能目录,项目级导入是应用内的 UI 动作、不暴露磁盘路径。
1656
+ 猜一个路径装进去只会「装了不生效」,所以这里直接拒绝。`}
1638
1657
  请改用全局安装:
1639
1658
  npx superpowers-zh --global --tool ${shortestAlias(target.name) || target.name.toLowerCase()}
1640
1659
  `);
@@ -31,7 +31,7 @@ npx superpowers-zh --tool aider
31
31
 
32
32
  会做两件事:
33
33
 
34
- 1. 把 20 个 skill 复制到 `.aider/skills/`
34
+ 1. 把 21 个 skill 复制到 `.aider/skills/`
35
35
  2. 生成(或追加)`CONVENTIONS.md`,里面是 skill 索引和触发规则,指向 `.aider/skills/<name>/SKILL.md`
36
36
 
37
37
  ### 关于自动检测
@@ -64,7 +64,7 @@ read:
64
64
  - .aider/skills/systematic-debugging/SKILL.md
65
65
  ```
66
66
 
67
- 注意每个 SKILL.md 都会完整进入上下文,装 20 个的全文开销很大 —— 这正是我们默认走索引式 `CONVENTIONS.md` 的原因。
67
+ 注意每个 SKILL.md 都会完整进入上下文,装 21 个的全文开销很大 —— 这正是我们默认走索引式 `CONVENTIONS.md` 的原因。
68
68
 
69
69
  ## 故障排查
70
70
 
@@ -15,7 +15,7 @@ npx superpowers-zh --tool claw
15
15
 
16
16
  | 位置 | 内容 |
17
17
  |---|---|
18
- | `.claw/skills/<name>/SKILL.md` | 20 个 skill 正文 |
18
+ | `.claw/skills/<name>/SKILL.md` | 21 个 skill 正文 |
19
19
  | `CLAW.md` | bootstrap:核心规则 + skill 清单 |
20
20
 
21
21
  > 📌 v1.7.10 及更早**只装 skills、不写 `CLAW.md`**。skills 能被发现,但没有引导就不会在恰当时机自动触发。v1.7.11 起补上。
@@ -14,7 +14,7 @@ npx superpowers-zh --tool cline
14
14
  装完会得到两样东西:
15
15
 
16
16
  ```
17
- .cline/skills/ # 20 个 skill 本体,按需读取
17
+ .cline/skills/ # 21 个 skill 本体,按需读取
18
18
  .clinerules/
19
19
  └── superpowers-zh.md # 一份小索引,常驻 system prompt
20
20
  ```
@@ -23,13 +23,13 @@ npx superpowers-zh --tool cline
23
23
 
24
24
  Cline 没有「skills」概念,它加载的是 **Rules**:`.clinerules/` 目录下所有 `.md` / `.txt` 会被**合并进每一轮的 system prompt**。
25
25
 
26
- 这跟 skills 的懒加载完全不同 —— 所以**绝不能把 20 个 SKILL.md 直接放进 `.clinerules/`**,那会让每轮对话都背着几万字的常驻开销,Cline 官方也提示规则超过约 300 行后遵守度会下降。
26
+ 这跟 skills 的懒加载完全不同 —— 所以**绝不能把 21 个 SKILL.md 直接放进 `.clinerules/`**,那会让每轮对话都背着几万字的常驻开销,Cline 官方也提示规则超过约 300 行后遵守度会下降。
27
27
 
28
28
  superpowers-zh 的做法:
29
29
 
30
30
  | 放哪 | 内容 | 何时进 prompt |
31
31
  |------|------|--------------|
32
- | `.clinerules/superpowers-zh.md` | 核心规则 + 20 个 skill 的名称/触发条件索引表 | 每轮常驻(很小) |
32
+ | `.clinerules/superpowers-zh.md` | 核心规则 + 21 个 skill 的名称/触发条件索引表 | 每轮常驻(很小) |
33
33
  | `.cline/skills/<name>/SKILL.md` | skill 完整流程正文 | 仅当任务匹配、Cline 主动读取时 |
34
34
 
35
35
  索引 rule 里明确告诉 Cline:匹配到触发条件就去读对应的 `SKILL.md`,**不要**把正文抄进 rules。
@@ -18,7 +18,7 @@ npx superpowers-zh --tool codearts
18
18
 
19
19
  安装内容:
20
20
 
21
- - `.codeartsdoer/skills/` — 20 个 skill(每个含 `SKILL.md` 及其 `scripts/` 等附属文件)
21
+ - `.codeartsdoer/skills/` — 21 个 skill(每个含 `SKILL.md` 及其 `scripts/` 等附属文件)
22
22
 
23
23
  ## Skill 加载优先级
24
24
 
@@ -18,7 +18,7 @@ npx superpowers-zh --tool codebuddy
18
18
 
19
19
  安装内容:
20
20
 
21
- - `.codebuddy/skills/` — 20 个 skill(每个含 `SKILL.md`)
21
+ - `.codebuddy/skills/` — 21 个 skill(每个含 `SKILL.md`)
22
22
  - `CODEBUDDY.md` — bootstrap 引导(已存在则在哨兵注释间追加,不覆盖你的内容)
23
23
 
24
24
  ## 全局安装
@@ -33,6 +33,32 @@ npx superpowers-zh --tool codex
33
33
  Fetch and follow instructions from https://raw.githubusercontent.com/jnMetaCode/superpowers-zh/refs/heads/main/.codex/INSTALL.md
34
34
  ```
35
35
 
36
+ ## Codex 原生插件安装
37
+
38
+ Codex CLI 自带插件管理,可以直接把本仓库注册为 marketplace 安装,不需要 Node.js / npm(已在 codex-cli 0.147.0、0.154.0 上实测):
39
+
40
+ ```bash
41
+ codex plugin marketplace add https://github.com/jnMetaCode/superpowers-zh.git
42
+ codex plugin add superpowers-zh@superpowers-zh
43
+ codex plugin list # 应显示 superpowers-zh@superpowers-zh installed, enabled
44
+ ```
45
+
46
+ 安装后 21 个 skills 全部可被发现;插件清单声明了空 `hooks`,不会注册仅适用于 Claude Code 的 SessionStart hook。
47
+
48
+ **更新:**
49
+
50
+ ```bash
51
+ codex plugin marketplace upgrade superpowers-zh
52
+ codex plugin add superpowers-zh@superpowers-zh
53
+ ```
54
+
55
+ **卸载:**
56
+
57
+ ```bash
58
+ codex plugin remove superpowers-zh@superpowers-zh
59
+ codex plugin marketplace remove superpowers-zh # 可选:连同 marketplace 一起移除
60
+ ```
61
+
36
62
  ## 手动安装
37
63
 
38
64
  ### 前置条件
@@ -18,7 +18,7 @@ Crush 遵循 **Agent Skills 开放标准**,项目级会**自动发现**下面
18
18
  ls .claude/skills .cursor/skills .agents/skills .crush/skills 2>/dev/null
19
19
  ```
20
20
 
21
- 只要上面任一目录里已有 20 个 skill,你就不用做任何事。
21
+ 只要上面任一目录里已有 21 个 skill,你就不用做任何事。
22
22
 
23
23
  ## 快速安装
24
24
 
@@ -40,7 +40,7 @@ mkdir -p .dsh/skills
40
40
  cp -r superpowers-zh/skills/* .dsh/skills/
41
41
  ```
42
42
 
43
- 技能名必须是 kebab-case(官方约束:`^[a-z0-9]+(?:-[a-z0-9]+)*$`),本仓 20 个 skill 全部符合。
43
+ 技能名必须是 kebab-case(官方约束:`^[a-z0-9]+(?:-[a-z0-9]+)*$`),本仓 21 个 skill 全部符合。
44
44
 
45
45
  ## 卸载
46
46
 
@@ -46,7 +46,7 @@ DeerFlow 的 skill 在沙箱容器里执行,两个目录会挂到容器内的
46
46
 
47
47
  所以 skill 内部若要引用自己的附属脚本,路径要写容器内的形式,例如 `python /mnt/skills/custom/my-skill/scripts/process.py`。
48
48
 
49
- > superpowers-zh 的 20 个 skill 以 Markdown 指令为主,`brainstorming` 带的 `scripts/` 是给宿主机 harness 用的可视化伴侣服务,在 DeerFlow 的容器沙箱里不适用 —— 这部分能力在 DeerFlow 上不可用,其余 skill 的方法论正常生效。
49
+ > superpowers-zh 的 21 个 skill 以 Markdown 指令为主,`brainstorming` 带的 `scripts/` 是给宿主机 harness 用的可视化伴侣服务,在 DeerFlow 的容器沙箱里不适用 —— 这部分能力在 DeerFlow 上不可用,其余 skill 的方法论正常生效。
50
50
 
51
51
  ## 手动安装
52
52
 
@@ -12,7 +12,7 @@
12
12
  npx superpowers-zh --global --tool hermes
13
13
  ```
14
14
 
15
- 装到 `~/.hermes/skills/`,装完即生效,用 `skills_list` 就能看到 20 个 skill。
15
+ 装到 `~/.hermes/skills/`,装完即生效,用 `skills_list` 就能看到 21 个 skill。
16
16
 
17
17
  > 📌 v1.7.8 及更早版本只支持项目级安装(装到 `<项目>/.hermes/skills/`)—— 那个目录 Hermes 根本不读,等于装了不生效。这是我们的实现错误,v1.7.9 起修正。见 [#45](https://github.com/jnMetaCode/superpowers-zh/issues/45)。
18
18
 
@@ -14,20 +14,20 @@ npx superpowers-zh --tool kilocode
14
14
  装完会得到:
15
15
 
16
16
  ```
17
- .kilocode/skills/ # 20 个 skill 本体,按需读取
17
+ .kilocode/skills/ # 21 个 skill 本体,按需读取
18
18
  .kilocode/rules/
19
19
  └── superpowers-zh.md # 一份小索引,自动生效
20
20
  ```
21
21
 
22
22
  ## 工作原理
23
23
 
24
- Kilo Code 加载的是 **Rules**(规则会并入 system prompt),不是懒加载的 skills。所以和 Cline 同理:**不能把 20 个 SKILL.md 直接塞进 rules 目录**,否则每轮对话都背着巨大的常驻开销。
24
+ Kilo Code 加载的是 **Rules**(规则会并入 system prompt),不是懒加载的 skills。所以和 Cline 同理:**不能把 21 个 SKILL.md 直接塞进 rules 目录**,否则每轮对话都背着巨大的常驻开销。
25
25
 
26
26
  superpowers-zh 的做法:
27
27
 
28
28
  | 放哪 | 内容 | 何时进 prompt |
29
29
  |------|------|--------------|
30
- | `.kilocode/rules/superpowers-zh.md` | 核心规则 + 20 个 skill 的索引表 | 常驻(很小) |
30
+ | `.kilocode/rules/superpowers-zh.md` | 核心规则 + 21 个 skill 的索引表 | 常驻(很小) |
31
31
  | `.kilocode/skills/<name>/SKILL.md` | skill 完整流程正文 | 仅当任务匹配、Kilo 主动读取时 |
32
32
 
33
33
  ## 为什么用 `.kilocode/rules/` 而不是新版的 `kilo.jsonc`
@@ -35,7 +35,7 @@ npx superpowers-zh --tool kiro
35
35
 
36
36
  | 位置 | 内容 | 是否每轮常驻 |
37
37
  |---|---|---|
38
- | `.kiro/steering/superpowers-zh.md` | 索引:核心规则 + 20 个 skill 的触发条件表(约 4.4 KB) | **是**(`inclusion: always`) |
38
+ | `.kiro/steering/superpowers-zh.md` | 索引:核心规则 + 21 个 skill 的触发条件表(约 4.4 KB) | **是**(`inclusion: always`) |
39
39
  | `.kiro/skills/<name>/SKILL.md` | skill 正文 | 否,按需读取 |
40
40
 
41
41
  ## 工作原理
@@ -4,6 +4,10 @@
4
4
 
5
5
  ## 安装
6
6
 
7
+ OpenCode V2 需要 2.0.4 或更高版本。
8
+
9
+ ### OpenCode V1
10
+
7
11
  在 `opencode.json`(全局或项目级)的 `plugin` 数组中添加:
8
12
 
9
13
  ```json
@@ -12,10 +16,39 @@
12
16
  }
13
17
  ```
14
18
 
15
- 重启 OpenCode。插件通过 Bun 自动安装并注册所有 skills。
19
+ ### OpenCode V2(2.0.4 或更高版本)
20
+
21
+ 使用 V2 插件配置(注意键名是 `plugins`):
22
+
23
+ ```json
24
+ {
25
+ "plugins": ["superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git"]
26
+ }
27
+ ```
28
+
29
+ 如果是 V2 的本地安装,配置的应当是包含 `index.js` 的仓库目录。OpenCode 2.0.4 和 2.0.7 会拒绝直接配置成 JavaScript 文件路径。通过自动发现找到的插件符号链接仍然受支持。
30
+
31
+ 重启 OpenCode。V2 使用 `opencode` 命令;`opencode2` 可能作为别名可用。插件会通过 OpenCode 的插件管理器安装,并注册所有 skills。
16
32
 
17
33
  验证方式:问 "告诉我你有哪些 superpowers"
18
34
 
35
+ ### 从旧版符号链接安装方式迁移(V1)
36
+
37
+ 如果你之前使用 `git clone` 和符号链接安装过 superpowers,请移除旧的配置:
38
+
39
+ ```bash
40
+ # 移除旧的符号链接
41
+ rm -f ~/.config/opencode/plugins/superpowers.js
42
+ rm -rf ~/.config/opencode/skills/superpowers
43
+
44
+ # 可选:移除克隆的仓库
45
+ rm -rf ~/.config/opencode/superpowers
46
+
47
+ # 如果你在 opencode.json 中为 superpowers 添加过 skills.paths,请将其移除
48
+ ```
49
+
50
+ 然后按照上面的安装步骤操作。
51
+
19
52
  ## 使用
20
53
 
21
54
  ### 查找 Skills
@@ -29,7 +62,7 @@ use skill tool to list skills
29
62
  ### 加载 Skill
30
63
 
31
64
  ```
32
- use skill tool to load superpowers/brainstorming
65
+ use skill tool to load brainstorming
33
66
  ```
34
67
 
35
68
  ### 个人 Skills
@@ -57,52 +90,128 @@ description: 当 [条件] 时使用 - [功能描述]
57
90
 
58
91
  在项目的 `.opencode/skills/` 目录中创建项目级 skills。
59
92
 
60
- **Skill 优先级:** 项目 skills > 个人 skills > Superpowers skills
93
+ **V2 的 Skill 优先级:** 项目 skills > 个人 skills > Superpowers skills。在实测的 V1 1.18.31 上,当个人或项目 skill 与自带的 Superpowers skill 同名时,Superpowers 的那个优先;个人和项目 skill 请使用不同的名字。这次迁移没有改变这一行为。
61
94
 
62
95
  ## 更新
63
96
 
64
- 重启 OpenCode 时自动更新。插件每次启动都从 git 仓库重新安装。
97
+ OpenCode 通过一个基于 git 的包说明(package spec)安装 Superpowers。有些 OpenCode 和 Bun 版本会把解析出的 git 依赖锁定在 lockfile 或缓存里,所以重启不一定能拿到 Superpowers 的最新提交。如果更新没有生效,清掉 OpenCode 的包缓存,或重新安装插件。
65
98
 
66
- 锁定特定版本:
99
+ 要固定到特定版本,在包说明后面加上标签或提交(V1 的 `plugin` 键和 V2 的 `plugins` 键写法相同):
67
100
 
68
101
  ```json
69
102
  {
70
- "plugin": ["superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git#v1.0.0"]
103
+ "plugin": ["superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git#v1.7.14"]
71
104
  }
72
105
  ```
73
106
 
107
+ 在 V2 上,要固定到包含 V2 插件的版本(v1.7.13 之后的版本);v1.7.13 及更早的发布只能在 V1 上加载。
108
+
74
109
  ## 工作原理
75
110
 
76
- 插件做两件事:
111
+ 插件做两件事,按 OpenCode 的版本使用各自的 API:
112
+
113
+ 1. **注册 skills 目录**,让 OpenCode 无需符号链接或手动配置就能发现所有 superpowers skills。
114
+ - **V1:** 通过 `config` hook,注入到 `config.skills.paths`
115
+ - **V2:** 通过 `setup()` 函数,使用 `ctx.skill.transform()`(V2 原生 API,已确认运行时生效)
116
+ 2. **注入引导上下文**,附带按版本区分的工具映射:V1 会话拿到下面的 V1 工具名,V2 会话拿到 V2 工具名。
117
+ - **V1:** 通过 `experimental.chat.messages.transform` hook
118
+ - **V2:** 通过 `ctx.session.hook("context")`——V2 中的对应机制(已确认运行时生效)
119
+
120
+ 控制者会话会在临时的模型上下文里收到 using-superpowers 引导内容。被委派出去的子会话仍能使用原生 skills,但不会收到控制者的引导内容。没有父会话的手动 fork 保持控制者行为。当 V2 原生压缩保留了较早的用户消息时(默认的 `compaction.keep.tokens` 预算),引导内容会放进检查点之前保留下来的第一条用户消息里,和未压缩的会话一样。当压缩移除了所有用户消息时,插件会在检查点之后追加一条临时的引导消息。无论哪种情况,保存的历史都不会改变。
77
121
 
78
- 1. **注入引导上下文** — 通过 `experimental.chat.system.transform` hook,为每次对话添加 superpowers 意识
79
- 2. **注册 skills 目录** — 通过 `config` hook,让 OpenCode 发现所有 skills,无需符号链接或手动配置
122
+ 如果会话查询失败,插件会在这次请求里保留引导内容,并在下一次请求时重试。查询失败不会被缓存成控制者判定。
80
123
 
81
124
  ### 工具映射
82
125
 
83
- 为 Claude Code 编写的 skills 自动适配 OpenCode:
126
+ Skill 用动作来表述,而不是点名某一个运行时的工具。引导内容会把这些动作映射到你所用的 OpenCode 版本实际提供的工具上。
84
127
 
85
- - `TodoWrite` → `todowrite`
86
- - `Task`(子代理)→ OpenCode 的 `@mention` 系统
87
- - `Skill` 工具 → OpenCode 原生 `skill` 工具
88
- - 文件操作 → OpenCode 原生工具
128
+ **V1(`opencode` 1.x):**
129
+
130
+ - 「创建一条待办」/「在待办列表里标记完成」→ `todowrite`
131
+ - `Subagent (general-purpose):` 模板 → OpenCode 的 `task` 工具,传 `subagent_type: "general"`(探索代码库时用 `"explore"`)
132
+ - 「调用一个 skill」→ OpenCode 的原生 `skill` 工具
133
+ - 「读取文件」→ `read`
134
+ - 「创建文件」/「编辑文件」/「删除文件」→ `apply_patch`
135
+ - 「运行 shell 命令」→ `bash`
136
+ - 「搜索文件内容」/「按文件名查找」→ `grep`、`glob`
137
+ - 「抓取 URL」→ `webfetch`
138
+
139
+ **V2(`opencode` 2.0.4 或更高版本;`opencode2` 可能作为别名可用):**
140
+
141
+ - 「创建一条待办」→ V2 没有任何形式的待办工具;映射会让模型改为在一个 markdown 文件(或运行环境自带的计划功能)里跟踪计划
142
+ - `Subagent (general-purpose):` 模板 → OpenCode 的 `subagent` 工具,传 `agent: "general"`(或 `"explore"`);传 `sessionID` 可以继续之前的子智能体
143
+ - 「调用一个 skill」→ OpenCode 的原生 `skill` 工具
144
+ - 「读取文件」→ `read`
145
+ - 「创建、编辑或删除文件」→ 有 `patch` 时用 `patch` 并传 `patchText`;否则用 `write` 创建或覆盖文件、`edit` 做定点修改、`shell` 删除文件
146
+ - 「运行 shell 命令」→ `shell`(`command`、`workdir`、`timeout`、`background`)
147
+ - 「搜索文件内容」/「按文件名查找」→ `grep`、`glob`
148
+ - 「抓取 URL」→ `webfetch`
149
+ - 「搜索网络」→ `websearch`
150
+
151
+ 简单说,V2 把 `task` 改名为 `subagent`(智能体名称从 `subagent_type` 挪到了 `agent`,继续会话改为带 `sessionID` 重新调用),`apply_patch` 改名为 `patch`,`bash` 改名为 `shell`,并且完全去掉了待办工具。可用的写入类工具取决于所选模型:`patch` 只对选定的 GPT 模型 ID 可用,其他模型使用 `write` 和 `edit`。
152
+
153
+ (V1 清单已对照安装好的 OpenCode 1.18.x CLI 的工具清单核实;V2 清单已对照 OpenCode 2.0.4 和 2.0.7 的宿主契约核实。以上核实由上游 obra/superpowers 完成。)
89
154
 
90
155
  ## 故障排查
91
156
 
92
157
  ### 插件未加载
93
158
 
94
- 1. 检查 OpenCode 日志:`opencode run --print-logs "hello" 2>&1 | grep -i superpowers`
95
- 2. 确认 `opencode.json` 中的插件配置正确
96
- 3. 确保运行的是最新版本的 OpenCode
159
+ **V1:** 检查 OpenCode 日志:
160
+
161
+ ```
162
+ opencode run --print-logs "hello" 2>&1 | grep -i superpowers
163
+ ```
164
+
165
+ **V2:** 插件在后台服务进程里加载,它的日志只有加上 `--standalone` 时 `--print-logs` 才会显示:
166
+
167
+ ```
168
+ opencode run --standalone --print-logs "hello" 2>&1 | grep -i superpowers
169
+ ```
170
+
171
+ 或者查看 `~/.local/share/opencode/log/opencode.log`,过滤 `role=server`。
172
+
173
+ 同时确认 `opencode.json` 中的插件路径正确,并且运行的是较新版本的 OpenCode。
174
+
175
+ ### Windows 安装问题
176
+
177
+ 部分 Windows 版 OpenCode 对基于 git 的插件说明存在上游安装器问题,包括 `git+https` URL 的缓存路径问题,以及 Bun 找不到 `git.exe`(即使它在普通终端里能用)。如果 OpenCode 装不上插件,可以试试用系统的 npm 安装,再让 OpenCode 指向本地包:
178
+
179
+ ```powershell
180
+ npm install superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git --prefix "$HOME\.config\opencode"
181
+ ```
182
+
183
+ 然后按你的 OpenCode 版本,在 `opencode.json` 里使用已安装包的绝对路径。OpenCode 不展开 `~`;`~/...` 这样的条目会被当成包名,而不是本地目录。
184
+
185
+ **V1:**
186
+
187
+ ```json
188
+ {
189
+ "plugin": ["C:\\Users\\<you>\\.config\\opencode\\node_modules\\superpowers"]
190
+ }
191
+ ```
192
+
193
+ **V2(2.0.4 或更高版本):**
194
+
195
+ ```json
196
+ {
197
+ "plugins": ["C:\\Users\\<you>\\.config\\opencode\\node_modules\\superpowers"]
198
+ }
199
+ ```
97
200
 
98
201
  ### Skills 未找到
99
202
 
100
- 1. 使用 `skill` 工具列出可用 skills
203
+ 1. 使用 OpenCode 的 `skill` 工具列出可用 skills
101
204
  2. 检查插件是否正确加载(见上)
102
205
  3. 每个 skill 需要包含有效 YAML frontmatter 的 `SKILL.md` 文件
103
206
 
207
+ ### 引导内容没有出现
208
+
209
+ - **V1:** 检查 OpenCode 版本是否支持 `experimental.chat.messages.transform` hook。修改配置后重启 OpenCode。
210
+ - **V2:** 插件使用 `ctx.session.hook("context")` 注入引导内容。用 `opencode api get /api/plugin` 确认插件已加载。修改配置后用 `opencode service restart` 重启。`opencode2` 命令可能作为别名可用。
211
+
104
212
  ## 获取帮助
105
213
 
106
214
  - 提交 Issue:https://github.com/jnMetaCode/superpowers-zh/issues
107
215
  - 项目主页:https://github.com/jnMetaCode/superpowers-zh
108
- - OpenCode 文档:https://opencode.ai/docs/
216
+ - OpenCode V2 文档:https://opencode.ai/v2/docs/
217
+ - OpenCode V1 文档:https://opencode.ai/docs/
@@ -11,7 +11,7 @@ npx superpowers-zh
11
11
 
12
12
  安装脚本会自动检测 `.qoder/` 目录并:
13
13
 
14
- 1. 把 20 个 skills 复制到 `.qoder/skills/<name>/SKILL.md`
14
+ 1. 把 21 个 skills 复制到 `.qoder/skills/<name>/SKILL.md`
15
15
  2. 生成一个**始终生效**的 bootstrap rule `.qoder/rules/superpowers-zh.md`(`trigger: always_on`),让 Qoder 每个会话都加载核心规则与 skill 索引
16
16
 
17
17
  如果项目目录里还没有 `.qoder/`,可以显式指定:
@@ -27,7 +27,7 @@ npx superpowers-zh --global --tool qwen
27
27
 
28
28
  | 位置 | 内容 |
29
29
  |---|---|
30
- | `.qwen/skills/<name>/SKILL.md`(全局为 `~/.qwen/skills/`) | 20 个 skill 正文 |
30
+ | `.qwen/skills/<name>/SKILL.md`(全局为 `~/.qwen/skills/`) | 21 个 skill 正文 |
31
31
  | `QWEN.md`(全局为 `~/.qwen/QWEN.md`) | bootstrap:核心规则 + skill 清单,引导 AI 在恰当时机去读对应 SKILL.md |
32
32
 
33
33
  > 📌 v1.7.10 及更早**只装 skills、不写 bootstrap**。skills 能被 Qwen Code 发现,但没有引导就不会在恰当时机自动触发 —— 文件在磁盘上,实际很少被调用。v1.7.11 起补上。