@liangjie559567/ultrapower 5.2.2 → 5.2.4

package/docs/partials/AGENTS.md

@@ -0,0 +1,24 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/partials/
+
+## Purpose
+文档片段目录。存放可复用的文档组件，包括 agent 层级说明、功能特性描述、模式层级和选择指南等，供主文档引用。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `agent-tiers.md` | Agent 层级（haiku/sonnet/opus）说明 |
+| `features.md` | 功能特性描述片段 |
+| `mode-hierarchy.md` | 执行模式层级关系说明 |
+| `mode-selection-guide.md` | 模式选择决策指南 |
+| `verification-tiers.md` | 验证层级说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 片段变更需检查所有引用该片段的主文档
+
+<!-- MANUAL: -->

package/docs/plans/AGENTS.md

@@ -0,0 +1,33 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/plans/
+
+## Purpose
+规划文档目录。存放功能开发的设计方案和实现计划，按日期命名，记录各版本功能的架构决策和实施路径。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `2025-11-22-opencode-support-design.md` | OpenCode 支持设计方案 |
+| `2025-11-22-opencode-support-implementation.md` | OpenCode 支持实现计划 |
+| `2025-11-28-skills-improvements-from-user-feedback.md` | 基于用户反馈的 skill 改进计划 |
+| `2026-01-17-visual-brainstorming.md` | 可视化头脑风暴功能设计 |
+| `2026-02-24-axiom-integration-design.md` | Axiom 集成设计方案 |
+| `2026-02-24-axiom-integration-plan.md` | Axiom 集成实现计划 |
+| `2026-02-24-superpowers-ultrapower-integration-design.md` | Superpowers-Ultrapower 集成设计 |
+| `2026-02-24-superpowers-ultrapower-integration-plan.md` | Superpowers-Ultrapower 集成计划 |
+| `2026-02-24-ultrapower-integration-design.md` | Ultrapower 集成设计方案 |
+| `2026-02-26-nexus-design.md` | Nexus 自我改进系统设计 |
+| `2026-02-26-nexus-implementation-plan.md` | Nexus 实现计划 |
+| `2026-02-26-phase2-active-learning-design.md` | 第二阶段主动学习设计 |
+| `axiom-migration-plan.md` | Axiom 迁移计划 |
+
+## For AI Agents
+
+### 修改此目录时
+- 规划文档是历史记录，通常不修改已有文档
+- 新功能规划使用日期前缀命名
+
+<!-- MANUAL: -->

package/docs/prd/AGENTS.md

@@ -0,0 +1,22 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/prd/
+
+## Purpose
+PRD（产品需求文档）目录。存放功能的产品需求文档草稿和终稿，记录功能的用户故事、验收标准和范围定义。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `ultrapower-standards-draft.md` | Ultrapower 规范体系 PRD 草稿 |
+| `ultrapower-standards-rough.md` | Ultrapower 规范体系 PRD 初稿 |
+
+## For AI Agents
+
+### 修改此目录时
+- PRD 是需求基准，实现必须符合 PRD 定义的验收标准
+- 参见 Axiom 工作流了解 PRD 生成流程
+
+<!-- MANUAL: -->

package/docs/reviews/AGENTS.md

@@ -0,0 +1,20 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/reviews/
+
+## Purpose
+代码审查文档目录。存放代码审查报告和审查结果，记录各功能模块的审查意见和改进建议。
+
+## Subdirectories
+
+| Directory | Purpose |
+|-----------|---------|
+| `ultrapower-standards/` | Ultrapower 规范体系审查报告 |
+
+## For AI Agents
+
+### 修改此目录时
+- 审查报告是历史记录，通常不修改
+
+<!-- MANUAL: -->

package/docs/reviews/ultrapower-standards/AGENTS.md

@@ -0,0 +1,30 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/reviews/ultrapower-standards/
+
+## Purpose
+Ultrapower 标准审查报告目录。包含对 ultrapower 标准规范的专家审查报告，涵盖批评者、领域专家、产品、技术和 UX 视角。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `review_critic.md` | 批评者视角审查报告 |
+| `review_domain.md` | 领域专家视角审查报告 |
+| `review_product.md` | 产品视角审查报告 |
+| `review_tech.md` | 技术视角审查报告 |
+| `review_ux.md` | UX 视角审查报告 |
+
+## For AI Agents
+
+### 修改此目录时
+- 参见父级目录了解整体结构
+- 遵循项目编码规范
+
+## Dependencies
+
+### Internal
+- `docs/standards/` — 相关模块
+
+<!-- MANUAL: -->

package/docs/shared/AGENTS.md

@@ -0,0 +1,24 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/partials/
+
+## Purpose
+文档片段目录。存放可复用的文档组件，包括 agent 层级说明、功能特性描述、模式层级和选择指南等，供主文档引用。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `agent-tiers.md` | Agent 层级（haiku/sonnet/opus）说明 |
+| `features.md` | 功能特性描述片段 |
+| `mode-hierarchy.md` | 执行模式层级关系说明 |
+| `mode-selection-guide.md` | 模式选择决策指南 |
+| `verification-tiers.md` | 验证层级说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 片段变更需检查所有引用该片段的主文档
+
+<!-- MANUAL: -->

package/docs/standards/AGENTS.md

@@ -0,0 +1,40 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/standards/
+
+## Purpose
+规范体系文档目录。包含 ultrapower 全链路开发规范，是所有实现必须遵守的权威参考文档，涵盖运行时保护、Hook 执行顺序、状态机、Agent 生命周期等核心规范。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `runtime-protection.md` | P0 — 路径遍历防护、Hook 输入消毒、状态文件权限 |
+| `hook-execution-order.md` | P0 — 15 类 HookType、路由规则、执行顺序 |
+| `state-machine.md` | P0 — Agent 状态机、Team Pipeline 转换矩阵 |
+| `agent-lifecycle.md` | P0 — 超时/孤儿/成本超限/死锁边界情况 |
+| `user-guide.md` | P1 — Skill 决策树、Agent 路由指南 |
+| `anti-patterns.md` | P1 — 已知反模式及正确替代方案 |
+| `contribution-guide.md` | P1 — 贡献流程、质量门禁、文档同步要求 |
+| `audit-report.md` | 安全审计报告 |
+| `README.md` | 规范体系概览 |
+
+## Subdirectories
+
+| Directory | Purpose |
+|-----------|---------|
+| `templates/` | 规范文档模板 |
+
+## For AI Agents
+
+### 重要规则
+- P0 文档是不可协商的安全规则，任何实现必须遵守
+- 修改规范文档前需经过 `code-reviewer` 审查
+
+## Dependencies
+
+### Internal
+- 被所有 `src/` 实现文件引用
+
+<!-- MANUAL: -->

package/docs/standards/templates/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/standards/templates/
+
+## Purpose
+标准文档模板目录。包含 agent、hook 和 skill 的标准文档模板，用于创建符合规范的新组件文档。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `agent-template.md` | Agent 文档模板 |
+| `hook-template.md` | Hook 文档模板 |
+| `skill-template.md` | Skill 文档模板 |
+
+## For AI Agents
+
+### 修改此目录时
+- 参见父级目录了解整体结构
+- 遵循项目编码规范
+
+## Dependencies
+
+### Internal
+- `docs/standards/` — 相关模块
+
+<!-- MANUAL: -->

package/docs/superpowers/AGENTS.md

@@ -0,0 +1,26 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/superpowers/
+
+## Purpose
+Superpowers skill 文档目录。存放 superpowers 系列 skill 的规划文档和规格说明，记录各 skill 的设计意图和实现规范。
+
+## Subdirectories
+
+| Directory | Purpose |
+|-----------|---------|
+| `plans/` | Skill 规划文档 |
+| `specs/` | Skill 规格说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 参见 `skills/` 目录了解实际 skill 实现
+
+## Dependencies
+
+### Internal
+- `skills/` — Skill 实现目录
+
+<!-- MANUAL: -->

package/docs/superpowers/plans/AGENTS.md

@@ -0,0 +1,26 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/superpowers/plans/
+
+## Purpose
+Superpowers 规划文档目录。包含 superpowers 功能的规划文档，记录功能设计和实现计划。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `*.md` | 规划文档文件 |
+
+## For AI Agents
+
+### 修改此目录时
+- 参见父级目录了解整体结构
+- 遵循项目编码规范
+
+## Dependencies
+
+### Internal
+- `docs/superpowers/` — 相关模块
+
+<!-- MANUAL: -->

package/docs/superpowers/specs/AGENTS.md

@@ -0,0 +1,26 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/superpowers/specs/
+
+## Purpose
+Superpowers 规格文档目录。包含 superpowers 功能的技术规格文档，定义接口和行为规范。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `*.md` | 规格文档文件 |
+
+## For AI Agents
+
+### 修改此目录时
+- 参见父级目录了解整体结构
+- 遵循项目编码规范
+
+## Dependencies
+
+### Internal
+- `docs/superpowers/` — 相关模块
+
+<!-- MANUAL: -->

package/docs/tasks/AGENTS.md

@@ -0,0 +1,20 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/tasks/
+
+## Purpose
+任务文档目录。存放开发任务的详细说明和追踪文档，记录各功能模块的任务分解和完成状态。
+
+## Subdirectories
+
+| Directory | Purpose |
+|-----------|---------|
+| `ultrapower-standards/` | Ultrapower 规范体系任务文档 |
+
+## For AI Agents
+
+### 修改此目录时
+- 任务文档完成后可归档
+
+<!-- MANUAL: -->

package/docs/tasks/ultrapower-standards/AGENTS.md

@@ -0,0 +1,27 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/tasks/ultrapower-standards/
+
+## Purpose
+Ultrapower 标准任务文档目录。包含 ultrapower 标准规范的任务追踪文档和 manifest 清单。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `manifest.md` | 任务 manifest 清单，定义标准规范的实施任务 |
+
+## For AI Agents
+
+### 修改此目录时
+- 参见父级目录了解整体结构
+- 遵循项目编码规范
+
+## Dependencies
+
+### Internal
+- `docs/tasks/` — 相关模块
+- `docs/standards/` — 相关模块
+
+<!-- MANUAL: -->

package/docs/windows/AGENTS.md

@@ -0,0 +1,25 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/windows/
+
+## Purpose
+Windows 平台专项文档目录。存放 Windows 环境下的特殊配置说明、已知问题和解决方案。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `polyglot-hooks.md` | Windows 多语言 hook 配置说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 参见 `src/platform/` 了解平台抽象层实现
+
+## Dependencies
+
+### Internal
+- `src/platform/` — 平台抽象层
+
+<!-- MANUAL: -->

package/hooks/AGENTS.md

@@ -0,0 +1,33 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# hooks/
+
+## Purpose
+已安装的 hook 运行时目录。存放实际部署到当前项目的 hook 配置和脚本，是 `templates/hooks/` 模板安装后的实例，由 `omc install` 生成。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `hooks.json` | Hook 注册配置，定义各事件对应的 hook 脚本 |
+| `run-hook.cmd` | Windows 平台 hook 执行入口脚本 |
+
+## Subdirectories
+
+| Directory | Purpose |
+|-----------|---------|
+| `session-start/` | 会话启动 hook 脚本 |
+
+## For AI Agents
+
+### 修改此目录时
+- 此目录是运行时文件，通常由安装程序管理，不手动编辑
+- 参见 `templates/hooks/` 了解模板源文件
+
+## Dependencies
+
+### Internal
+- `templates/hooks/` — Hook 脚本模板
+
+<!-- MANUAL: -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liangjie559567/ultrapower",
-  "version": "5.2.2",
+  "version": "5.2.4",
   "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
   "type": "module",
   "main": "dist/index.js",

package/scripts/AGENTS.md

@@ -0,0 +1,66 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# scripts/
+
+## Purpose
+包含构建脚本、工具和自动化脚本。分为两类：构建产物生成脚本（`build-*.mjs`）和运行时辅助脚本（hook 处理、会话管理等）。
+
+## Key Files
+
+| 文件 | 描述 |
+|------|------|
+| `build-mcp-server.mjs` | 构建主 MCP 工具服务器 → `bridge/mcp-server.cjs` |
+| `build-codex-server.mjs` | 构建 Codex MCP 代理 → `bridge/codex-server.cjs` |
+| `build-gemini-server.mjs` | 构建 Gemini MCP 代理 → `bridge/gemini-server.cjs` |
+| `build-bridge-entry.mjs` | 构建 Team 桥接入口 → `bridge/team-bridge.cjs` |
+| `build-skill-bridge.mjs` | 构建 skill 桥接层 |
+| `session-start.mjs` | 会话启动 hook 脚本 |
+| `session-end.mjs` | 会话结束 hook 脚本 |
+| `setup-init.mjs` | 初始化安装脚本 |
+| `setup-maintenance.mjs` | 维护和升级脚本 |
+| `sync-metadata.ts` | 同步 agent/skill 元数据 |
+| `skill-injector.mjs` | Skill 注入处理器 |
+| `plugin-setup.mjs` | 插件配置脚本 |
+| `pre-compact.mjs` | 上下文压缩前处理 |
+| `compose-docs.mjs` | 文档合成脚本 |
+| `uninstall.sh` | 卸载脚本 |
+
+## Subdirectories
+
+| 目录 | 用途 |
+|------|------|
+| `hooks/` | Hook 事件处理脚本 |
+| `lib/` | 脚本共享工具库 |
+
+## For AI Agents
+
+### 构建流程
+```bash
+npm run build          # 运行所有构建脚本
+npm run sync-metadata  # 同步 agent/skill 元数据
+```
+
+### 修改此目录时
+- 构建脚本修改后需运行 `npm run build` 验证
+- `session-start.mjs` 和 `session-end.mjs` 是 Claude Code hook 的入口点
+- `sync-metadata.ts` 在 agent 或 skill 数量变化时需要运行
+
+### Hook 脚本规范
+- Hook 脚本从 stdin 读取 JSON 输入
+- 输出到 stdout（JSON 格式）
+- 错误输出到 stderr
+- 退出码：0=成功，非0=失败
+
+## Dependencies
+
+### Internal
+- `src/mcp/` — MCP 服务器源码（构建目标）
+- `src/hooks/` — Hook 实现（被 hook 脚本调用）
+- `bridge/` — 构建产物输出目录
+
+### External
+- `esbuild` — 打包工具
+- `typescript` — TypeScript 编译
+
+<!-- MANUAL: -->

package/scripts/hooks/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# scripts/hooks/
+
+## Purpose
+脚本层 hook 文件目录。包含 Git hook 脚本（pre-commit、post-commit）和 OMC hook 安装脚本，用于在开发工作流中自动触发 OMC 功能。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `install-hooks.sh` | 安装所有 Git hooks 的脚本 |
+| `pre-commit.sh` | Git pre-commit hook，触发代码检查 |
+| `post-commit.sh` | Git post-commit hook，触发提交后操作 |
+
+## For AI Agents
+
+### 修改此目录时
+- Hook 脚本变更需在 Unix 和 Windows 环境中测试
+- 参见 `src/hooks/` 了解 TypeScript hook 实现
+
+## Dependencies
+
+### Internal
+- `scripts/lib/` — 脚本共享工具库
+
+<!-- MANUAL: -->

package/scripts/lib/AGENTS.md

@@ -0,0 +1,25 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# scripts/lib/
+
+## Purpose
+脚本共享工具库。提供脚本层公共工具函数，目前包含标准输入处理模块，供各构建和 hook 脚本复用。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `stdin.mjs` | 标准输入读取工具，用于脚本间数据传递 |
+
+## For AI Agents
+
+### 修改此目录时
+- 工具函数变更需检查所有引用脚本
+
+## Dependencies
+
+### Internal
+- `scripts/` — 父级脚本目录
+
+<!-- MANUAL: -->

package/skills/AGENTS.md

@@ -0,0 +1,37 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/
+
+## Purpose
+Skill 定义目录。存放所有 71 个 OMC skill 的 Markdown 定义文件，每个 skill 包含触发条件、执行工作流和使用说明。Skill 是用户可调用的高级命令，通过 `/ultrapower:<name>` 语法触发。
+
+## Subdirectories
+
+| Directory | Purpose |
+|-----------|---------|
+| `autopilot/` | 全自主执行 skill |
+| `ralph/` | 自引用循环执行 skill |
+| `ultrawork/` | 并行执行引擎 skill |
+| `team/` | 多 agent 协调 skill |
+| `plan/` | 战略规划 skill |
+| `pipeline/` | 顺序 agent 链 skill |
+| `ax-*/` | Axiom 工作流系列 skill（14 个） |
+| `deepinit/` | 代码库初始化 skill |
+| `brainstorming/` | 头脑风暴 skill |
+| *(其余 50+ 个 skill 目录)* | 各专业 skill 定义 |
+
+## For AI Agents
+
+### 修改此目录时
+- 新增 skill 需同步更新 `src/skills/` 中的 TypeScript 注册
+- Skill 触发关键词变更需更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/analyze/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/analyze/
+
+## Purpose
+深度分析与调试 skill。触发 debugger agent 进行根因分析、回归隔离和故障诊断。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/autopilot/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/autopilot/
+
+## Purpose
+全自主执行 skill。从想法到可运行代码的端到端自主执行，支持转换为 ralph 或 ultraqa 模式。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/ax-analyze-error/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-analyze-error/
+
+## Purpose
+Axiom 错误分析工作流 skill。执行根因诊断 → 自动修复 → 知识入队的完整错误处理流程。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->