@liangjie559567/ultrapower 5.0.4

package/skills/deepinit/SKILL.md

@@ -0,0 +1,363 @@
+---
+name: deepinit
+description: 深度代码库初始化，生成层级化 AGENTS.md 文档
+---
+
+# Deep Init Skill
+
+在整个代码库中创建全面的层级化 AGENTS.md 文档。
+
+## 核心概念
+
+AGENTS.md 文件作为 **AI 可读文档**，帮助 agent 理解：
+- 每个目录包含什么
+- 组件之间如何关联
+- 在该区域工作的特殊说明
+- 依赖关系
+
+## 层级标签系统
+
+每个 AGENTS.md（根目录除外）都包含父级引用标签：
+
+```markdown
+<!-- Parent: ../AGENTS.md -->
+```
+
+This creates a navigable hierarchy:
+```
+/AGENTS.md                          ← Root (no parent tag)
+├── src/AGENTS.md                   ← <!-- Parent: ../AGENTS.md -->
+│   ├── src/components/AGENTS.md    ← <!-- Parent: ../AGENTS.md -->
+│   └── src/utils/AGENTS.md         ← <!-- Parent: ../AGENTS.md -->
+└── docs/AGENTS.md                  ← <!-- Parent: ../AGENTS.md -->
+```
+
+## AGENTS.md 模板
+
+```markdown
+<!-- Parent: {relative_path_to_parent}/AGENTS.md -->
+<!-- Generated: {timestamp} | Updated: {timestamp} -->
+
+# {Directory Name}
+
+## Purpose
+{One-paragraph description of what this directory contains and its role}
+
+## Key Files
+{List each significant file with a one-line description}
+
+| File | Description |
+|------|-------------|
+| `file.ts` | Brief description of purpose |
+
+## Subdirectories
+{List each subdirectory with brief purpose}
+
+| Directory | Purpose |
+|-----------|---------|
+| `subdir/` | What it contains (see `subdir/AGENTS.md`) |
+
+## For AI Agents
+
+### Working In This Directory
+{Special instructions for AI agents modifying files here}
+
+### Testing Requirements
+{How to test changes in this directory}
+
+### Common Patterns
+{Code patterns or conventions used here}
+
+## Dependencies
+
+### Internal
+{References to other parts of the codebase this depends on}
+
+### External
+{Key external packages/libraries used}
+
+<!-- MANUAL: Any manually added notes below this line are preserved on regeneration -->
+```
+
+## 执行工作流
+
+### 步骤 1：映射目录结构
+
+```
+Task(subagent_type="explore", model="haiku",
+  prompt="List all directories recursively. Exclude: node_modules, .git, dist, build, __pycache__, .venv, coverage, .next, .nuxt")
+```
+
+### 步骤 2：创建工作计划
+
+为每个目录生成待办事项，按深度级别组织：
+
+```
+Level 0: / (root)
+Level 1: /src, /docs, /tests
+Level 2: /src/components, /src/utils, /docs/api
+...
+```
+
+### 步骤 3：逐级生成
+
+**重要**：先生成父级，再生成子级，确保父级引用有效。
+
+对每个目录：
+1. 读取目录中的所有文件
+2. 分析用途和关系
+3. 生成 AGENTS.md 内容
+4. 写入文件并附上正确的父级引用
+
+### 步骤 4：比较并更新（若已存在）
+
+当 AGENTS.md 已存在时：
+
+1. **读取现有内容**
+2. **识别各节**：
+   - 自动生成的节（可更新）
+   - 手动节（`<!-- MANUAL -->` 保留）
+3. **比较**：
+   - 新增了文件？
+   - 删除了文件？
+   - 结构发生变化？
+4. **合并**：
+   - 更新自动生成的内容
+   - 保留手动注释
+   - 更新时间戳
+
+### 步骤 5：验证层级
+
+生成后，运行验证检查：
+
+| 检查项 | 验证方式 | 纠正措施 |
+|-------|--------------|-------------------|
+| 父级引用可解析 | 读取每个 AGENTS.md，检查 `<!-- Parent: -->` 路径是否存在 | 修复路径或删除孤立文件 |
+| 无孤立 AGENTS.md | 对比 AGENTS.md 位置与目录结构 | 删除孤立文件 |
+| 完整性 | 列出所有目录，检查是否有 AGENTS.md | 生成缺失文件 |
+| 时间戳最新 | 检查 `<!-- Generated: -->` 日期 | 重新生成过期文件 |
+
+验证脚本模式：
+```bash
+# Find all AGENTS.md files
+find . -name "AGENTS.md" -type f
+
+# Check parent references
+grep -r "<!-- Parent:" --include="AGENTS.md" .
+```
+
+## 智能委托
+
+| 任务 | Agent |
+|------|-------|
+| 目录映射 | `explore` |
+| 文件分析 | `architect-low` |
+| 内容生成 | `writer` |
+| AGENTS.md 写入 | `writer` |
+
+## 空目录处理
+
+遇到空目录或近空目录时：
+
+| 条件 | 操作 |
+|-----------|--------|
+| 无文件，无子目录 | **跳过** —— 不创建 AGENTS.md |
+| 无文件，有子目录 | 创建仅含子目录列表的最小 AGENTS.md |
+| 仅有生成文件（*.min.js、*.map） | 跳过或创建最小 AGENTS.md |
+| 仅有配置文件 | 创建描述配置用途的 AGENTS.md |
+
+仅含目录的容器的最小 AGENTS.md 示例：
+```markdown
+<!-- Parent: ../AGENTS.md -->
+# {Directory Name}
+
+## Purpose
+Container directory for organizing related modules.
+
+## Subdirectories
+| Directory | Purpose |
+|-----------|---------|
+| `subdir/` | Description (see `subdir/AGENTS.md`) |
+```
+
+## 并行化规则
+
+1. **同级目录**：并行处理
+2. **不同级别**：顺序处理（父级优先）
+3. **大型目录**：为每个目录派生专用 agent
+4. **小型目录**：将多个目录批量交给一个 agent
+
+## 质量标准
+
+### 必须包含
+- [ ] 准确的文件描述
+- [ ] 正确的父级引用
+- [ ] 子目录链接
+- [ ] AI agent 说明
+
+### 必须避免
+- [ ] 通用样板内容
+- [ ] 错误的文件名
+- [ ] 损坏的父级引用
+- [ ] 遗漏重要文件
+
+## 示例输出
+
+### 根目录 AGENTS.md
+```markdown
+<!-- Generated: 2024-01-15 | Updated: 2024-01-15 -->
+
+# my-project
+
+## Purpose
+A web application for managing user tasks with real-time collaboration features.
+
+## Key Files
+| File | Description |
+|------|-------------|
+| `package.json` | Project dependencies and scripts |
+| `tsconfig.json` | TypeScript configuration |
+| `.env.example` | Environment variable template |
+
+## Subdirectories
+| Directory | Purpose |
+|-----------|---------|
+| `src/` | Application source code (see `src/AGENTS.md`) |
+| `docs/` | Documentation (see `docs/AGENTS.md`) |
+| `tests/` | Test suites (see `tests/AGENTS.md`) |
+
+## For AI Agents
+
+### Working In This Directory
+- Always install dependencies after modifying the project manifest
+- Use TypeScript strict mode
+- Follow ESLint rules
+
+### Testing Requirements
+- Run tests before committing
+- Ensure >80% coverage
+
+### Common Patterns
+- Use barrel exports (index.ts)
+- Prefer functional components
+
+## Dependencies
+
+### External
+- React 18.x - UI framework
+- TypeScript 5.x - Type safety
+- Vite - Build tool
+
+<!-- MANUAL: Custom project notes can be added below -->
+```
+
+### 嵌套 AGENTS.md
+```markdown
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2024-01-15 | Updated: 2024-01-15 -->
+
+# components
+
+## Purpose
+Reusable React components organized by feature and complexity.
+
+## Key Files
+| File | Description |
+|------|-------------|
+| `index.ts` | Barrel export for all components |
+| `Button.tsx` | Primary button component |
+| `Modal.tsx` | Modal dialog component |
+
+## Subdirectories
+| Directory | Purpose |
+|-----------|---------|
+| `forms/` | Form-related components (see `forms/AGENTS.md`) |
+| `layout/` | Layout components (see `layout/AGENTS.md`) |
+
+## For AI Agents
+
+### Working In This Directory
+- Each component has its own file
+- Use CSS modules for styling
+- Export via index.ts
+
+### Testing Requirements
+- Unit tests in `__tests__/` subdirectory
+- Use React Testing Library
+
+### Common Patterns
+- Props interfaces defined above component
+- Use forwardRef for DOM-exposing components
+
+## Dependencies
+
+### Internal
+- `src/hooks/` - Custom hooks used by components
+- `src/utils/` - Utility functions
+
+### External
+- `clsx` - Conditional class names
+- `lucide-react` - Icons
+
+<!-- MANUAL: -->
+```
+
+## 触发更新模式
+
+在已有 AGENTS.md 文件的代码库上运行时：
+
+1. 先检测现有文件
+2. 读取并解析现有内容
+3. 分析当前目录状态
+4. 生成现有内容与当前状态的差异
+5. 应用更新，同时保留手动节
+
+## 性能注意事项
+
+- **缓存目录列表** —— 不重复扫描相同目录
+- **批量处理小目录** —— 一次处理多个
+- **跳过未变更的** —— 若目录未变化，跳过重新生成
+- **并行写入** —— 多个 agent 同时写入不同文件
+
+## 路由触发
+
+层级化 AGENTS.md 文档生成完成后调用 `next-step-router`：
+- current_skill: "deepinit"
+- stage: "agents_md_generated"
+- output_summary: 生成的 AGENTS.md 文件数、覆盖的目录层级数
+
+## Axiom 环境初始化流程（增强）
+
+当需要为新项目或新环境初始化 AI 工具配置时，执行以下步骤：
+
+### 环境检测
+
+读取 `.omc/axiom/active_context.md`（若存在）：
+- **IF PENDING tasks**：输出 "检测到未完成任务 [Task-ID]。是否恢复？"
+- **IF IDLE**：输出 "系统就绪。请告知下一步。"
+
+### 5 AI 工具配置安装
+
+按顺序为以下工具生成配置文件：
+
+| 工具 | 配置路径 | 内容 |
+|------|---------|------|
+| Claude Code | `.claude/CLAUDE.md` | 项目规范、分支策略 |
+| Codex | `.codex/AGENTS.md` | 后端任务指引 |
+| Gemini | `.gemini/GEMINI.md` | 前端/设计任务指引 |
+| Kiro | `.kiro/steering/project.md` | 项目上下文 |
+| OpenCode | `.opencode/AGENTS.md` | 通用 agent 指引 |
+
+### 备份与安装
+
+1. **备份现有配置**：将现有文件移至 `[path].backup.[timestamp]`
+2. **生成新配置**：基于项目结构和 AGENTS.md 内容生成
+3. **验证安装**：检查所有配置文件是否存在且格式正确
+
+### Silent Boot 协议
+
+Agent 启动时自动执行：
+1. 读取 `.omc/axiom/active_context.md` 检查待处理任务
+2. 若有 PENDING 任务 → 提示恢复
+3. 若 IDLE → 等待用户指令
+4. 环境检查（如 `tsc --noEmit` 验证构建状态）

package/skills/deepsearch/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: deepsearch
+description: 全面的代码库搜索
+---
+
+# 深度搜索模式
+
+[深度搜索模式已激活]
+
+## 目标
+
+对代码库中指定的查询、模式或概念进行全面搜索。
+
+## 搜索策略
+
+1. **广泛搜索**
+   - 搜索精确匹配
+   - 搜索相关术语和变体
+   - 检查常见位置（components、utils、services、hooks）
+
+2. **深入挖掘**
+   - 读取有匹配的文件
+   - 检查 imports/exports 以找到关联
+   - 追踪线索（谁导入了这个？这个导入了什么？）
+
+3. **综合分析**
+   - 梳理概念的使用位置
+   - 识别主要实现
+   - 记录相关功能
+
+## 输出格式
+
+- **主要位置**（主要实现）
+- **相关文件**（依赖项、消费者）
+- **使用模式**（在代码库中的使用方式）
+- **关键洞察**（模式、约定、注意事项）
+
+力求全面而简洁。引用文件路径和行号。

package/skills/dispatching-parallel-agents/SKILL.md

@@ -0,0 +1,187 @@
+---
+name: dispatching-parallel-agents
+description: 当面临 2 个以上可并行处理、无共享状态或顺序依赖的独立任务时使用
+---
+
+# 分发并行 Agent
+
+## 概述
+
+当存在多个不相关的故障（不同测试文件、不同子系统、不同 bug）时，逐一排查会浪费时间。每项排查都是独立的，可以并行进行。
+
+**核心原则：** 每个独立问题域分发一个 agent，让它们并发工作。
+
+## 使用时机
+
+```dot
+digraph when_to_use {
+    "Multiple failures?" [shape=diamond];
+    "Are they independent?" [shape=diamond];
+    "Single agent investigates all" [shape=box];
+    "One agent per problem domain" [shape=box];
+    "Can they work in parallel?" [shape=diamond];
+    "Sequential agents" [shape=box];
+    "Parallel dispatch" [shape=box];
+
+    "Multiple failures?" -> "Are they independent?" [label="yes"];
+    "Are they independent?" -> "Single agent investigates all" [label="no - related"];
+    "Are they independent?" -> "Can they work in parallel?" [label="yes"];
+    "Can they work in parallel?" -> "Parallel dispatch" [label="yes"];
+    "Can they work in parallel?" -> "Sequential agents" [label="no - shared state"];
+}
+```
+
+**适用场景：**
+- 3 个以上测试文件因不同根因失败
+- 多个子系统独立损坏
+- 每个问题无需其他问题的上下文即可理解
+- 排查之间无共享状态
+
+**不适用场景：**
+- 故障相互关联（修复一个可能修复其他）
+- 需要了解完整系统状态
+- Agent 之间会相互干扰
+
+## 模式
+
+### 1. 识别独立域
+
+按损坏内容对故障分组：
+- 文件 A 测试：Tool approval 流程
+- 文件 B 测试：Batch completion 行为
+- 文件 C 测试：Abort 功能
+
+每个域是独立的——修复 tool approval 不影响 abort 测试。
+
+### 2. 创建专注的 Agent 任务
+
+每个 agent 获得：
+- **具体范围：** 一个测试文件或子系统
+- **明确目标：** 使这些测试通过
+- **约束条件：** 不修改其他代码
+- **预期输出：** 发现和修复内容的摘要
+
+### 3. 并行分发
+
+```typescript
+// In Claude Code / AI environment
+Task("Fix agent-tool-abort.test.ts failures")
+Task("Fix batch-completion-behavior.test.ts failures")
+Task("Fix tool-approval-race-conditions.test.ts failures")
+// All three run concurrently
+```
+
+### 4. 审查并整合
+
+Agent 返回后：
+- 阅读每份摘要
+- 验证修复不冲突
+- 运行完整测试套件
+- 整合所有变更
+
+## Agent 提示结构
+
+好的 agent 提示应：
+1. **专注** —— 一个明确的问题域
+2. **自包含** —— 包含理解问题所需的所有上下文
+3. **明确输出** —— agent 应返回什么？
+
+```markdown
+Fix the 3 failing tests in src/agents/agent-tool-abort.test.ts:
+
+1. "should abort tool with partial output capture" - expects 'interrupted at' in message
+2. "should handle mixed completed and aborted tools" - fast tool aborted instead of completed
+3. "should properly track pendingToolCount" - expects 3 results but gets 0
+
+These are timing/race condition issues. Your task:
+
+1. Read the test file and understand what each test verifies
+2. Identify root cause - timing issues or actual bugs?
+3. Fix by:
+   - Replacing arbitrary timeouts with event-based waiting
+   - Fixing bugs in abort implementation if found
+   - Adjusting test expectations if testing changed behavior
+
+Do NOT just increase timeouts - find the real issue.
+
+Return: Summary of what you found and what you fixed.
+```
+
+## 常见错误
+
+**❌ 过于宽泛：** "修复所有测试" —— agent 会迷失方向
+**✅ 具体：** "修复 agent-tool-abort.test.ts" —— 范围明确
+
+**❌ 无上下文：** "修复竞态条件" —— agent 不知道在哪里
+**✅ 有上下文：** 粘贴错误信息和测试名称
+
+**❌ 无约束：** Agent 可能重构所有内容
+**✅ 有约束：** "不修改生产代码" 或 "仅修复测试"
+
+**❌ 模糊输出：** "修复它" —— 你不知道改了什么
+**✅ 具体：** "返回根因和变更摘要"
+
+## 不适用场景
+
+**相关故障：** 修复一个可能修复其他 —— 先一起排查
+**需要完整上下文：** 理解需要查看整个系统
+**探索性调试：** 你还不知道什么损坏了
+**共享状态：** Agent 会相互干扰（编辑相同文件、使用相同资源）
+
+## 实际案例
+
+**场景：** 大规模重构后 3 个文件中出现 6 个测试失败
+
+**失败情况：**
+- agent-tool-abort.test.ts：3 个失败（时序问题）
+- batch-completion-behavior.test.ts：2 个失败（tool 未执行）
+- tool-approval-race-conditions.test.ts：1 个失败（执行次数 = 0）
+
+**决策：** 独立域 —— abort 逻辑与 batch completion 与竞态条件各自独立
+
+**分发：**
+```
+Agent 1 → 修复 agent-tool-abort.test.ts
+Agent 2 → 修复 batch-completion-behavior.test.ts
+Agent 3 → 修复 tool-approval-race-conditions.test.ts
+```
+
+**结果：**
+- Agent 1：用基于事件的等待替换超时
+- Agent 2：修复事件结构 bug（threadId 位置错误）
+- Agent 3：添加等待异步 tool 执行完成
+
+**整合：** 所有修复独立，无冲突，完整套件通过
+
+**节省时间：** 3 个问题并行解决，而非顺序解决
+
+## 主要优势
+
+1. **并行化** —— 多项排查同时进行
+2. **专注** —— 每个 agent 范围窄，需跟踪的上下文少
+3. **独立性** —— Agent 互不干扰
+4. **速度** —— 1 个时间单位内解决 3 个问题
+
+## 验证
+
+Agent 返回后：
+1. **审查每份摘要** —— 了解变更内容
+2. **检查冲突** —— Agent 是否编辑了相同代码？
+3. **运行完整套件** —— 验证所有修复协同工作
+4. **抽查** —— Agent 可能犯系统性错误
+
+## 实际影响
+
+来自调试会话（2025-10-03）：
+- 3 个文件中 6 个失败
+- 3 个 agent 并行分发
+- 所有排查并发完成
+- 所有修复成功整合
+- Agent 变更之间零冲突
+
+## 路由触发
+
+所有并行 agent 结果汇聚后调用 `next-step-router`：
+- current_skill: "dispatching-parallel-agents"
+- stage: "all_results_returned"
+- output_summary: agent 数量、成功/失败数、汇总结果