@liangjie559567/ultrapower 5.2.3 → 5.2.4

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.3",
+  "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: -->

package/skills/ax-context/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-context/
+
+## 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: -->

package/skills/ax-decompose/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-decompose/
+
+## Purpose
+Axiom 任务拆解工作流 skill。将 Rough PRD 转化为系统架构 → 原子任务 DAG → Manifest 清单。
+
+## 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-draft/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-draft/
+
+## Purpose
+Axiom 需求起草工作流 skill。执行需求澄清循环 → PRD 初稿生成 → 用户评审门禁流程。
+
+## 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-evolution/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-evolution/
+
+## 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: -->

package/skills/ax-evolve/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-evolve/
+
+## 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: -->

package/skills/ax-export/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-export/
+
+## Purpose
+Axiom 系统导出 skill。将 Axiom 配置打包为可移植 zip，支持模板模式和完整模式。
+
+## 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-implement/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-implement/
+
+## Purpose
+Axiom 实施交付工作流 skill。按 Manifest 顺序执行原子任务，含 CI 门禁和自动修复循环。
+
+## 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-knowledge/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-knowledge/
+
+## 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: -->