@liangjie559567/ultrapower 5.6.8 → 5.6.9

package/docs/README.opencode.md

@@ -1,372 +1,372 @@
-# OpenCode 的 ultrapower
-
-在 [OpenCode.ai](https://opencode.ai) 中使用 ultrapower 的完整指南。
-
-## 快速安装
-
-告诉 OpenCode：
-
-```
-Clone <https://github.com/liangjie559567/ultrapower> to ~/.config/opencode/ultrapower, then create directory ~/.config/opencode/plugins, then symlink ~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js to ~/.config/opencode/plugins/ultrapower.js, then symlink ~/.config/opencode/ultrapower/skills to ~/.config/opencode/skills/ultrapower, then restart opencode.
-```
-
-## 手动安装
-
-### 前提条件
-
-* 已安装 [OpenCode.ai](https://opencode.ai)
-
-* 已安装 Git
-
-### macOS / Linux
-
-```bash
-
-# 1. 安装 ultrapower（或更新现有安装）
-
-if [ -d ~/.config/opencode/ultrapower ]; then
-  cd ~/.config/opencode/ultrapower && git pull
-else
-  git clone <https://github.com/liangjie559567/ultrapower.git> ~/.config/opencode/ultrapower
-fi
-
-# 2. 创建目录
-
-mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills
-
-# 3. 删除已存在的符号链接/目录（如有）
-
-rm -f ~/.config/opencode/plugins/ultrapower.js
-rm -rf ~/.config/opencode/skills/ultrapower
-
-# 4. 创建符号链接
-
-ln -s ~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js ~/.config/opencode/plugins/ultrapower.js
-ln -s ~/.config/opencode/ultrapower/skills ~/.config/opencode/skills/ultrapower
-
-# 5. 重启 OpenCode
-
-```
-
-#### 验证安装
-
-```bash
-ls -l ~/.config/opencode/plugins/ultrapower.js
-ls -l ~/.config/opencode/skills/ultrapower
-```
-
-两者都应显示指向 ultrapower 目录的符号链接。
-
-### Windows
-
-**前提条件：**
-
-* 已安装 Git
-
-* 已启用**开发者模式**或拥有**管理员权限**
-  - Windows 10：设置 → 更新和安全 → 开发者选项
-  - Windows 11：设置 → 系统 → 开发者选项
-
-选择你的 shell：[命令提示符](#命令提示符) | [PowerShell](#powershell) | [Git Bash](#git-bash)
-
-#### 命令提示符
-
-以管理员身份运行，或启用开发者模式后运行：
-
-```cmd
-:: 1. 安装 ultrapower
-git clone <https://github.com/liangjie559567/ultrapower.git> "%USERPROFILE%\.config\opencode\ultrapower"
-
-:: 2. 创建目录
-mkdir "%USERPROFILE%\.config\opencode\plugins" 2>nul
-mkdir "%USERPROFILE%\.config\opencode\skills" 2>nul
-
-:: 3. 删除已存在的链接（重装时安全执行）
-del "%USERPROFILE%\.config\opencode\plugins\ultrapower.js" 2>nul
-rmdir "%USERPROFILE%\.config\opencode\skills\ultrapower" 2>nul
-
-:: 4. 创建插件符号链接（需要开发者模式或管理员权限）
-mklink "%USERPROFILE%\.config\opencode\plugins\ultrapower.js" "%USERPROFILE%\.config\opencode\ultrapower\.opencode\plugins\ultrapower.js"
-
-:: 5. 创建 skills junction（无需特殊权限）
-mklink /J "%USERPROFILE%\.config\opencode\skills\ultrapower" "%USERPROFILE%\.config\opencode\ultrapower\skills"
-
-:: 6. 重启 OpenCode
-```
-
-#### PowerShell
-
-以管理员身份运行，或启用开发者模式后运行：
-
-```powershell
-
-# 1. 安装 ultrapower
-
-git clone <https://github.com/liangjie559567/ultrapower.git> "$env:USERPROFILE\.config\opencode\ultrapower"
-
-# 2. 创建目录
-
-New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode\plugins"
-New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode\skills"
-
-# 3. 删除已存在的链接（重装时安全执行）
-
-Remove-Item "$env:USERPROFILE\.config\opencode\plugins\ultrapower.js" -Force -ErrorAction SilentlyContinue
-Remove-Item "$env:USERPROFILE\.config\opencode\skills\ultrapower" -Force -ErrorAction SilentlyContinue
-
-# 4. 创建插件符号链接（需要开发者模式或管理员权限）
-
-New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.config\opencode\plugins\ultrapower.js" -Target "$env:USERPROFILE\.config\opencode\ultrapower\.opencode\plugins\ultrapower.js"
-
-# 5. 创建 skills junction（无需特殊权限）
-
-New-Item -ItemType Junction -Path "$env:USERPROFILE\.config\opencode\skills\ultrapower" -Target "$env:USERPROFILE\.config\opencode\ultrapower\skills"
-
-# 6. 重启 OpenCode
-
-```
-
-#### Git Bash
-
-注意：Git Bash 的原生 `ln` 命令会复制文件而非创建符号链接。请改用 `cmd //c mklink`（`//c` 是 Git Bash 中 `/c` 的语法）。
-
-```bash
-
-# 1. 安装 ultrapower
-
-git clone <https://github.com/liangjie559567/ultrapower.git> ~/.config/opencode/ultrapower
-
-# 2. 创建目录
-
-mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills
-
-# 3. 删除已存在的链接（重装时安全执行）
-
-rm -f ~/.config/opencode/plugins/ultrapower.js 2>/dev/null
-rm -rf ~/.config/opencode/skills/ultrapower 2>/dev/null
-
-# 4. 创建插件符号链接（需要开发者模式或管理员权限）
-
-cmd //c "mklink \"$(cygpath -w ~/.config/opencode/plugins/ultrapower.js)\" \"$(cygpath -w ~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js)\""
-
-# 5. 创建 skills junction（无需特殊权限）
-
-cmd //c "mklink /J \"$(cygpath -w ~/.config/opencode/skills/ultrapower)\" \"$(cygpath -w ~/.config/opencode/ultrapower/skills)\""
-
-# 6. 重启 OpenCode
-
-```
-
-#### WSL 用户
-
-如果在 WSL 内运行 OpenCode，请改用 [macOS / Linux](#macos--linux) 的安装说明。
-
-#### 验证安装
-
-**命令提示符：**
-```cmd
-dir /AL "%USERPROFILE%\.config\opencode\plugins"
-dir /AL "%USERPROFILE%\.config\opencode\skills"
-```
-
-**PowerShell：**
-```powershell
-Get-ChildItem "$env:USERPROFILE\.config\opencode\plugins" | Where-Object { $_.LinkType }
-Get-ChildItem "$env:USERPROFILE\.config\opencode\skills" | Where-Object { $_.LinkType }
-```
-
-在输出中查找 `<SYMLINK>` 或 `<JUNCTION>`。
-
-#### Windows 故障排除
-
-**"权限不足"错误：**
-
-* 在 Windows 设置中启用开发者模式，或
-
-* 右键点击终端 → "以管理员身份运行"
-
-**"当文件已存在时无法创建文件"：**
-
-* 先运行删除命令（步骤 3），然后重试
-
-**git clone 后符号链接不起作用：**
-
-* 运行 `git config --global core.symlinks true` 并重新克隆
-
-## 使用方法
-
-### 查找 Skills
-
-使用 OpenCode 的原生 `skill` 工具列出所有可用 skills：
-
-```
-use skill tool to list skills
-```
-
-### 加载 Skill
-
-使用 OpenCode 的原生 `skill` 工具加载特定 skill：
-
-```
-use skill tool to load ultrapower/brainstorming
-```
-
-### 个人 Skills
-
-在 `~/.config/opencode/skills/` 中创建你自己的 skills：
-
-```bash
-mkdir -p ~/.config/opencode/skills/my-skill
-```
-
-创建 `~/.config/opencode/skills/my-skill/SKILL.md`：
-
-```markdown
----
-name: my-skill
-description: Use when [condition] - [what it does]
----
-
-# My Skill
-
-[Your skill content here]
-```
-
-### 项目 Skills
-
-在你的 OpenCode 项目中创建项目专属 skills：
-
-```bash
-
-# 在你的 OpenCode 项目中
-
-mkdir -p .opencode/skills/my-project-skill
-```
-
-创建 `.opencode/skills/my-project-skill/SKILL.md`：
-
-```markdown
----
-name: my-project-skill
-description: Use when [condition] - [what it does]
----
-
-# My Project Skill
-
-[Your skill content here]
-```
-
-## Skill 位置
-
-OpenCode 从以下位置发现 skills：
-
-1. **项目 skills**（`.opencode/skills/`）- 最高优先级
-2. **个人 skills**（`~/.config/opencode/skills/`）
-3. **ultrapower skills**（`~/.config/opencode/skills/ultrapower/`）- 通过符号链接
-
-## 功能特性
-
-### 自动上下文注入
-
-插件通过 `experimental.chat.system.transform` hook 自动注入 ultrapower 上下文。这会在每次请求时将 "using-superpowers" skill 内容添加到系统提示词中。
-
-### 原生 Skills 集成
-
-ultrapower 使用 OpenCode 的原生 `skill` 工具进行 skill 发现和加载。Skills 通过符号链接到 `~/.config/opencode/skills/ultrapower/`，与你的个人和项目 skills 并列显示。
-
-### 工具映射
-
-为 Claude Code 编写的 skills 会自动适配 OpenCode。bootstrap 提供映射说明：
-
-* `TodoWrite` → `update_plan`
-
-* 带子 agents 的 `Task` → OpenCode 的 `@mention` 系统
-
-* `Skill` 工具 → OpenCode 的原生 `skill` 工具
-
-* 文件操作 → OpenCode 原生工具
-
-## 架构
-
-### 插件结构
-
-**位置：** `~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js`
-
-**组件：**
-
-* 用于 bootstrap 注入的 `experimental.chat.system.transform` hook
-
-* 读取并注入 "using-superpowers" skill 内容
-
-### Skills
-
-**位置：** `~/.config/opencode/skills/ultrapower/`（符号链接到 `~/.config/opencode/ultrapower/skills/`）
-
-Skills 由 OpenCode 的原生 skill 系统发现。每个 skill 都有一个带 YAML frontmatter 的 `SKILL.md` 文件。
-
-## 更新
-
-```bash
-cd ~/.config/opencode/ultrapower
-git pull
-```
-
-重启 OpenCode 以加载更新。
-
-## 故障排除
-
-### 插件未加载
-
-1. 检查插件是否存在：`ls ~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js`
-2. 检查符号链接/junction：`ls -l ~/.config/opencode/plugins/`（macOS/Linux）或 `dir /AL %USERPROFILE%\.config\opencode\plugins`（Windows）
-3. 检查 OpenCode 日志：`opencode run "test" --print-logs --log-level DEBUG`
-4. 在日志中查找插件加载消息
-
-### Skills 未找到
-
-1. 验证 skills 符号链接：`ls -l ~/.config/opencode/skills/ultrapower`（应指向 ultrapower/skills/）
-2. 使用 OpenCode 的 `skill` 工具列出可用 skills
-3. 检查 skill 结构：每个 skill 需要一个带有效 frontmatter 的 `SKILL.md` 文件
-
-### Windows：模块未找到错误
-
-如果在 Windows 上看到 `Cannot find module` 错误：
-
-* **原因：** Git Bash 的 `ln -sf` 复制文件而非创建符号链接
-
-* **修复：** 改用 `mklink /J` 目录 junction（参见 Windows 安装步骤）
-
-### Bootstrap 未出现
-
-1. 验证 using-superpowers skill 是否存在：`ls ~/.config/opencode/ultrapower/skills/using-superpowers/SKILL.md`
-2. 检查 OpenCode 版本是否支持 `experimental.chat.system.transform` hook
-3. 修改插件后重启 OpenCode
-
-## 获取帮助
-
-* 报告问题：<https://github.com/liangjie559567/ultrapower/issues>
-
-* 主要文档：<https://github.com/liangjie559567/ultrapower>
-
-* OpenCode 文档：<https://opencode.ai/docs/>
-
-## 测试
-
-验证你的安装：
-
-```bash
-
-# 检查插件是否加载
-
-opencode run --print-logs "hello" 2>&1 | grep -i ultrapower
-
-# 检查 skills 是否可发现
-
-opencode run "use skill tool to list all skills" 2>&1 | grep -i ultrapower
-
-# 检查 bootstrap 注入
-
-opencode run "what ultrapower skills do you have?"
-```
-
-agent 应提及拥有 ultrapower 并能列出 `ultrapower/` 中的 skills。
+# OpenCode 的 ultrapower
+
+在 [OpenCode.ai](https://opencode.ai) 中使用 ultrapower 的完整指南。
+
+## 快速安装
+
+告诉 OpenCode：
+
+```
+Clone <https://github.com/liangjie559567/ultrapower> to ~/.config/opencode/ultrapower, then create directory ~/.config/opencode/plugins, then symlink ~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js to ~/.config/opencode/plugins/ultrapower.js, then symlink ~/.config/opencode/ultrapower/skills to ~/.config/opencode/skills/ultrapower, then restart opencode.
+```
+
+## 手动安装
+
+### 前提条件
+
+* 已安装 [OpenCode.ai](https://opencode.ai)
+
+* 已安装 Git
+
+### macOS / Linux
+
+```bash
+
+# 1. 安装 ultrapower（或更新现有安装）
+
+if [ -d ~/.config/opencode/ultrapower ]; then
+  cd ~/.config/opencode/ultrapower && git pull
+else
+  git clone <https://github.com/liangjie559567/ultrapower.git> ~/.config/opencode/ultrapower
+fi
+
+# 2. 创建目录
+
+mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills
+
+# 3. 删除已存在的符号链接/目录（如有）
+
+rm -f ~/.config/opencode/plugins/ultrapower.js
+rm -rf ~/.config/opencode/skills/ultrapower
+
+# 4. 创建符号链接
+
+ln -s ~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js ~/.config/opencode/plugins/ultrapower.js
+ln -s ~/.config/opencode/ultrapower/skills ~/.config/opencode/skills/ultrapower
+
+# 5. 重启 OpenCode
+
+```
+
+#### 验证安装
+
+```bash
+ls -l ~/.config/opencode/plugins/ultrapower.js
+ls -l ~/.config/opencode/skills/ultrapower
+```
+
+两者都应显示指向 ultrapower 目录的符号链接。
+
+### Windows
+
+**前提条件：**
+
+* 已安装 Git
+
+* 已启用**开发者模式**或拥有**管理员权限**
+  - Windows 10：设置 → 更新和安全 → 开发者选项
+  - Windows 11：设置 → 系统 → 开发者选项
+
+选择你的 shell：[命令提示符](#命令提示符) | [PowerShell](#powershell) | [Git Bash](#git-bash)
+
+#### 命令提示符
+
+以管理员身份运行，或启用开发者模式后运行：
+
+```cmd
+:: 1. 安装 ultrapower
+git clone <https://github.com/liangjie559567/ultrapower.git> "%USERPROFILE%\.config\opencode\ultrapower"
+
+:: 2. 创建目录
+mkdir "%USERPROFILE%\.config\opencode\plugins" 2>nul
+mkdir "%USERPROFILE%\.config\opencode\skills" 2>nul
+
+:: 3. 删除已存在的链接（重装时安全执行）
+del "%USERPROFILE%\.config\opencode\plugins\ultrapower.js" 2>nul
+rmdir "%USERPROFILE%\.config\opencode\skills\ultrapower" 2>nul
+
+:: 4. 创建插件符号链接（需要开发者模式或管理员权限）
+mklink "%USERPROFILE%\.config\opencode\plugins\ultrapower.js" "%USERPROFILE%\.config\opencode\ultrapower\.opencode\plugins\ultrapower.js"
+
+:: 5. 创建 skills junction（无需特殊权限）
+mklink /J "%USERPROFILE%\.config\opencode\skills\ultrapower" "%USERPROFILE%\.config\opencode\ultrapower\skills"
+
+:: 6. 重启 OpenCode
+```
+
+#### PowerShell
+
+以管理员身份运行，或启用开发者模式后运行：
+
+```powershell
+
+# 1. 安装 ultrapower
+
+git clone <https://github.com/liangjie559567/ultrapower.git> "$env:USERPROFILE\.config\opencode\ultrapower"
+
+# 2. 创建目录
+
+New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode\plugins"
+New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode\skills"
+
+# 3. 删除已存在的链接（重装时安全执行）
+
+Remove-Item "$env:USERPROFILE\.config\opencode\plugins\ultrapower.js" -Force -ErrorAction SilentlyContinue
+Remove-Item "$env:USERPROFILE\.config\opencode\skills\ultrapower" -Force -ErrorAction SilentlyContinue
+
+# 4. 创建插件符号链接（需要开发者模式或管理员权限）
+
+New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.config\opencode\plugins\ultrapower.js" -Target "$env:USERPROFILE\.config\opencode\ultrapower\.opencode\plugins\ultrapower.js"
+
+# 5. 创建 skills junction（无需特殊权限）
+
+New-Item -ItemType Junction -Path "$env:USERPROFILE\.config\opencode\skills\ultrapower" -Target "$env:USERPROFILE\.config\opencode\ultrapower\skills"
+
+# 6. 重启 OpenCode
+
+```
+
+#### Git Bash
+
+注意：Git Bash 的原生 `ln` 命令会复制文件而非创建符号链接。请改用 `cmd //c mklink`（`//c` 是 Git Bash 中 `/c` 的语法）。
+
+```bash
+
+# 1. 安装 ultrapower
+
+git clone <https://github.com/liangjie559567/ultrapower.git> ~/.config/opencode/ultrapower
+
+# 2. 创建目录
+
+mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills
+
+# 3. 删除已存在的链接（重装时安全执行）
+
+rm -f ~/.config/opencode/plugins/ultrapower.js 2>/dev/null
+rm -rf ~/.config/opencode/skills/ultrapower 2>/dev/null
+
+# 4. 创建插件符号链接（需要开发者模式或管理员权限）
+
+cmd //c "mklink \"$(cygpath -w ~/.config/opencode/plugins/ultrapower.js)\" \"$(cygpath -w ~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js)\""
+
+# 5. 创建 skills junction（无需特殊权限）
+
+cmd //c "mklink /J \"$(cygpath -w ~/.config/opencode/skills/ultrapower)\" \"$(cygpath -w ~/.config/opencode/ultrapower/skills)\""
+
+# 6. 重启 OpenCode
+
+```
+
+#### WSL 用户
+
+如果在 WSL 内运行 OpenCode，请改用 [macOS / Linux](#macos--linux) 的安装说明。
+
+#### 验证安装
+
+**命令提示符：**
+```cmd
+dir /AL "%USERPROFILE%\.config\opencode\plugins"
+dir /AL "%USERPROFILE%\.config\opencode\skills"
+```
+
+**PowerShell：**
+```powershell
+Get-ChildItem "$env:USERPROFILE\.config\opencode\plugins" | Where-Object { $_.LinkType }
+Get-ChildItem "$env:USERPROFILE\.config\opencode\skills" | Where-Object { $_.LinkType }
+```
+
+在输出中查找 `<SYMLINK>` 或 `<JUNCTION>`。
+
+#### Windows 故障排除
+
+**"权限不足"错误：**
+
+* 在 Windows 设置中启用开发者模式，或
+
+* 右键点击终端 → "以管理员身份运行"
+
+**"当文件已存在时无法创建文件"：**
+
+* 先运行删除命令（步骤 3），然后重试
+
+**git clone 后符号链接不起作用：**
+
+* 运行 `git config --global core.symlinks true` 并重新克隆
+
+## 使用方法
+
+### 查找 Skills
+
+使用 OpenCode 的原生 `skill` 工具列出所有可用 skills：
+
+```
+use skill tool to list skills
+```
+
+### 加载 Skill
+
+使用 OpenCode 的原生 `skill` 工具加载特定 skill：
+
+```
+use skill tool to load ultrapower/brainstorming
+```
+
+### 个人 Skills
+
+在 `~/.config/opencode/skills/` 中创建你自己的 skills：
+
+```bash
+mkdir -p ~/.config/opencode/skills/my-skill
+```
+
+创建 `~/.config/opencode/skills/my-skill/SKILL.md`：
+
+```markdown
+---
+name: my-skill
+description: Use when [condition] - [what it does]
+---
+
+# My Skill
+
+[Your skill content here]
+```
+
+### 项目 Skills
+
+在你的 OpenCode 项目中创建项目专属 skills：
+
+```bash
+
+# 在你的 OpenCode 项目中
+
+mkdir -p .opencode/skills/my-project-skill
+```
+
+创建 `.opencode/skills/my-project-skill/SKILL.md`：
+
+```markdown
+---
+name: my-project-skill
+description: Use when [condition] - [what it does]
+---
+
+# My Project Skill
+
+[Your skill content here]
+```
+
+## Skill 位置
+
+OpenCode 从以下位置发现 skills：
+
+1. **项目 skills**（`.opencode/skills/`）- 最高优先级
+2. **个人 skills**（`~/.config/opencode/skills/`）
+3. **ultrapower skills**（`~/.config/opencode/skills/ultrapower/`）- 通过符号链接
+
+## 功能特性
+
+### 自动上下文注入
+
+插件通过 `experimental.chat.system.transform` hook 自动注入 ultrapower 上下文。这会在每次请求时将 "using-superpowers" skill 内容添加到系统提示词中。
+
+### 原生 Skills 集成
+
+ultrapower 使用 OpenCode 的原生 `skill` 工具进行 skill 发现和加载。Skills 通过符号链接到 `~/.config/opencode/skills/ultrapower/`，与你的个人和项目 skills 并列显示。
+
+### 工具映射
+
+为 Claude Code 编写的 skills 会自动适配 OpenCode。bootstrap 提供映射说明：
+
+* `TodoWrite` → `update_plan`
+
+* 带子 agents 的 `Task` → OpenCode 的 `@mention` 系统
+
+* `Skill` 工具 → OpenCode 的原生 `skill` 工具
+
+* 文件操作 → OpenCode 原生工具
+
+## 架构
+
+### 插件结构
+
+**位置：** `~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js`
+
+**组件：**
+
+* 用于 bootstrap 注入的 `experimental.chat.system.transform` hook
+
+* 读取并注入 "using-superpowers" skill 内容
+
+### Skills
+
+**位置：** `~/.config/opencode/skills/ultrapower/`（符号链接到 `~/.config/opencode/ultrapower/skills/`）
+
+Skills 由 OpenCode 的原生 skill 系统发现。每个 skill 都有一个带 YAML frontmatter 的 `SKILL.md` 文件。
+
+## 更新
+
+```bash
+cd ~/.config/opencode/ultrapower
+git pull
+```
+
+重启 OpenCode 以加载更新。
+
+## 故障排除
+
+### 插件未加载
+
+1. 检查插件是否存在：`ls ~/.config/opencode/ultrapower/.opencode/plugins/ultrapower.js`
+2. 检查符号链接/junction：`ls -l ~/.config/opencode/plugins/`（macOS/Linux）或 `dir /AL %USERPROFILE%\.config\opencode\plugins`（Windows）
+3. 检查 OpenCode 日志：`opencode run "test" --print-logs --log-level DEBUG`
+4. 在日志中查找插件加载消息
+
+### Skills 未找到
+
+1. 验证 skills 符号链接：`ls -l ~/.config/opencode/skills/ultrapower`（应指向 ultrapower/skills/）
+2. 使用 OpenCode 的 `skill` 工具列出可用 skills
+3. 检查 skill 结构：每个 skill 需要一个带有效 frontmatter 的 `SKILL.md` 文件
+
+### Windows：模块未找到错误
+
+如果在 Windows 上看到 `Cannot find module` 错误：
+
+* **原因：** Git Bash 的 `ln -sf` 复制文件而非创建符号链接
+
+* **修复：** 改用 `mklink /J` 目录 junction（参见 Windows 安装步骤）
+
+### Bootstrap 未出现
+
+1. 验证 using-superpowers skill 是否存在：`ls ~/.config/opencode/ultrapower/skills/using-superpowers/SKILL.md`
+2. 检查 OpenCode 版本是否支持 `experimental.chat.system.transform` hook
+3. 修改插件后重启 OpenCode
+
+## 获取帮助
+
+* 报告问题：<https://github.com/liangjie559567/ultrapower/issues>
+
+* 主要文档：<https://github.com/liangjie559567/ultrapower>
+
+* OpenCode 文档：<https://opencode.ai/docs/>
+
+## 测试
+
+验证你的安装：
+
+```bash
+
+# 检查插件是否加载
+
+opencode run --print-logs "hello" 2>&1 | grep -i ultrapower
+
+# 检查 skills 是否可发现
+
+opencode run "use skill tool to list all skills" 2>&1 | grep -i ultrapower
+
+# 检查 bootstrap 注入
+
+opencode run "what ultrapower skills do you have?"
+```
+
+agent 应提及拥有 ultrapower 并能列出 `ultrapower/` 中的 skills。