@liangjie559567/ultrapower 5.6.5 → 5.6.7

package/docs/partials/features.md

@@ -5,20 +5,26 @@
 位于 `.omc/notepad.md` 的抗压缩记忆系统，分为三个层级：
 
 | 区块 | 行为 | 用途 |
-|---------|----------|---------|
+| --------- | ---------- | --------- |
 | **Priority Context** | 每次 session 启动时始终加载（最多 500 字符） | 关键信息：如"项目使用 pnpm"、"API key 在 .env 中" |
 | **Working Memory** | 带时间戳的条目，7 天后自动清理 | 调试线索、临时发现 |
 | **MANUAL** | 永不自动清理 | 团队联系人、部署信息、永久笔记 |
 
 **用户 skill：** `/ultrapower:note`
-- `/ultrapower:note <content>` - 添加到 Working Memory
-- `/ultrapower:note --priority <content>` - 添加到 Priority Context
-- `/ultrapower:note --manual <content>` - 添加到 MANUAL 区块
-- `/ultrapower:note --show` - 显示 notepad 内容
+
+* `/ultrapower:note <content>` - 添加到 Working Memory
+
+* `/ultrapower:note --priority <content>` - 添加到 Priority Context
+
+* `/ultrapower:note --manual <content>` - 添加到 MANUAL 区块
+
+* `/ultrapower:note --show` - 显示 notepad 内容
 
 **自动捕获：** Task agent 输出中的 `<remember>` 标签会被自动捕获：
-- `<remember>content</remember>` → 带时间戳写入 Working Memory
-- `<remember priority>content</remember>` → 替换 Priority Context
+
+* `<remember>content</remember>` → 带时间戳写入 Working Memory
+
+* `<remember priority>content</remember>` → 替换 Priority Context
 
 **API：** `initNotepad()`、`addWorkingMemoryEntry()`、`setPriorityContext()`、`addManualEntry()`、`getPriorityContext()`、`getWorkingMemory()`、`formatNotepadContext()`、`pruneOldEntries()`
 
@@ -29,7 +35,7 @@
 **位置：** `.omc/notepads/{plan-name}/`
 
 | 文件 | 用途 |
-|------|---------|
+| ------ | --------- |
 | `learnings.md` | 技术发现和模式 |
 | `decisions.md` | 架构和设计决策 |
 | `issues.md` | 已知问题和解决方案 |
@@ -42,7 +48,7 @@
 语义化任务分类，自动映射到模型层级、温度和思考预算。
 
 | 类别 | 层级 | 温度 | 思考 | 用途 |
-|----------|------|-------------|----------|---------|
+| ---------- | ------ | ------------- | ---------- | --------- |
 | `visual-engineering` | HIGH | 0.7 | high | UI/UX、前端、设计系统 |
 | `ultrabrain` | HIGH | 0.3 | max | 复杂推理、架构、深度调试 |
 | `artistry` | MEDIUM | 0.9 | medium | 创意解决方案、头脑风暴 |
@@ -56,9 +62,12 @@
 通过 `lsp_diagnostics_directory` 工具进行项目级类型检查。
 
 **策略：**
-- `auto`（默认）- 自动选择最佳策略，存在 tsconfig.json 时优先使用 tsc
-- `tsc` - 快速，使用 TypeScript 编译器
-- `lsp` - 备用方案，通过 Language Server 逐文件检查
+
+* `auto`（默认）- 自动选择最佳策略，存在 tsconfig.json 时优先使用 tsc
+
+* `tsc` - 快速，使用 TypeScript 编译器
+
+* `lsp` - 备用方案，通过 Language Server 逐文件检查
 
 **用途：** 在提交前或重构后检查整个项目的错误。
 
@@ -81,8 +90,10 @@
 **最适合：** 多组件系统、全栈应用、大规模重构
 
 **状态文件：**
-- `.omc/state/ultrapilot-state.json` - Session 状态
-- `.omc/state/ultrapilot-ownership.json` - 文件所有权
+
+* `.omc/state/ultrapilot-state.json` - Session 状态
+
+* `.omc/state/ultrapilot-ownership.json` - 文件所有权
 
 ## Swarm（v3.4）
 
@@ -91,9 +102,12 @@ N 个协调 agent，从共享任务池中原子性地认领任务。
 **用法：** `/swarm 5:executor "fix all TypeScript errors"`
 
 **特性：**
-- 共享任务列表，包含 pending/claimed/done 状态
-- 每个任务 5 分钟超时，超时后自动释放
-- 所有任务完成后干净退出
+
+* 共享任务列表，包含 pending/claimed/done 状态
+
+* 每个任务 5 分钟超时，超时后自动释放
+
+* 所有任务完成后干净退出
 
 ## Pipeline（v3.4）
 
@@ -101,7 +115,7 @@ N 个协调 agent，从共享任务池中原子性地认领任务。
 
 **内置预设：**
 | 预设 | 阶段 |
-|--------|--------|
+| -------- | -------- |
 | `review` | explore -> architect -> critic -> executor |
 | `implement` | planner -> executor -> tdd-guide |
 | `debug` | explore -> architect -> build-fixer |
@@ -133,12 +147,14 @@ N 个协调 agent，从共享任务池中原子性地认领任务。
 标准化的状态文件位置。
 
 **所有模式状态文件的标准路径：**
-- 主路径：`.omc/state/{name}.json`（本地，按项目）
-- 全局备份：`~/.omc/state/{name}.json`（全局，session 连续性）
+
+* 主路径：`.omc/state/{name}.json`（本地，按项目）
+
+* 全局备份：`~/.omc/state/{name}.json`（全局，session 连续性）
 
 **模式状态文件：**
 | 模式 | 状态文件 |
-|------|-----------|
+| ------ | ----------- |
 | ralph | `ralph-state.json` |
 | autopilot | `autopilot-state.json` |
 | ultrapilot | `ultrapilot-state.json` |

package/docs/partials/mode-hierarchy.md

@@ -37,7 +37,7 @@ ultrawork（并行化引擎）
 ## 模式关系
 
 | 模式 | 类型 | 包含 | 互斥 |
-|------|------|----------|------------------------|
+| ------ | ------ | ---------- | ------------------------ |
 | autopilot | 独立模式 | ralph、ultraqa、plan | ultrapilot |
 | ultrapilot | 独立模式 | 文件所有权、workers | autopilot |
 | swarm | 独立模式 | SQLite 认领 | - |
@@ -68,7 +68,7 @@ ultrawork（并行化引擎）
 ## 模式差异矩阵
 
 | 模式 | 最适合 | 并行化 | 持久化 | 验证 | 文件所有权 |
-|------|----------|-------------|-------------|--------------|----------------|
+| ------ | ---------- | ------------- | ------------- | -------------- | ---------------- |
 | autopilot | "帮我构建 X" | 通过 ralph | 是 | 是 | 不适用 |
 | ultrapilot | 多组件 | 20 个 worker | 是 | 是 | 分区 |
 | swarm | 同质任务 | N 个 worker | 按任务 | 按任务 | 按任务 |
@@ -88,24 +88,33 @@ ultrawork（并行化引擎）
 ## 组合模式
 
 有效组合：
-- `eco ralph` = 使用更便宜 agent 的 ralph 循环
-- `eco ultrawork` = 使用更便宜 agent 的并行执行
-- `eco autopilot` = 带成本优化的完整自主执行
+
+* `eco ralph` = 使用更便宜 agent 的 ralph 循环
+
+* `eco ultrawork` = 使用更便宜 agent 的并行执行
+
+* `eco autopilot` = 带成本优化的完整自主执行
 
 无效组合：
-- `autopilot ultrapilot` = 互斥（两者都是独立模式）
-- `` 单独使用 = 无意义（需要一个执行模式）
+
+* `autopilot ultrapilot` = 互斥（两者都是独立模式）
+
+* `` 单独使用 = 无意义（需要一个执行模式）
 
 ## 状态管理
 
 ### 标准路径
+
 所有模式状态文件使用标准化位置：
-- 主路径：`.omc/state/{name}.json`（本地，按项目）
-- 全局备份：`~/.omc/state/{name}.json`（全局，session 连续性）
+
+* 主路径：`.omc/state/{name}.json`（本地，按项目）
+
+* 全局备份：`~/.omc/state/{name}.json`（全局，session 连续性）
 
 ### 模式状态文件
+
 | 模式 | 状态文件 |
-|------|-----------|
+| ------ | ----------- |
 | ralph | `ralph-state.json` |
 | autopilot | `autopilot-state.json` |
 | ultrapilot | `ultrapilot-state.json` |

package/docs/partials/mode-selection-guide.md

@@ -3,7 +3,7 @@
 ## 快速决策
 
 | 如果你想… | 使用 | 关键词 |
-|----------------|----------|---------|
+| ---------------- | ---------- | --------- |
 | 从想法开始完全自主构建 | `autopilot` | "autopilot"、"build me"、"I want a" |
 | 并行自主执行（快 3-5 倍） | `ultrapilot` | "ultrapilot"、"parallel build" |
 | 持久化直到验证完成 | `ralph` | "ralph"、"don't stop" |
@@ -37,7 +37,7 @@
 ## 示例
 
 | 用户请求 | 最佳模式 | 原因 |
-|--------------|-----------|-----|
+| -------------- | ----------- | ----- |
 | "Build me a REST API" | autopilot | 单一连贯的交付物 |
 | "Build frontend, backend, and database" | ultrapilot | 清晰的组件边界 |
 | "Fix all 47 TypeScript errors" | swarm | 许多独立的类似任务 |
@@ -49,27 +49,37 @@
 ## 模式类型
 
 ### 独立模式
+
 这些模式独立运行：
-- **autopilot**：自主端到端执行
-- **ultrapilot**：带文件所有权的并行自主执行
-- **swarm**：带任务池的 N-agent 协调
+
+* **autopilot**：自主端到端执行
+
+* **ultrapilot**：带文件所有权的并行自主执行
+
+* **swarm**：带任务池的 N-agent 协调
 
 ### 包装器模式
+
 这些模式包装其他模式：
-- **ralph**：在 ultrawork 外层添加持久化 + 验证
+
+* **ralph**：在 ultrawork 外层添加持久化 + 验证
 
 ### 组件模式
+
 这些模式被其他模式使用：
-- **ultrawork**：并行执行引擎（被 ralph、autopilot 使用）
+
+* **ultrawork**：并行执行引擎（被 ralph、autopilot 使用）
 
 ### 修饰符模式
+
 这些模式修改其他模式的行为：
-- ****：将模型路由改为优先使用更便宜的层级
+
+* ****：将模型路由改为优先使用更便宜的层级
 
 ## 有效组合
 
 | 组合 | 效果 |
-|-------------|--------|
+| ------------- | -------- |
 | `eco ralph` | 使用更便宜 agent 的 ralph 持久化 |
 | `eco ultrawork` | 使用更便宜 agent 的并行执行 |
 | `eco autopilot` | 带成本节省的自主执行 |
@@ -77,6 +87,6 @@
 ## 无效组合
 
 | 组合 | 无效原因 |
-|-------------|-------------|
+| ------------- | ------------- |
 | `autopilot ultrapilot` | 两者都是独立模式——选其一 |
 | `` 单独使用 | 需要一个执行模式来修饰 |

package/docs/partials/verification-tiers.md

@@ -5,7 +5,7 @@
 ## 层级定义
 
 | 层级 | 标准 | Agent | 模型 | 所需证据 |
-|------|----------|-------|-------|-------------------|
+| ------ | ---------- | ------- | ------- | ------------------- |
 | **LIGHT** | <5 个文件，<100 行，完整测试覆盖 | architect-low | haiku | lsp_diagnostics 无错误 |
 | **STANDARD** | 默认（非 LIGHT 或 THOROUGH） | architect-medium | sonnet | diagnostics + 构建通过 |
 | **THOROUGH** | >20 个文件，或架构/安全变更 | architect | opus | 完整审查 + 所有测试 |
@@ -42,7 +42,7 @@ ELSE:
 覆盖自动检测的用户关键词：
 
 | 关键词 | 强制层级 |
-|---------|-------------|
+| --------- | ------------- |
 | "thorough"、"careful"、"important"、"critical" | THOROUGH |
 | "quick"、"simple"、"trivial"、"minor" | LIGHT |
 | 安全相关文件变更 | THOROUGH（始终） |
@@ -50,33 +50,49 @@ ELSE:
 ## 架构变更检测
 
 触发 `hasArchitecturalChanges` 的文件：
-- `**/config.{ts,js,json}`
-- `**/schema.{ts,prisma,sql}`
-- `**/definitions.ts`
-- `**/types.ts`
-- `package.json`
-- `tsconfig.json`
+
+* `**/config.{ts,js,json}`
+
+* `**/schema.{ts,prisma,sql}`
+
+* `**/definitions.ts`
+
+* `**/types.ts`
+
+* `package.json`
+
+* `tsconfig.json`
 
 ## 安全影响检测
 
 触发 `hasSecurityImplications` 的路径模式：
-- `**/auth/**`
-- `**/security/**`
-- `**/permissions?.{ts,js}`
-- `**/credentials?.{ts,js,json}`
-- `**/secrets?.{ts,js,json,yml,yaml}`
-- `**/tokens?.{ts,js,json}`
-- `**/passwords?.{ts,js,json}`
-- `**/oauth*`
-- `**/jwt*`
-- `**/.env*`
+
+* `**/auth/**`
+
+* `**/security/**`
+
+* `**/permissions?.{ts,js}`
+
+* `**/credentials?.{ts,js,json}`
+
+* `**/secrets?.{ts,js,json,yml,yaml}`
+
+* `**/tokens?.{ts,js,json}`
+
+* `**/passwords?.{ts,js,json}`
+
+* `**/oauth*`
+
+* `**/jwt*`
+
+* `**/.env*`
 
 ## 证据类型
 
 不同声明类型所需的证据：
 
 | 声明 | 所需证据 |
-|-------|-------------------|
+| ------- | ------------------- |
 | "已修复" | 显示现在通过的测试 |
 | "已实现" | lsp_diagnostics 无错误 + 构建通过 |
 | "已重构" | 所有测试仍然通过 |
@@ -85,7 +101,7 @@ ELSE:
 ## 成本对比
 
 | 层级 | 相对成本 | 使用场景 |
-|------|---------------|----------|
+| ------ | --------------- | ---------- |
 | LIGHT | 1x | 带测试的单文件 bug 修复 |
 | STANDARD | 5x | 多文件功能新增 |
 | THOROUGH | 20x | 大规模重构、安全变更 |

package/docs/plans/2025-11-22-opencode-support-design.md

@@ -14,16 +14,21 @@ OpenCode.ai 是一个类似于 Claude Code 和 Codex 的编程 agent。之前将
 
 ### 平台间的主要差异
 
-- **Claude Code**：原生 Anthropic 插件系统 + 基于文件的 skills
-- **Codex**：无插件系统 → bootstrap markdown + CLI 脚本
-- **OpenCode**：带事件钩子和自定义工具 API 的 JavaScript/TypeScript 插件
+* **Claude Code**：原生 Anthropic 插件系统 + 基于文件的 skills
+
+* **Codex**：无插件系统 → bootstrap markdown + CLI 脚本
+
+* **OpenCode**：带事件钩子和自定义工具 API 的 JavaScript/TypeScript 插件
 
 ### OpenCode 的 Agent 系统
 
-- **主要 agents**：Build（默认，完全访问权限）和 Plan（受限，只读）
-- **子 agents**：General（研究、搜索、多步骤任务）
-- **调用方式**：主 agents 自动调度，或手动使用 `@mention` 语法
-- **配置**：在 `opencode.json` 或 `~/.config/opencode/agent/` 中自定义 agents
+* **主要 agents**：Build（默认，完全访问权限）和 Plan（受限，只读）
+
+* **子 agents**：General（研究、搜索、多步骤任务）
+
+* **调用方式**：主 agents 自动调度，或手动使用 `@mention` 语法
+
+* **配置**：在 `opencode.json` 或 `~/.config/opencode/agent/` 中自定义 agents
 
 ## 架构
 
@@ -33,11 +38,11 @@ OpenCode.ai 是一个类似于 Claude Code 和 Codex 的编程 agent。之前将
    - 通用 skill 发现和解析逻辑
    - 供 Codex 和 OpenCode 实现共同使用
 
-2. **平台特定包装器**
+1. **平台特定包装器**
    - Codex：CLI 脚本（`.codex/superpowers-codex`）
    - OpenCode：插件模块（`.opencode/plugin/superpowers.js`）
 
-3. **Skill 目录**
+1. **Skill 目录**
    - 核心：`~/.config/opencode/superpowers/skills/`（或安装位置）
    - 个人：`~/.config/opencode/skills/`（覆盖核心 skills）
 
@@ -87,8 +92,11 @@ description: Use when [condition] - [what it does]; [additional context]
     const skillDir = path.dirname(skillPath);
 
     return `# ${frontmatter.name}
+
 # ${frontmatter.description}
+
 # Supporting tools and docs are in ${skillDir}
+
 # ============================================
 
 ${content}`;
@@ -124,11 +132,11 @@ ${content}`;
    - using-superpowers skill 的完整内容
    - 建立强制工作流
 
-2. **自动运行 find_skills**
+1. **自动运行 find_skills**
    - 预先显示所有可用 skills 的完整列表
    - 包含每个 skill 的目录
 
-3. **注入工具映射说明**
+1. **注入工具映射说明**
    ```markdown
    **OpenCode 的工具映射：**
    当 skills 引用你没有的工具时，请替换为：
@@ -143,7 +151,7 @@ ${content}`;
    - 该 skill 专用的工具
    ```
 
-4. **检查更新**（非阻塞）
+1. **检查更新**（非阻塞）
    - 带超时的快速 git fetch
    - 如有更新则通知
 
@@ -222,12 +230,12 @@ superpowers/
    - 提取路径解析（含覆盖机制）
    - 更新为仅使用 `name` 和 `description`（无 `when_to_use`）
 
-2. 更新 `.codex/superpowers-codex` 以使用共享核心
+1. 更新 `.codex/superpowers-codex` 以使用共享核心
    - 从 `../lib/skills-core.js` 导入
    - 移除重复代码
    - 保留 CLI 包装器逻辑
 
-3. 测试 Codex 实现仍然正常工作
+1. 测试 Codex 实现仍然正常工作
    - 验证 bootstrap 命令
    - 验证 use-skill 命令
    - 验证 find-skills 命令
@@ -240,12 +248,12 @@ superpowers/
    - 定义自定义工具（use_skill、find_skills）
    - 实现 session.started 钩子
 
-2. 创建 `.opencode/INSTALL.md`
+1. 创建 `.opencode/INSTALL.md`
    - 安装说明
    - 目录设置
    - 配置指南
 
-3. 测试 OpenCode 实现
+1. 测试 OpenCode 实现
    - 验证会话启动 bootstrap
    - 验证 use_skill 工具正常工作
    - 验证 find_skills 工具正常工作
@@ -263,32 +271,36 @@ superpowers/
 1. **创建隔离工作区**（使用 git worktrees）
    - 分支：`feature/opencode-support`
 
-2. **尽量遵循 TDD**
+1. **尽量遵循 TDD**
    - 测试共享核心函数
    - 测试 skill 发现和解析
    - 两个平台的集成测试
 
-3. **增量实现**
+1. **增量实现**
    - 阶段 1：重构共享核心 + 更新 Codex
    - 继续前验证 Codex 仍然正常工作
    - 阶段 2：构建 OpenCode 插件
    - 阶段 3：文档和完善
 
-4. **测试策略**
+1. **测试策略**
    - 使用真实 OpenCode 安装进行手动测试
    - 验证 skill 加载、目录、脚本正常工作
    - 并排测试 Codex 和 OpenCode
    - 验证工具映射正确工作
 
-5. **PR 和合并**
+1. **PR 和合并**
    - 创建包含完整实现的 PR
    - 在干净环境中测试
    - 合并到 main
 
 ## 优势
 
-- **代码复用**：skill 发现/解析的单一真实来源
-- **可维护性**：bug 修复同时适用于两个平台
-- **可扩展性**：易于添加未来平台（Cursor、Windsurf 等）
-- **原生集成**：正确使用 OpenCode 的插件系统
-- **一致性**：跨所有平台的相同 skill 体验
+* **代码复用**：skill 发现/解析的单一真实来源
+
+* **可维护性**：bug 修复同时适用于两个平台
+
+* **可扩展性**：易于添加未来平台（Cursor、Windsurf 等）
+
+* **原生集成**：正确使用 OpenCode 的插件系统
+
+* **一致性**：跨所有平台的相同 skill 体验