superpowers-zh 1.7.12 → 1.7.14

package/README.md

@@ -4,7 +4,7 @@
 
 > 🦸 **superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **26 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
 
-Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 26 AI coding tools, including full translations and China-specific development skills.
+Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 21 skills across 26 AI coding tools, including full translations and China-specific development skills.
 
 [![官网 sp.aiolaola.com](https://img.shields.io/badge/🌐_官网-sp.aiolaola.com-F59E0B)](https://sp.aiolaola.com)
 [![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/superpowers-zh)
@@ -12,15 +12,17 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
 
-> 📖 **免费配套学习** → [从零学会 AI 编程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)（180 节）＋ [从零构建 AI 智能体](https://aiolaola.com/course/ai-agent?utm_source=github&utm_campaign=superpowers)（40 节）：两门免费实操课 + 实战社区，superpowers 装好后配上方法论效率翻倍
+> 📖 **免费配套学习** → [从零学会 AI 编程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)（182 节）＋ [从零构建 AI 智能体](https://aiolaola.com/course/ai-agent?utm_source=github&utm_campaign=superpowers)（40 节）：两门免费实操课 + 实战社区，superpowers 装好后配上方法论效率翻倍（站上共 13 门课、648 节，**全部 ¥0**——另有 AI 绘画 / 写小说 / 漫剧 / 量化 / DeepSeek / 深度专注 等）
 >
 > 🌍 Also available in [English](https://aiolaola.com/en?utm_source=github&utm_campaign=superpowers) · [日本語](https://aiolaola.com/ja?utm_source=github&utm_campaign=superpowers) · [Español](https://aiolaola.com/es?utm_source=github&utm_campaign=superpowers) · [한국어](https://aiolaola.com/ko?utm_source=github&utm_campaign=superpowers) · [繁體中文](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers)
 
+> 🧠 **新：让 Claude Code / Codex / Cursor / Gemini CLI 不再失忆** → [engram](https://github.com/jnMetaCode/engram)：一条 `npx @jnmetacode/engram install`，自动记住每次会话问过什么、改了哪些文件、最后怎么解决的，下次开会话自动带回（带出处）。**记忆跨工具共享**——Codex 里定的事，Claude Code 也知道。全本地、零依赖、中文友好。
+
 ### 📊 项目规模
 
 | 📦 翻译 Skills | 🇨🇳 中国原创 Skills | 🤖 支持工具 |
 |:---:|:---:|:---:|
-| **14** | **4**<br><sub>另有 2 个上游历史保留</sub> | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（腾讯）/ CodeArts（华为云码道）/ Cline / Kilo Code / Crush** |
+| **15** | **4**<br><sub>另有 2 个上游历史保留</sub> | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（腾讯）/ CodeArts（华为云码道）/ Cline / Kilo Code / Crush** |
 
 ---
 
@@ -53,7 +55,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 </td>
 <td width="75%" valign="middle">
 
-感谢 [优云智算](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh) 赞助本项目！优云智算是 UCloud 旗下 AI 云平台，主打包月、按次的高性价比国模 Agent Plan 套餐，支持 GLM-5.2，低至 **49 元/月**起。同时提供官转稳定海外模型。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7×24 技术支持、自助开票。🎁 **通过[此链接](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh)注册的用户，可得免费 5 元平台体验金！**
+感谢 [优云智算](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh) 赞助本项目！优云智算是 UCloud 旗下 AI 云平台，主打包月、按次的高性价比国模 Agent Plan 套餐，支持 GLM-5.2，低至 **49 元/月**起。最新上线 H3 视频生成套餐包，768P 低至 8 分/秒，支持 2K 画质，最长 30s 视频生成。支持企业高并发、7×24 技术支持、自助开票。🎁 **通过[此链接](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh)注册的用户，可得免费 5 元平台体验金！**
 
 </td>
 </tr>
@@ -83,6 +85,34 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 
 感谢 [APIMart](https://go.apimart.ai/gh-superpowers-zh) 赞助了本项目！APIMart 是专注 AI 图片/视频生成的低价 API 平台，**GPT-Image-2 低至 $0.006/张**，1 美元可出图 160+ 张。图片、视频一套异步 API 通吃，提交任务拿 ID、回调取结果，跑批万张不超时、换模型不改代码。按量付费、无月费，🎁 **通过[此链接](https://go.apimart.ai/gh-superpowers-zh)注册即可开用！**
 
+</td>
+</tr>
+</table>
+<table>
+<tr>
+<td width="25%">
+  <a href="https://www.volcengine.com/activity/ai618?utm_source=OWO&utm_medium=devrel-1&utm_campaign=hw&utm_term=superpowers-zh&utm_content=hw">
+    <img src="assets/sponsors/volcengine.png" alt="字节火山引擎 —— 火山方舟 Agent/Coding Plan 国模套餐首购 9.9，注册免费领 2500w Token" width="100%">
+  </a>
+</td>
+<td width="75%" valign="middle">
+
+感谢 [字节火山引擎](https://www.volcengine.com/activity/ai618?utm_source=OWO&utm_medium=devrel-1&utm_campaign=hw&utm_term=superpowers-zh&utm_content=hw) 赞助本项目！火山方舟 Agent/Coding Plan 国模套餐首购 **9.9**，支持 GLM-5.3、Kimi-K3、DeepSeek、MiniMax、Doubao 等，**注册免费领 2500w Token**，统一 API，适配编码与智能体开发。👉 **[立即前往](https://www.volcengine.com/activity/ai618?utm_source=OWO&utm_medium=devrel-1&utm_campaign=hw&utm_term=superpowers-zh&utm_content=hw)**
+
+</td>
+</tr>
+</table>
+<table>
+<tr>
+<td width="25%" align="center">
+  <a href="https://fluxionai.space/register?source=github&campaign=superpowers&promo=SUPERPOWERS">
+    <img src="assets/sponsors/logo-fluxionai-icon.png" alt="Fluxion AI —— 一个入口，接入并管理全球主流 AI 模型" width="100%">
+  </a>
+</td>
+<td width="75%" valign="middle">
+
+感谢 [Fluxion AI](https://fluxionai.space/register?source=github&campaign=superpowers&promo=SUPERPOWERS) 赞助本项目！一个入口，接入并管理全球主流 AI 模型。Fluxion AI 面向个人开发者、技术团队与企业，通过统一 API 接入并管理全球主流 AI 模型；通过多线路动态调度提升可用性，模型表现、响应时间与费用透明可查。根据不同模型与线路，API 调用成本较官方或基准价格可降低 **40%—98%**。🎁 **通过[此链接](https://fluxionai.space/register?source=github&campaign=superpowers&promo=SUPERPOWERS)注册即可获得 $3 API 额度！**
+
 </td>
 </tr>
 </table>
@@ -127,7 +157,7 @@ AI：在开始实现之前，我需要了解几个关键问题：
 | 维度 | superpowers（英文上游） | superpowers-zh（中文增强版） |
 |------|----------------------|---------------------------|
 | ⭐ Star 数 | 250k+ | — |
-| 📦 Skills 总数 | 14 | **20**（14 翻译 + 4 国产原创 + 2 上游历史保留） |
+| 📦 Skills 总数 | 15 | **21**（15 翻译 + 4 国产原创 + 2 上游历史保留） |
 | 🌐 语言 | 英文 | 中文（技术术语保留英文） |
 | 🤖 **支持工具** | **6 款**：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **26 款**：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code / OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（腾讯） / CodeArts（华为云码道） / Cline / Kilo Code / Crush / ZCode（智谱）/ DeepSeek Harness / Reasonix |
 | ⚡ **安装方式** | 按工具分别装（每款一条不同的 plugin marketplace 命令） | **`npx superpowers-zh` 一条命令自动识别项目里的工具并安装**；识别不出可 `--tool <name>` 显式指定 |
@@ -177,9 +207,9 @@ AI：在开始实现之前，我需要了解几个关键问题：
 | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) | CLI | `npx superpowers-zh` | `.dsh/skills/` + `AGENTS.md` |
 | [Reasonix](https://reasonix.io/) | CLI | `npx superpowers-zh` | `.reasonix/skills/` + `REASONIX.md`（全局 Windows 为 `%APPDATA%\reasonix\skills`） |
 
-> 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具，将 20 个 skills 安装到正确位置。
+> 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具，将 21 个 skills 安装到正确位置。
 
-### 翻译的 Skills（14 个）
+### 翻译的 Skills（15 个）
 
 | Skill | 用途 |
 |-------|------|
@@ -188,6 +218,7 @@ AI：在开始实现之前，我需要了解几个关键问题：
 | **执行计划** (executing-plans) | 按计划逐步实施，每步验证 |
 | **测试驱动开发** (test-driven-development) | 严格 TDD：先写测试，再写代码 |
 | **系统化调试** (systematic-debugging) | 四阶段调试法：定位→分析→假设→修复 |
+| **诊断 Superpowers** (diagnosing-superpowers) | 会话跑偏时读 transcript 取证，每条结论带 `path:line`，可整理成 issue |
 | **请求代码审查** (requesting-code-review) | 派遣审查 agent 检查代码质量 |
 | **接收代码审查** (receiving-code-review) | 技术严谨地处理审查反馈，拒绝敷衍 |
 | **完成前验证** (verification-before-completion) | 证据先行——声称完成前必须跑验证 |
@@ -203,7 +234,7 @@ AI：在开始实现之前，我需要了解几个关键问题：
 > ⚠️ **下表前 4 个 chinese-\* 为「手动调用」skill**——不会自动触发，需在对话中显式输入 `/chinese-xxx` 才会加载。
 > 设计为参考资料而非工作流，避免污染上游 skill 的自动调度（如 `requesting-code-review`、`brainstorming` 等）。
 >
-> ⚠️ **表格最后两个（mcp-builder / workflow-runner）不是中国原创** —— 它们来自上游，上游后来移除了，本 fork 保留下来继续维护。全仓 20 个 skill = 14 翻译 + 4 中国原创 + 2 上游历史保留。
+> ⚠️ **表格最后两个（mcp-builder / workflow-runner）不是中国原创** —— 它们来自上游，上游后来移除了，本 fork 保留下来继续维护。全仓 21 个 skill = 15 翻译 + 4 中国原创 + 2 上游历史保留。
 
 | Skill | 用途 | 调用方式 | 上游有吗？ |
 |-------|------|---------|:---:|
@@ -273,13 +304,13 @@ claude plugin update superpowers-zh@superpowers-zh       # 再升级 plugin（
 claude plugin uninstall superpowers-zh@superpowers-zh    # 卸载
 ```
 
-> **和方式一怎么选？** marketplace 装的是**完整 plugin**（skills + hooks + bootstrap 由 Claude Code 统一托管、随版本更新），但只服务 Claude Code 一款工具。要装给其余 19 款工具，仍然用方式一的 `npx superpowers-zh`。两者可以共存，但同一个项目里别重复装 Claude Code，否则 skills 会出现两份。
+> **和方式一怎么选？** marketplace 装的是**完整 plugin**（skills + hooks + bootstrap 由 Claude Code 统一托管、随版本更新），但只服务 Claude Code 一款工具。要装给其余 25 款工具，仍然用方式一的 `npx superpowers-zh`。两者可以共存，但同一个项目里别重复装 Claude Code，否则 skills 会出现两份。
 
 ### 方式三：手动安装（low-fidelity，仅作备选）
 
 > ⚠️ **手动 `cp -r skills` 是低保版安装，不等同于完整 plugin。**
 >
-> superpowers-zh 是一个完整 plugin，包含：`skills/`（20 个能力）+ `hooks/`（SessionStart 钩子，让 skill 在合适时机自动触发）+ `CLAUDE.md` / `GEMINI.md` 等 bootstrap 引导文件 + 4 套 plugin manifest（Claude Code / Cursor / Codex / Marketplace）。
+> superpowers-zh 是一个完整 plugin，包含：`skills/`（21 个能力）+ `hooks/`（SessionStart 钩子，让 skill 在合适时机自动触发）+ `CLAUDE.md` / `GEMINI.md` 等 bootstrap 引导文件 + 4 套 plugin manifest（Claude Code / Cursor / Codex / Marketplace）。
 >
 > **下面的 `cp -r skills` 命令只复制 skills 目录**，不会自动配置 hooks、不会生成 bootstrap 引导。结果：skills 物理上存在，但 AI 不会在合适时机自动调用，需要你每次手动喊 "use brainstorming skill" 之类。
 >
@@ -403,30 +434,31 @@ npx superpowers-zh@latest --uninstall
 
 ## 🌟 相关项目生态
 
-**八个项目组合使用，覆盖 AI 编程 + AI 视频创作 + 桌面陪伴的完整链路。**
+**九个项目组合使用，覆盖 AI 编程 + AI 视频创作 + 桌面陪伴的完整链路。**
 
 | 项目 | 定位 | 一句话 |
 |------|------|-------|
-| **[superpowers-zh](https://github.com/jnMetaCode/superpowers-zh)**（本项目） ![](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=flat&label=⭐) | 🧠 工作方法论 | 20 个 skills 教 AI 怎么干活（TDD / 调试 / 代码审查等） |
-| **[agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh)** ![](https://img.shields.io/github/stars/jnMetaCode/agency-agents-zh?style=flat&label=⭐) | 🎭 专家角色库 | 211 个**即插即用** AI 专家，含 46 中国原创（小红书 / 抖音 / 飞书 / 钉钉） |
-| **[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator)** | 🚀 编排引擎 | 一句话 → 211 专家协作，**几分钟出方案**（9 家 LLM / 6 免费） |
-| **[ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide)** | 📖 实战教程 | 66 个 Claude Code 技巧 + 9 款工具最佳实践 + 配置模板 |
+| **[superpowers-zh](https://github.com/jnMetaCode/superpowers-zh)**（本项目） ![](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=flat&label=⭐) | 🧠 工作方法论 | 21 个 skills 教 AI 怎么干活（TDD / 调试 / 代码审查等） |
+| **[agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh)** ![](https://img.shields.io/github/stars/jnMetaCode/agency-agents-zh?style=flat&label=⭐) | 🎭 专家角色库 | 277 个**即插即用** AI 专家，含 64 中国原创（小红书 / 抖音 / 飞书 / 钉钉 / Qt 上位机 / 机械设计） |
+| **[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator)** ![](https://img.shields.io/github/stars/jnMetaCode/agency-orchestrator?style=flat&label=%E2%AD%90) | 🚀 编排引擎 | 一句话 → 276 专家协作，**几分钟出方案**（15 种大模型 / 11 种免 key） |
+| **[ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide)** | 📖 实战教程 | 66 个 Claude Code 技巧 + 10 款工具最佳实践 + 配置模板 |
 | **[shellward](https://github.com/jnMetaCode/shellward)** | 🛡️ 安全中间件 | 8 层防御 + DLP 数据流 + 注入检测，**零依赖**（含 MCP Server） |
 | 🆕 **[ai-shortfilm-prompts](https://github.com/jnMetaCode/ai-shortfilm-prompts)** | 🎬 视频提示词 | Mx-Shell《丧尸清道夫》5 段式方法论 + Skill，Seedance / 小云雀 / Sora / 可灵 / 即梦通用 |
 | 🆕 **[local-agent-toolkit](https://github.com/jnMetaCode/local-agent-toolkit)** | 🛠️ Agent 本地三件套 | 给 agent 配上**记忆 / 技能管理 / 运行追踪**，零依赖、数据不出本机；本仓库 skills 可用 `npx @jnmetacode/skillet add jnMetaCode/superpowers-zh/skills/<名称>` 一键安装 |
 | 🆕 **[codepet](https://github.com/jnMetaCode/codepet)** | 🐾 桌面养成桌宠 | 码宠 CodePet —— 你写代码 / 用 Claude Code，它就涨经验、升级、换状态、跳舞。**全本地、隐私优先、开源** |
+| 🆕 **[openshorts](https://github.com/jnMetaCode/openshorts)** | 🎥 短视频生产线 | 开片 —— 文案进，成片出：脚本 / 配音 / 字幕 / 成片 / 发布包一条龙，**0 元 0 key 跑通第一条**，本地优先 |
 
 ---
 
-### 🔥 重点推荐：[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) — 一句话调度 211 个 AI 专家协作，几分钟交付完整方案
+### 🔥 重点推荐：[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) — 一句话调度 276 个 AI 专家协作，几分钟交付完整方案
 
 以前写个方案：你当指挥官，把 AI 轮流扮演 5 个角色，复制粘贴 10 次，1 小时没了。
 
 **现在：** 丢一句话进去 `"做一个电商退款流程"`，**产品 → 架构 → 安全 → 测试 → DBA 自动接力**，几分钟完整方案落地。
 
-- 🎭 **211+ 专家角色**（含 46 个中国市场原创：小红书 / 抖音 / 微信 / 飞书 / 钉钉）
+- 🎭 **276+ 专家角色**（含 64 个中国市场原创：小红书 / 抖音 / 微信 / 飞书 / 钉钉）
 - 🧩 **零代码 YAML**，一行 prompt 就能跑
-- 💰 **9 家 LLM 可选**（DeepSeek / Claude / OpenAI / Ollama 等，**6 家免费**）
+- 💰 **15 种大模型可选**（DeepSeek / Claude / OpenAI / Ollama 等，**11 种免 key**）
 - 🔗 **与 superpowers-zh 互补**：本项目管"**怎么做**"（方法论），orchestrator 管"**谁来做**"（角色协作）
 
 👉 **[立即体验 agency-orchestrator →](https://github.com/jnMetaCode/agency-orchestrator)**

package/README.zh-Hant.md

@@ -4,7 +4,7 @@
 
 > 🦸 **superpowers（250k+ ⭐）完整漢化 + 4 個中國原創 skills** — 讓 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **26 款 AI 編程工具**真正會幹活。從頭腦風暴到程式碼審查，從 TDD 到除錯，每個 skill 都是經過實戰驗證的工作方法論。
 
-Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 26 AI coding tools, including full translations and China-specific development skills.
+Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 21 skills across 26 AI coding tools, including full translations and China-specific development skills.
 
 [![官網 sp.aiolaola.com](https://img.shields.io/badge/🌐_官網-sp.aiolaola.com-F59E0B)](https://sp.aiolaola.com)
 [![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/superpowers-zh)
@@ -12,15 +12,14 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
 
-> 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers-tw)(180 節)＋ [AI 智能體課程](https://aiolaola.com/zh-Hant/course/agents?utm_source=github&utm_campaign=superpowers-tw)(40 節)— 繁體中文實作課程,免費
+> 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers-tw)(182 節)＋ [AI 智能體課程](https://aiolaola.com/zh-Hant/course/agents?utm_source=github&utm_campaign=superpowers-tw)(40 節)— 繁體中文實作課程,免費（站上共 13 門課、648 節，**全部 ¥0**——另有 AI 繪畫 / 寫小說 / 漫劇 / 量化 / DeepSeek / 深度專注 等）
 
-> 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)：180 節免費實操課 + 《AI 編程實戰三卷書》線上閱讀 + 實戰社群 · superpowers 裝好後配上方法論效率翻倍 · 永久免費
 
 ### 📊 專案規模
 
 | 📦 翻譯 Skills | 🇨🇳 中國原創 Skills | 🤖 支援工具 |
 |:---:|:---:|:---:|
-| **14** | **4**<br><sub>另有 2 個上游歷史保留</sub> | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（騰訊）/ CodeArts（華為雲碼道）/ Cline / Kilo Code / Crush** |
+| **15** | **4**<br><sub>另有 2 個上游歷史保留</sub> | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（騰訊）/ CodeArts（華為雲碼道）/ Cline / Kilo Code / Crush** |
 
 ---
 
@@ -53,7 +52,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 </td>
 <td width="75%" valign="middle">
 
-感謝 [優雲智算](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh) 贊助本專案！優雲智算是 UCloud 旗下 AI 雲平台，主打包月、按次的高性價比國模 Agent Plan 方案，支援 GLM-5.2，低至 **49 元/月**起。同時提供官轉穩定海外模型。支援接入 Claude Code、Codex 及 API 呼叫。支援企業高併發、7×24 技術支援、自助開票。🎁 **透過[此連結](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh)註冊的使用者，可得免費 5 元平台體驗金！**
+感謝 [優雲智算](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh) 贊助本專案！優雲智算是 UCloud 旗下 AI 雲平台，主打包月、按次的高性價比國模 Agent Plan 方案，支援 GLM-5.2，低至 **49 元/月**起。最新上線 H3 影片生成套餐包，768P 低至 8 分/秒，支援 2K 畫質，最長 30s 影片生成。支援企業高併發、7×24 技術支援、自助開票。🎁 **透過[此連結](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh)註冊的使用者，可得免費 5 元平台體驗金！**
 
 </td>
 </tr>
@@ -83,6 +82,34 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 
 感謝 [APIMart](https://go.apimart.ai/gh-superpowers-zh) 贊助了本專案！APIMart 是專注 AI 圖片/影片生成的低價 API 平台，**GPT-Image-2 低至 $0.006/張**，1 美元可出圖 160+ 張。圖片、影片一套非同步 API 通吃，提交任務拿 ID、回呼取結果，跑批萬張不逾時、換模型不改程式碼。按量付費、無月費，🎁 **透過[此連結](https://go.apimart.ai/gh-superpowers-zh)註冊即可開用！**
 
+</td>
+</tr>
+</table>
+<table>
+<tr>
+<td width="25%">
+  <a href="https://www.volcengine.com/activity/ai618?utm_source=OWO&utm_medium=devrel-1&utm_campaign=hw&utm_term=superpowers-zh&utm_content=hw">
+    <img src="assets/sponsors/volcengine.png" alt="字節火山引擎 —— 火山方舟 Agent/Coding Plan 國模套餐首購 9.9，註冊免費領 2500w Token" width="100%">
+  </a>
+</td>
+<td width="75%" valign="middle">
+
+感謝 [字節火山引擎](https://www.volcengine.com/activity/ai618?utm_source=OWO&utm_medium=devrel-1&utm_campaign=hw&utm_term=superpowers-zh&utm_content=hw) 贊助本專案！火山方舟 Agent/Coding Plan 國模套餐首購 **9.9**，支援 GLM-5.3、Kimi-K3、DeepSeek、MiniMax、Doubao 等，**註冊免費領 2500w Token**，統一 API，適配編碼與智慧體開發。👉 **[立即前往](https://www.volcengine.com/activity/ai618?utm_source=OWO&utm_medium=devrel-1&utm_campaign=hw&utm_term=superpowers-zh&utm_content=hw)**
+
+</td>
+</tr>
+</table>
+<table>
+<tr>
+<td width="25%" align="center">
+  <a href="https://fluxionai.space/register?source=github&campaign=superpowers&promo=SUPERPOWERS">
+    <img src="assets/sponsors/logo-fluxionai-icon.png" alt="Fluxion AI —— 一個入口，接入並管理全球主流 AI 模型" width="100%">
+  </a>
+</td>
+<td width="75%" valign="middle">
+
+感謝 [Fluxion AI](https://fluxionai.space/register?source=github&campaign=superpowers&promo=SUPERPOWERS) 贊助本專案！一個入口，接入並管理全球主流 AI 模型。Fluxion AI 面向個人開發者、技術團隊與企業，透過統一 API 接入並管理全球主流 AI 模型；透過多線路動態調度提升可用性，模型表現、回應時間與費用透明可查。依不同模型與線路，API 呼叫成本較官方或基準價格可降低 **40%—98%**。🎁 **透過[此連結](https://fluxionai.space/register?source=github&campaign=superpowers&promo=SUPERPOWERS)註冊即可獲得 $3 API 額度！**
+
 </td>
 </tr>
 </table>
@@ -127,7 +154,7 @@ AI：在開始實作之前，我需要了解幾個關鍵問題：
 | 維度 | superpowers（英文上游） | superpowers-zh（中文增強版） |
 |------|----------------------|---------------------------|
 | ⭐ Star 數 | 250k+ | — |
-| 📦 Skills 總數 | 14 | **20**（14 翻譯 + 4 國產原創 + 2 上游歷史保留） |
+| 📦 Skills 總數 | 15 | **21**（15 翻譯 + 4 國產原創 + 2 上游歷史保留） |
 | 🌐 語言 | 英文 | 中文（技術術語保留英文） |
 | 🤖 **支援工具** | **6 款**：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **26 款**：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code / OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（騰訊） / CodeArts（華為雲碼道） / Cline / Kilo Code / Crush / ZCode（智譜）/ DeepSeek Harness / Reasonix |
 | ⚡ **安裝方式** | 按工具分別裝（每款一條不同的 plugin marketplace 命令） | **`npx superpowers-zh` 一條命令自動識別專案裡的工具並安裝**；識別不出可 `--tool <name>` 顯式指定 |
@@ -177,9 +204,9 @@ AI：在開始實作之前，我需要了解幾個關鍵問題：
 | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) | CLI | `npx superpowers-zh` | `.dsh/skills/` + `AGENTS.md` |
 | [Reasonix](https://reasonix.io/) | CLI | `npx superpowers-zh` | `.reasonix/skills/` + `REASONIX.md`（全域 Windows 為 `%APPDATA%\reasonix\skills`） |
 
-> 執行 `npx superpowers-zh` 會自動偵測你專案中使用的工具，將 20 個 skills 安裝到正確位置。
+> 執行 `npx superpowers-zh` 會自動偵測你專案中使用的工具，將 21 個 skills 安裝到正確位置。
 
-### 翻譯的 Skills（14 個）
+### 翻譯的 Skills（15 個）
 
 | Skill | 用途 |
 |-------|------|
@@ -188,6 +215,7 @@ AI：在開始實作之前，我需要了解幾個關鍵問題：
 | **執行計畫** (executing-plans) | 按計畫逐步實施，每步驗證 |
 | **測試驅動開發** (test-driven-development) | 嚴格 TDD：先寫測試，再寫程式碼 |
 | **系統化除錯** (systematic-debugging) | 四階段除錯法：定位→分析→假設→修復 |
+| **診斷 Superpowers** (diagnosing-superpowers) | 會話跑偏時讀 transcript 取證，每條結論帶 `path:line`，可整理成 issue |
 | **請求程式碼審查** (requesting-code-review) | 派遣審查 agent 檢查程式碼品質 |
 | **接收程式碼審查** (receiving-code-review) | 技術嚴謹地處理審查回饋，拒絕敷衍 |
 | **完成前驗證** (verification-before-completion) | 證據先行——聲稱完成前必須跑驗證 |
@@ -203,7 +231,7 @@ AI：在開始實作之前，我需要了解幾個關鍵問題：
 > ⚠️ **下表前 4 個 chinese-\* 為「手動呼叫」skill**——不會自動觸發，需在對話中顯式輸入 `/chinese-xxx` 才會載入。
 > 設計為參考資料而非工作流，避免污染上游 skill 的自動排程（如 `requesting-code-review`、`brainstorming` 等）。
 >
-> ⚠️ **表格最後兩個（mcp-builder / workflow-runner）不是中國原創** —— 它們來自上游，上游後來移除了，本 fork 保留下來繼續維護。全倉 20 個 skill = 14 翻譯 + 4 中國原創 + 2 上游歷史保留。
+> ⚠️ **表格最後兩個（mcp-builder / workflow-runner）不是中國原創** —— 它們來自上游，上游後來移除了，本 fork 保留下來繼續維護。全倉 21 個 skill = 15 翻譯 + 4 中國原創 + 2 上游歷史保留。
 
 | Skill | 用途 | 呼叫方式 | 上游有嗎？ |
 |-------|------|---------|:---:|
@@ -273,13 +301,13 @@ claude plugin update superpowers-zh@superpowers-zh       # 再升級 plugin（
 claude plugin uninstall superpowers-zh@superpowers-zh    # 卸載
 ```
 
-> **和方式一怎麼選？** marketplace 裝的是**完整 plugin**（skills + hooks + bootstrap 由 Claude Code 統一託管、隨版本更新），但只服務 Claude Code 一款工具。要裝給其餘 19 款工具，仍然用方式一的 `npx superpowers-zh`。兩者可以共存，但同一個專案裡別重複裝 Claude Code，否則 skills 會出現兩份。
+> **和方式一怎麼選？** marketplace 裝的是**完整 plugin**（skills + hooks + bootstrap 由 Claude Code 統一託管、隨版本更新），但只服務 Claude Code 一款工具。要裝給其餘 25 款工具，仍然用方式一的 `npx superpowers-zh`。兩者可以共存，但同一個專案裡別重複裝 Claude Code，否則 skills 會出現兩份。
 
 ### 方式三：手動安裝（low-fidelity，僅作備選）
 
 > ⚠️ **手動 `cp -r skills` 是低保版安裝，不等同於完整 plugin。**
 >
-> superpowers-zh 是一個完整 plugin，包含：`skills/`（20 個能力）+ `hooks/`（SessionStart 鉤子，讓 skill 在合適時機自動觸發）+ `CLAUDE.md` / `GEMINI.md` 等 bootstrap 引導檔案 + 4 套 plugin manifest（Claude Code / Cursor / Codex / Marketplace）。
+> superpowers-zh 是一個完整 plugin，包含：`skills/`（21 個能力）+ `hooks/`（SessionStart 鉤子，讓 skill 在合適時機自動觸發）+ `CLAUDE.md` / `GEMINI.md` 等 bootstrap 引導檔案 + 4 套 plugin manifest（Claude Code / Cursor / Codex / Marketplace）。
 >
 > **下面的 `cp -r skills` 命令只複製 skills 目錄**，不會自動設定 hooks、不會產生 bootstrap 引導。結果：skills 物理上存在，但 AI 不會在合適時機自動呼叫，需要你每次手動喊 "use brainstorming skill" 之類。
 >
@@ -403,30 +431,31 @@ npx superpowers-zh@latest --uninstall
 
 ## 🌟 相關專案生態
 
-**八個專案組合使用，涵蓋 AI 編程 + AI 影片創作 + 桌面陪伴的完整鏈路。**
+**九個專案組合使用，涵蓋 AI 編程 + AI 影片創作 + 桌面陪伴的完整鏈路。**
 
 | 專案 | 定位 | 一句話 |
 |------|------|-------|
-| **[superpowers-zh](https://github.com/jnMetaCode/superpowers-zh)**（本專案） ![](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=flat&label=⭐) | 🧠 工作方法論 | 20 個 skills 教 AI 怎麼幹活（TDD / 除錯 / 程式碼審查等） |
-| **[agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh)** ![](https://img.shields.io/github/stars/jnMetaCode/agency-agents-zh?style=flat&label=⭐) | 🎭 專家角色庫 | 211 個**即插即用** AI 專家，含 46 中國原創（小紅書 / 抖音 / 飛書 / 釘釘） |
-| **[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator)** | 🚀 編排引擎 | 一句話 → 211 專家協作，**幾分鐘出方案**（9 家 LLM / 6 免費） |
-| **[ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide)** | 📖 實戰教程 | 66 個 Claude Code 技巧 + 9 款工具最佳實踐 + 設定範本 |
+| **[superpowers-zh](https://github.com/jnMetaCode/superpowers-zh)**（本專案） ![](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=flat&label=⭐) | 🧠 工作方法論 | 21 個 skills 教 AI 怎麼幹活（TDD / 除錯 / 程式碼審查等） |
+| **[agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh)** ![](https://img.shields.io/github/stars/jnMetaCode/agency-agents-zh?style=flat&label=⭐) | 🎭 專家角色庫 | 277 個**即插即用** AI 專家，含 64 中國原創（小紅書 / 抖音 / 飛書 / 釘釘 / Qt 上位機 / 機械設計） |
+| **[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator)** ![](https://img.shields.io/github/stars/jnMetaCode/agency-orchestrator?style=flat&label=%E2%AD%90) | 🚀 編排引擎 | 一句話 → 276 專家協作，**幾分鐘出方案**（15 種大模型 / 11 種免 key） |
+| **[ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide)** | 📖 實戰教程 | 66 個 Claude Code 技巧 + 10 款工具最佳實踐 + 設定範本 |
 | **[shellward](https://github.com/jnMetaCode/shellward)** | 🛡️ 安全中介軟體 | 8 層防禦 + DLP 資料流 + 注入偵測，**零依賴**（含 MCP Server） |
 | 🆕 **[ai-shortfilm-prompts](https://github.com/jnMetaCode/ai-shortfilm-prompts)** | 🎬 影片提示詞 | Mx-Shell《喪屍清道夫》5 段式方法論 + Skill，Seedance / 小雲雀 / Sora / 可靈 / 即夢通用 |
 | 🆕 **[local-agent-toolkit](https://github.com/jnMetaCode/local-agent-toolkit)** | 🛠️ Agent 本地三件套 | 給 agent 配上**記憶 / 技能管理 / 執行追蹤**，零依賴、資料不出本機；本倉庫 skills 可用 `npx @jnmetacode/skillet add jnMetaCode/superpowers-zh/skills/<名稱>` 一鍵安裝 |
 | 🆕 **[codepet](https://github.com/jnMetaCode/codepet)** | 🐾 桌面養成桌寵 | 碼寵 CodePet —— 你寫程式碼 / 用 Claude Code，它就漲經驗、升級、換狀態、跳舞。**全本地、隱私優先、開源** |
+| 🆕 **[openshorts](https://github.com/jnMetaCode/openshorts)** | 🎥 短影片生產線 | 開片 —— 文案進，成片出：腳本 / 配音 / 字幕 / 成片 / 發布包一條龍，**0 元 0 key 跑通第一條**，本地優先 |
 
 ---
 
-### 🔥 重點推薦：[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) — 一句話調度 211 個 AI 專家協作，幾分鐘交付完整方案
+### 🔥 重點推薦：[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) — 一句話調度 276 個 AI 專家協作，幾分鐘交付完整方案
 
 以前寫個方案：你當指揮官，把 AI 輪流扮演 5 個角色，複製貼上 10 次，1 小時沒了。
 
 **現在：** 丟一句話進去 `"做一個電商退款流程"`，**產品 → 架構 → 安全 → 測試 → DBA 自動接力**，幾分鐘完整方案落地。
 
-- 🎭 **211+ 專家角色**（含 46 個中國市場原創：小紅書 / 抖音 / 微信 / 飛書 / 釘釘）
+- 🎭 **276+ 專家角色**（含 64 個中國市場原創：小紅書 / 抖音 / 微信 / 飛書 / 釘釘）
 - 🧩 **零程式碼 YAML**，一行 prompt 就能跑
-- 💰 **9 家 LLM 可選**（DeepSeek / Claude / OpenAI / Ollama 等，**6 家免費**）
+- 💰 **15 種大模型可選**（DeepSeek / Claude / OpenAI / Ollama 等，**11 種免 key**）
 - 🔗 **與 superpowers-zh 互補**：本專案管"**怎麼做**"（方法論），orchestrator 管"**誰來做**"（角色協作）
 
 👉 **[立即體驗 agency-orchestrator →](https://github.com/jnMetaCode/agency-orchestrator)**

package/RELEASE-NOTES.zh.md

@@ -6,6 +6,114 @@
 
 ---
 
+## v1.7.14 (2026-09-26)
+
+**同步上游 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)。
+
+### ✨ 新 skill：diagnosing-superpowers（第 21 个）
+
+会话跑偏时——重复劳动、无视计划、太慢、太贵、某个技能没触发——让它读磁盘上的会话记录，按 7 个维度并行分析，出一份**每条结论都带 `path:line`** 的报告；需要时整理成 issue、打包脱敏材料。它只报告发生了什么，不替你诊断 skill 本身。
+
+与上游唯一的有意偏离：**issue 目标是本仓 `jnMetaCode/superpowers-zh`**，不是 obra/superpowers——你跑的是译文，问题先在这里分流，确认是上游行为再转报。
+
+### 🔁 executing-plans 重写：内联执行
+
+从「单独会话 + 检查点」改成**在当前会话里自己当实现者**：`task-start` 取简报和 BASE，`task-done` 跑测试、只有通过才记账本，最后派一个最强模型做整分支审查。与 SDD 共用工作区和账本，中途可以换执行方式。遇到计划缺陷**自己裁决并记账**，只有 4 类硬停止。
+
+旧版里本 fork 自加的「常见异常处理」（计划有误就停下问）与此直接冲突，已删除。
+
+### ✂️ writing-plans：更短的计划
+
+- 步骤只写实现者**无法自己决定**的东西：签名、文件、规格取值、测试断言；函数体由实现者写
+- 新增「审查重点」：规格隐含、但没有测试覆盖的 5 个最可能伤人的输入，交给最终审查逐条检查
+- 自检新增「比例」：计划比规格长好几倍，就是把程序抄了一遍
+- 执行交接改为「子代理驱动 / 原生执行」二选一，并要求先审阅计划
+
+### 其他上游变更
+
+- **brainstorming**：「建立共同理解」——先弄清意图并写回给你确认；HARD-GATE 按路径细分（架构级：设计批准只许写规格，规格批准只许写计划）
+- **code-reviewer**：规格是愿景文档，规格没提的行为按正常人的期待来判；列出「不予判断的项」交执行者裁决
+- **TDD**：宣称完成前跑整个项目测试套件，看到的失败必须写进报告
+- **SDD**：`sdd-workspace` 解决同名计划（`docs/a/plan.md` vs `docs/b/plan.md`）共用工作区的问题；`review-package` 拒绝空区间和非后代 HEAD
+- 技能自带脚本一律经解释器调用（`bash scripts/…`）——有些插件打包器会去掉可执行位
+- 新增 Claude Code、Muse 工具参考；SessionStart hook 支持 Muse
+
+### 🐛 OpenCode 工具映射过期（#131）
+
+插件还停在 v5.0.7：告诉模型用 `@mention` 派子代理——那是 TUI 里用户的输入方式，模型没有这个工具。现已换成上游 v6.4.2 插件：V1 映射到 `task` + `subagent_type`，V2（OpenCode 2.0.4+）映射到 `subagent`，并通过 `setup()` 原生注册 skill；新增根目录 `index.js` 供 V2 目录形式加载。安装文档同步更新。
+
+### 🐛 visual-companion.md 一直是旧版
+
+中文版比 v6.3.0 还旧：教你读 `$SCREEN_DIR/.server-info`，而实际脚本写的是 `$STATE_DIR/server-info`；缺 `--open`、会话 key、4 小时空闲超时等说明。标题数没变，所以 audit 看不出来。已整篇按上游重译。
+
+### 已知问题（上游未修，原样同步）
+
+- `task-done` 在测试命令**完全没有输出**时会误判失败（上游 #2385）
+- `task-done` 账本记的是日志最后一行，`node --test` 会记成 `# duration_ms …`（上游 #2342）
+
+---
+
+## v1.7.13 (2026-09-08)
+
+**只有 TRAE 国内版用户需要更新。** 处理 [#35](https://github.com/jnMetaCode/superpowers-zh/issues/35) 时发现 Trae 此前**完全没有全局安装**，而国内版的全局目录还跟国际版不同构。
+
+### 🐛 TRAE CN 全局目录是 `~/.trae-cn/skills`，不是 `~/.trae/skills`
+
+[TRAE CN 官方文档「技能所在目录」](https://docs.trae.cn/ide/skills)：
+
+| 作用域 | 路径 |
+|---|---|
+| 全局（macOS/Linux） | `~/.trae-cn/skills` |
+| 全局（Windows） | `%userprofile%/.trae-cn/skills` |
+| 项目 | 项目所在路径下的 `.trae/skills/` 目录 |
+
+全局是 **`.trae-cn`**，差一个后缀就是又一次「装了 20 个文件、工具一个都不读」。而[国际版文档](https://docs.trae.ai/ide/skills)**没有给出全局路径** —— 按本仓一贯口径不猜，所以国际版不做全局。
+
+```bash
+npx superpowers-zh --tool trae             # 项目级，两版通用（.trae/skills/）
+npx superpowers-zh --global --tool traecn  # 全局，仅国内版（~/.trae-cn/skills/）
+```
+
+别名 `traecn` / `trae-cn` / `trae-china`。`%userprofile%` 就是主目录，两平台在「主目录下的 `.trae-cn/skills`」这点上同构，不需要 `dirWin`。
+
+**为什么单独成一条而不是挂到 Trae 上**：挂上去，国际版用户跑 `--global --tool trae` 就会装进一个 TRAE 根本不扫的目录 —— 正是这个 issue 想避免的事。项目级两版同构，仍由 `--tool trae` 一条覆盖。
+
+### 🐛 拒绝文案说了假话
+
+全局-only 工具的项目级拒绝此前是一段写死的通用文案，内容是 ZCode 的情况（「项目级导入是应用内 UI 动作、不暴露磁盘路径」）。**这对 TRAE CN 是假的** —— 它的项目级路径文档写得清清楚楚。
+
+改成按工具可覆盖，TRAE CN 现在说的是真实原因：
+
+```
+❌ TRAE CN 不支持项目级安装。
+
+  TRAE CN 的项目级技能目录与国际版 TRAE 相同（.trae/skills/），
+  已经由 Trae 这一条覆盖，请直接用：
+    npx superpowers-zh --tool trae
+  本条目只用于 TRAE CN 独有的**全局**目录（~/.trae-cn/skills）。
+```
+
+### 🧮 工具数仍是 26，不是 27
+
+`TRAE CN` 在安装器里占一条，但它是**同一个 IDE 的国内发行版**，单独成条只为承载独有的全局路径。计进产品数就是灌水，站点工具墙还会出现两张同名 Trae 卡片让人不知道点哪个。
+
+新增 `editionOf` 标记，audit 的计数口径把这类条目排掉 —— 这是 Copilot CLI 那条例外（共用 `.claude/skills` 但单独计数）的镜像另一半。
+
+### 🛡️ 门禁自己的两个 bug
+
+| 问题 | 后果 |
+|---|---|
+| `verify-release` J 节用 `$( )` 取全局-only 工具名 | 含空格的「TRAE CN」被词分割成 `trae` + `cn` 两个不存在的目标，门禁自己造了两条假失败 |
+| 外链验活不带 User-Agent | `docs.trae.cn` 对默认 curl UA 一律 400、带浏览器 UA 返回 200，新文档的引用被误判成死链 |
+
+加 UA **不是**放宽判活口径：400 仍算死链，只是不再因为「对方不接待 curl」而误判。往文档里塞一条 `reasonix.io` 的真 404 做负向测试，照样被抓。
+
+另外补了一条 dot 流程图门禁：graphviz 遇到「边引用了未声明的节点」不报错、只会静默新建一个孤儿框。同步上游 v6.3.0 时改了 SDD 流程图的节点文案，正是这个场景。
+
+`audit` 163 pass / 0 warn，`verify-release` 163 → **164 pass**。
+
+---
+
 ## v1.7.12 (2026-09-07)
 
 **通过 Claude Code 插件市场安装的用户请更新。** 本版修的是一个「装了，但技能之间互相调不动」的问题，

package/bin/superpowers-zh.js

@@ -84,7 +84,23 @@ const TARGETS = [
   // 检出从来没被自动检测到过。改认 skills/public：它是 skills 机制本身、随仓库版本
   // 控制，任何 DeerFlow 检出都有；deer_flow 保留作 1.x 兼容。
   { name: 'DeerFlow',      dir: 'skills/custom',             detect: ['skills/public', 'deer_flow'] },
+  // Trae 的项目级路径国际版与国内版**相同**（docs.trae.cn/ide/skills「技能所在目录」：
+  //   「项目技能：项目所在路径下的 .trae/skills/ 目录」），所以项目级一条覆盖两版。
+  // 全局则**不同构，且只有国内版有一手路径**：
+  //   docs.trae.cn/ide/skills：macOS/Linux `~/.trae-cn/skills`，Windows `%userprofile%/.trae-cn/skills`
+  //   （%userprofile% 就是 home，所以两平台同为 home 下的 .trae-cn/skills，不需要 dirWin）
+  //   国际版 docs.trae.ai/ide/skills **没有给出全局路径** —— 不猜，因此国际版无全局。
+  // 于是全局单独成一条 global-only 条目「TRAE CN」，而不是挂到 Trae 上：挂上去会让
+  // 国际版用户 --global 装进一个 TRAE 不扫的目录，正是 issue #35 想避免的那种「装了不生效」。
   { name: 'Trae',          dir: '.trae/skills',              detect: '.trae' },
+  { name: 'TRAE CN',       dir: null,                        detect: [],                                editionOf: 'Trae', global: { dir: '.trae-cn/skills',        detect: '.trae-cn' },
+    // 这一条只承担「全局」。TRAE CN 的项目级路径不是没有，而是与国际版同构
+    // （都是 .trae/skills/），已由上面的 Trae 条目覆盖 —— 所以拒绝理由必须说实话，
+    // 不能套用 ZCode 那句「项目级不暴露磁盘路径」。
+    noProjectReason: `        TRAE CN 的项目级技能目录与国际版 TRAE 相同（.trae/skills/），
+        已经由 Trae 这一条覆盖，请直接用：
+          npx superpowers-zh --tool trae
+        本条目只用于 TRAE CN 独有的**全局**目录（~/.trae-cn/skills）。` },
   // Antigravity 无 global：其全局 skills 加载路径未在 docs 证实（全局规则走 ~/.gemini/GEMINI.md），
   // 不确认能生效就不写，避免「装了不生效」。用户用项目级安装。
   { name: 'Antigravity',   dir: '.agents/skills',            detect: '.agents' },
@@ -1101,6 +1117,9 @@ const TOOL_ALIASES = {
   'kiro':         'Kiro',
   'deerflow':     'DeerFlow',
   'trae':         'Trae',
+  'trae-cn':      'TRAE CN',
+  'traecn':       'TRAE CN',
+  'trae-china':   'TRAE CN',
   'antigravity':  'Antigravity',
   'vscode':       'VS Code',
   'vs-code':      'VS Code',
@@ -1633,8 +1652,8 @@ function install(forceToolName, force, isGlobal) {
       console.log(`
       ❌ ${target.name} 不支持项目级安装。
 
-        其官方文档只给出用户级技能目录，项目级导入是应用内的 UI 动作、不暴露磁盘路径。
-        猜一个路径装进去只会「装了不生效」，所以这里直接拒绝。
+${target.noProjectReason || `        其官方文档只给出用户级技能目录，项目级导入是应用内的 UI 动作、不暴露磁盘路径。
+        猜一个路径装进去只会「装了不生效」，所以这里直接拒绝。`}
         请改用全局安装：
           npx superpowers-zh --global --tool ${shortestAlias(target.name) || target.name.toLowerCase()}
     `);

package/docs/README.aider.md

@@ -31,7 +31,7 @@ npx superpowers-zh --tool aider
 
 会做两件事：
 
-1. 把 20 个 skill 复制到 `.aider/skills/`
+1. 把 21 个 skill 复制到 `.aider/skills/`
 2. 生成（或追加）`CONVENTIONS.md`，里面是 skill 索引和触发规则，指向 `.aider/skills/<name>/SKILL.md`
 
 ### 关于自动检测
@@ -64,7 +64,7 @@ read:
   - .aider/skills/systematic-debugging/SKILL.md
 ```
 
-注意每个 SKILL.md 都会完整进入上下文，装 20 个的全文开销很大 —— 这正是我们默认走索引式 `CONVENTIONS.md` 的原因。
+注意每个 SKILL.md 都会完整进入上下文，装 21 个的全文开销很大 —— 这正是我们默认走索引式 `CONVENTIONS.md` 的原因。
 
 ## 故障排查
 

package/docs/README.claw.md

@@ -15,7 +15,7 @@ npx superpowers-zh --tool claw
 
 | 位置 | 内容 |
 |---|---|
-| `.claw/skills/<name>/SKILL.md` | 20 个 skill 正文 |
+| `.claw/skills/<name>/SKILL.md` | 21 个 skill 正文 |
 | `CLAW.md` | bootstrap：核心规则 + skill 清单 |
 
 > 📌 v1.7.10 及更早**只装 skills、不写 `CLAW.md`**。skills 能被发现，但没有引导就不会在恰当时机自动触发。v1.7.11 起补上。

package/docs/README.cline.md

@@ -14,7 +14,7 @@ npx superpowers-zh --tool cline
 装完会得到两样东西：
 
 ```
-.cline/skills/            # 20 个 skill 本体，按需读取
+.cline/skills/            # 21 个 skill 本体，按需读取
 .clinerules/
 └── superpowers-zh.md     # 一份小索引，常驻 system prompt
 ```
@@ -23,13 +23,13 @@ npx superpowers-zh --tool cline
 
 Cline 没有「skills」概念，它加载的是 **Rules**：`.clinerules/` 目录下所有 `.md` / `.txt` 会被**合并进每一轮的 system prompt**。
 
-这跟 skills 的懒加载完全不同 —— 所以**绝不能把 20 个 SKILL.md 直接放进 `.clinerules/`**，那会让每轮对话都背着几万字的常驻开销，Cline 官方也提示规则超过约 300 行后遵守度会下降。
+这跟 skills 的懒加载完全不同 —— 所以**绝不能把 21 个 SKILL.md 直接放进 `.clinerules/`**，那会让每轮对话都背着几万字的常驻开销，Cline 官方也提示规则超过约 300 行后遵守度会下降。
 
 superpowers-zh 的做法：
 
 | 放哪 | 内容 | 何时进 prompt |
 |------|------|--------------|
-| `.clinerules/superpowers-zh.md` | 核心规则 + 20 个 skill 的名称/触发条件索引表 | 每轮常驻（很小） |
+| `.clinerules/superpowers-zh.md` | 核心规则 + 21 个 skill 的名称/触发条件索引表 | 每轮常驻（很小） |
 | `.cline/skills/<name>/SKILL.md` | skill 完整流程正文 | 仅当任务匹配、Cline 主动读取时 |
 
 索引 rule 里明确告诉 Cline：匹配到触发条件就去读对应的 `SKILL.md`，**不要**把正文抄进 rules。

package/docs/README.codearts.md

@@ -18,7 +18,7 @@ npx superpowers-zh --tool codearts
 
 安装内容：
 
-- `.codeartsdoer/skills/` — 20 个 skill（每个含 `SKILL.md` 及其 `scripts/` 等附属文件）
+- `.codeartsdoer/skills/` — 21 个 skill（每个含 `SKILL.md` 及其 `scripts/` 等附属文件）
 
 ## Skill 加载优先级
 

package/docs/README.codebuddy.md

@@ -18,7 +18,7 @@ npx superpowers-zh --tool codebuddy
 
 安装内容：
 
-- `.codebuddy/skills/` — 20 个 skill（每个含 `SKILL.md`）
+- `.codebuddy/skills/` — 21 个 skill（每个含 `SKILL.md`）
 - `CODEBUDDY.md` — bootstrap 引导（已存在则在哨兵注释间追加，不覆盖你的内容）
 
 ## 全局安装