@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/tasks/user_guide/manifest.md

@@ -57,47 +57,64 @@ graph TD
 ### Phase 0: 事实修正（P0 - 阻塞所有后续任务）
 
 #### T-001: 修正 4 个 P0 事实错误
-- **描述**: 修正 Domain Expert 指出的事实性错误
-- **交付物**:
+
+* **描述**: 修正 Domain Expert 指出的事实性错误
+
+* **交付物**:
   - `docs/REFERENCE.md`: Skills 数量 71→70
   - `docs/REFERENCE.md`: Domain Experts 数量 15→16（新增协调 2 个）
   - `README.md`: 修正安装步骤（插件命令）
   - `docs/REFERENCE.md`: 补充 MCP 集成和 Axiom 系统说明
-- **验收标准**:
+
+* **验收标准**:
   - [ ] Skills 数量准确（70 个）
   - [ ] Domain Experts 分类准确（15 个领域专家 + 2 个协调）
   - [ ] 安装步骤可执行（经过测试）
   - [ ] MCP 和 Axiom 功能完整描述
-- **预估工时**: 2-3 小时
-- **依赖**: 无
-- **阻塞**: T-002, T-003（所有后续任务）
-- **优先级**: P0
+
+* **预估工时**: 2-3 小时
+
+* **依赖**: 无
+
+* **阻塞**: T-002, T-003（所有后续任务）
+
+* **优先级**: P0
 
 ---
 
 ### Phase 1: 快速开始（P0）
 
 #### T-002: 更新 README.md 快速开始部分
-- **描述**: 添加 10 分钟快速上手指南
-- **交付物**:
+
+* **描述**: 添加 10 分钟快速上手指南
+
+* **交付物**:
   - `README.md`: 新增"快速开始"章节
   - 包含：前置检查、两种安装方式、验证、第一个示例
-- **验收标准**:
+
+* **验收标准**:
   - [ ] 新用户可在 10 分钟内完成安装
   - [ ] 包含前置检查（Node.js >= 18, Claude Code >= v1.0.0）
   - [ ] 两种安装方式（插件 + npm）
   - [ ] 包含验证命令（/ultrapower:omc-doctor）
   - [ ] 链接到故障排查文档
-- **预估工时**: 2 小时
-- **依赖**: T-001
-- **阻塞**: T-004
-- **优先级**: P0
+
+* **预估工时**: 2 小时
+
+* **依赖**: T-001
+
+* **阻塞**: T-004
+
+* **优先级**: P0
 
 #### T-003: 创建 USER_GUIDE.md 文档框架
-- **描述**: 创建完整用户手册的目录结构
-- **交付物**:
+
+* **描述**: 创建完整用户手册的目录结构
+
+* **交付物**:
   - `docs/USER_GUIDE.md`: 包含所有章节标题和占位符
-- **章节**:
+
+* **章节**:
   1. 简介
   2. 安装与配置
   3. 核心概念（Agent vs Skill vs Hook vs Tool）
@@ -108,188 +125,254 @@ graph TD
   8. 故障排查
   9. FAQ
   10. 版本更新指南
-- **验收标准**:
+
+* **验收标准**:
   - [ ] 目录结构完整
   - [ ] 每个章节有简短说明
   - [ ] 链接到相关文档（REFERENCE.md、CLAUDE.md）
-- **预估工时**: 1 小时
-- **依赖**: T-001
-- **阻塞**: T-005
-- **优先级**: P0
+
+* **预估工时**: 1 小时
+
+* **依赖**: T-001
+
+* **阻塞**: T-005
+
+* **优先级**: P0
 
 #### T-004: 编写快速开始指南
-- **描述**: 在 USER_GUIDE.md 中编写详细的快速开始章节
-- **交付物**:
+
+* **描述**: 在 USER_GUIDE.md 中编写详细的快速开始章节
+
+* **交付物**:
   - `docs/USER_GUIDE.md`: 第 4 章完整内容
-- **内容**:
+
+* **内容**:
   - 前置条件检查清单
   - 详细安装步骤（两种方式）
   - 第一个示例（autopilot 模式）
   - 常见安装问题
-- **验收标准**:
+
+* **验收标准**:
   - [ ] 包含前置检查清单
   - [ ] 安装步骤可执行
   - [ ] 示例代码可运行
   - [ ] 覆盖 3 个最常见安装问题
-- **预估工时**: 2 小时
-- **依赖**: T-002, T-003
-- **阻塞**: T-007
-- **优先级**: P0
+
+* **预估工时**: 2 小时
+
+* **依赖**: T-002, T-003
+
+* **阻塞**: T-007
+
+* **优先级**: P0
 
 ---
 
 ### Phase 2: 核心功能文档（P1）
 
 #### T-005: 编写核心功能文档
-- **描述**: 在 USER_GUIDE.md 中编写核心功能章节
-- **交付物**:
+
+* **描述**: 在 USER_GUIDE.md 中编写核心功能章节
+
+* **交付物**:
   - `docs/USER_GUIDE.md`: 第 5 章完整内容
-- **内容**:
+
+* **内容**:
   - Agent 编排模式（Team/autopilot/ralph/ultrawork）
   - Team 流水线（team-plan → team-prd → team-exec → team-verify → team-fix）
   - 核心 agents 使用指南（executor/debugger/verifier）
   - Hook 系统配置
   - MCP 集成指南
   - Axiom 自我进化系统说明
-- **验收标准**:
+
+* **验收标准**:
   - [ ] 覆盖 4 种执行模式
   - [ ] 每种模式包含代码示例
   - [ ] 包含决策树（何时用哪种模式）
   - [ ] Hook 配置示例可运行
   - [ ] MCP 和 Axiom 功能完整说明
-- **预估工时**: 4 小时
-- **依赖**: T-003
-- **阻塞**: T-006
-- **优先级**: P1
+
+* **预估工时**: 4 小时
+
+* **依赖**: T-003
+
+* **阻塞**: T-006
+
+* **优先级**: P1
 
 ---
 
 ### Phase 3: 进阶功能文档（P1）
 
 #### T-006: 编写进阶功能文档
-- **描述**: 在 USER_GUIDE.md 中编写进阶功能章节
-- **交付物**:
+
+* **描述**: 在 USER_GUIDE.md 中编写进阶功能章节
+
+* **交付物**:
   - `docs/USER_GUIDE.md`: 第 6 章完整内容
-- **内容**:
+
+* **内容**:
   - 完整 agent 参考（50 agents）
   - 完整 skill 参考（70 skills）
   - Hook 类型参考（15 types）
   - 自定义扩展指南
-- **验收标准**:
+
+* **验收标准**:
   - [ ] 覆盖所有 50 agents（每个有使用示例）
   - [ ] 覆盖所有 70 skills（每个有触发条件）
   - [ ] 覆盖所有 15 hook types（每个有配置示例）
   - [ ] 包含自定义 agent 创建指南
-- **预估工时**: 6 小时
-- **依赖**: T-005
-- **阻塞**: T-007
-- **优先级**: P1
+
+* **预估工时**: 6 小时
+
+* **依赖**: T-005
+
+* **阻塞**: T-007
+
+* **优先级**: P1
 
 ---
 
 ### Phase 4: 补充文档（P2）
 
 #### T-007: 创建静态教程
-- **描述**: 创建交互式教程文档
-- **交付物**:
+
+* **描述**: 创建交互式教程文档
+
+* **交付物**:
   - `docs/TUTORIAL.md`: 5 个场景脚本
-- **场景**:
+
+* **场景**:
   1. 环境验证与配置
   2. 使用第一个 agent（executor）
   3. 创建自定义 skill
   4. 配置 hook 自动化
   5. 团队协作模式（team）
-- **验收标准**:
+
+* **验收标准**:
   - [ ] 5 个场景全部可执行
   - [ ] 每个场景有代码示例和预期输出
   - [ ] 教程可独立运行（无需外部依赖）
-- **预估工时**: 4 小时
-- **依赖**: T-004, T-006
-- **阻塞**: T-008
-- **优先级**: P2
+
+* **预估工时**: 4 小时
+
+* **依赖**: T-004, T-006
+
+* **阻塞**: T-008
+
+* **优先级**: P2
 
 #### T-008: 添加故障排查指南
-- **描述**: 在 USER_GUIDE.md 中编写故障排查章节
-- **交付物**:
+
+* **描述**: 在 USER_GUIDE.md 中编写故障排查章节
+
+* **交付物**:
   - `docs/USER_GUIDE.md`: 第 8 章完整内容
   - `docs/TROUBLESHOOTING.md`: 独立故障排查文档
-- **内容**:
+
+* **内容**:
   - 常见错误代码和解决方案
   - 日志查看指南
   - 调试工具使用说明
   - 概念澄清（Agent vs Skill）
-- **验收标准**:
+
+* **验收标准**:
   - [ ] 覆盖 10 个最常见错误
   - [ ] 每个错误有症状、原因、解决方案
   - [ ] 包含日志查看命令
   - [ ] 包含概念关系图
-- **预估工时**: 2 小时
-- **依赖**: T-007
-- **阻塞**: T-009
-- **优先级**: P2
+
+* **预估工时**: 2 小时
+
+* **依赖**: T-007
+
+* **阻塞**: T-009
+
+* **优先级**: P2
 
 #### T-009: 添加 FAQ
-- **描述**: 在 USER_GUIDE.md 中编写 FAQ 章节
-- **交付物**:
+
+* **描述**: 在 USER_GUIDE.md 中编写 FAQ 章节
+
+* **交付物**:
   - `docs/USER_GUIDE.md`: 第 9 章完整内容
   - `docs/FAQ.md`: 独立 FAQ 文档
-- **内容**:
+
+* **内容**:
   - 安装问题（5 个）
   - 使用问题（10 个）
   - 配置问题（5 个）
   - 性能问题（3 个）
-- **验收标准**:
+
+* **验收标准**:
   - [ ] 覆盖 23 个常见问题
   - [ ] 每个问题有简洁答案
   - [ ] 链接到详细文档
-- **预估工时**: 2 小时
-- **依赖**: T-008
-- **阻塞**: T-010
-- **优先级**: P2
+
+* **预估工时**: 2 小时
+
+* **依赖**: T-008
+
+* **阻塞**: T-010
+
+* **优先级**: P2
 
 ---
 
 ### Phase 5: 验证与发布（P0）
 
 #### T-010: 文档验证
-- **描述**: 验证所有文档的准确性和完整性
-- **交付物**:
+
+* **描述**: 验证所有文档的准确性和完整性
+
+* **交付物**:
   - 验证报告
   - 修复清单
-- **验证项**:
+
+* **验证项**:
   - [ ] 所有代码示例可运行
   - [ ] 所有链接有效
   - [ ] 文档覆盖率 ≥ 90%
   - [ ] 3 个独立测试者验证快速开始指南
   - [ ] 无拼写错误
   - [ ] 无事实错误
-- **预估工时**: 3 小时
-- **依赖**: T-009
-- **阻塞**: 无（最终任务）
-- **优先级**: P0
+
+* **预估工时**: 3 小时
+
+* **依赖**: T-009
+
+* **阻塞**: 无（最终任务）
+
+* **优先级**: P0
 
 ---
 
 ## 3. 并行任务组
 
 **组 1**（Phase 0 完成后并行）:
-- T-002: 更新 README.md
-- T-003: 创建 USER_GUIDE.md 框架
+
+* T-002: 更新 README.md
+
+* T-003: 创建 USER_GUIDE.md 框架
 
 **组 2**（T-003 完成后并行）:
-- T-004: 编写快速开始指南
-- T-005: 编写核心功能文档
+
+* T-004: 编写快速开始指南
+
+* T-005: 编写核心功能文档
 
 **组 3**（T-008 完成后并行）:
-- T-009: 添加 FAQ
-- （可选）添加视频教程
+
+* T-009: 添加 FAQ
+
+* （可选）添加视频教程
 
 ---
 
 ## 4. 风险与缓解
 
 | 风险 | 影响 | 缓解措施 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | 事实错误未完全修正 | 高 | T-001 完成后由 Domain Expert 复审 |
 | 安装步骤在不同环境失败 | 高 | 3 个独立测试者验证（macOS/Linux/Windows） |
 | 文档与代码不同步 | 中 | 添加 CI 验证脚本（检查 agent/skill 数量） |
@@ -300,21 +383,29 @@ graph TD
 
 ## 5. 成功指标
 
-- [ ] 新用户在 10 分钟内完成安装并运行第一个示例
-- [ ] 文档覆盖率 ≥ 90%（50 agents + 70 skills + 15 hook types）
-- [ ] GitHub Issues 中"文档相关"问题减少 50%（从 20/月 → 10/月）
-- [ ] 30 天留存率 ≥ 40%
+* [ ] 新用户在 10 分钟内完成安装并运行第一个示例
+
+* [ ] 文档覆盖率 ≥ 90%（50 agents + 70 skills + 15 hook types）
+
+* [ ] GitHub Issues 中"文档相关"问题减少 50%（从 20/月 → 10/月）
+
+* [ ] 30 天留存率 ≥ 40%
 
 ---
 
 ## 6. 时间线
 
-- **Phase 0**: 2-3 小时（T-001）
-- **Phase 1**: 5 小时（T-002, T-003, T-004 部分并行）
-- **Phase 2**: 4 小时（T-005）
-- **Phase 3**: 6 小时（T-006）
-- **Phase 4**: 8 小时（T-007, T-008, T-009 顺序）
-- **Phase 5**: 3 小时（T-010）
+* **Phase 0**: 2-3 小时（T-001）
+
+* **Phase 1**: 5 小时（T-002, T-003, T-004 部分并行）
+
+* **Phase 2**: 4 小时（T-005）
+
+* **Phase 3**: 6 小时（T-006）
+
+* **Phase 4**: 8 小时（T-007, T-008, T-009 顺序）
+
+* **Phase 5**: 3 小时（T-010）
 
 **总计**: 28 小时（约 5-6 个工作日）
 

package/docs/testing.md

@@ -24,7 +24,9 @@ tests/
 集成测试使用实际 skill 执行真实的 Claude Code 会话：
 
 ```bash
+
 # 运行 subagent-driven-development 集成测试
+
 cd tests/claude-code
 ./test-subagent-driven-development-integration.sh
 ```
@@ -33,9 +35,11 @@ cd tests/claude-code
 
 ### 前提条件
 
-- 必须从 **ultrapower 插件目录**运行（不能从临时目录运行）
-- Claude Code 必须已安装并可通过 `claude` 命令访问
-- 必须启用本地开发 marketplace：在 `~/.claude/settings.json` 中设置 `"omc@ultrapower-dev": true`
+* 必须从 **ultrapower 插件目录**运行（不能从临时目录运行）
+
+* Claude Code 必须已安装并可通过 `claude` 命令访问
+
+* 必须启用本地开发 marketplace：在 `~/.claude/settings.json` 中设置 `"omc@ultrapower-dev": true`
 
 ## 集成测试：subagent-driven-development
 
@@ -61,7 +65,7 @@ cd tests/claude-code
    - 实现文件已创建
    - 测试通过
    - Git 提交显示正确的工作流
-4. **Token 分析**：按 subagent 显示 token 使用明细
+1. **Token 分析**：按 subagent 显示 token 使用明细
 
 ### 测试输出
 
@@ -149,31 +153,39 @@ python3 tests/claude-code/analyze-token-usage.py ~/.claude/projects/<project-dir
 会话转录存储在 `~/.claude/projects/` 中，工作目录路径经过编码：
 
 ```bash
+
 # 示例：/Users/jesse/Documents/GitHub/ultrapower/ultrapower
+
 SESSION_DIR="$HOME/.claude/projects/-Users-jesse-Documents-GitHub-ultrapower-ultrapower"
 
 # 查找最近的会话
+
 ls -lt "$SESSION_DIR"/*.jsonl | head -5
 ```
 
 ### 显示内容
 
-- **主会话使用情况**：协调者（您或主 Claude 实例）的 token 使用情况
-- **每个 subagent 明细**：每次 Task 调用，包含：
+* **主会话使用情况**：协调者（您或主 Claude 实例）的 token 使用情况
+
+* **每个 subagent 明细**：每次 Task 调用，包含：
   - Agent ID
   - 描述（从提示词中提取）
   - 消息数量
   - 输入/输出 token
   - 缓存使用情况
   - 估算费用
-- **总计**：整体 token 使用情况和费用估算
+
+* **总计**：整体 token 使用情况和费用估算
 
 ### 理解输出
 
-- **高缓存读取**：良好——表示提示词缓存正在工作
-- **主会话高输入 token**：预期——协调者拥有完整上下文
-- **每个 subagent 费用相近**：预期——每个 subagent 获得相似的任务复杂度
-- **每个任务费用**：典型范围为每个 subagent $0.05-$0.15，取决于任务
+* **高缓存读取**：良好——表示提示词缓存正在工作
+
+* **主会话高输入 token**：预期——协调者拥有完整上下文
+
+* **每个 subagent 费用相近**：预期——每个 subagent 获得相似的任务复杂度
+
+* **每个任务费用**：典型范围为每个 subagent $0.05-$0.15，取决于任务
 
 ## 故障排除
 
@@ -225,13 +237,16 @@ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 source "$SCRIPT_DIR/test-helpers.sh"
 
 # 创建测试项目
+
 TEST_PROJECT=$(create_test_project)
 trap "cleanup_test_project $TEST_PROJECT" EXIT
 
 # 设置测试文件...
+
 cd "$TEST_PROJECT"
 
 # 使用 skill 运行 Claude
+
 PROMPT="Your test prompt here"
 cd "$SCRIPT_DIR/../.." && timeout 1800 claude -p "$PROMPT" \
   --allowed-tools=all \
@@ -240,16 +255,19 @@ cd "$SCRIPT_DIR/../.." && timeout 1800 claude -p "$PROMPT" \
   2>&1 | tee output.txt
 
 # 查找并分析会话
+
 WORKING_DIR_ESCAPED=$(echo "$SCRIPT_DIR/../.." | sed 's/\\//-/g' | sed 's/^-//')
 SESSION_DIR="$HOME/.claude/projects/$WORKING_DIR_ESCAPED"
 SESSION_FILE=$(find "$SESSION_DIR" -name "*.jsonl" -type f -mmin -60 | sort -r | head -1)
 
 # 通过解析会话转录验证行为
+
 if grep -q '"name":"Skill".*"skill":"your-skill-name"' "$SESSION_FILE"; then
     echo "[PASS] Skill was invoked"
 fi
 
 # 显示 token 分析
+
 python3 "$SCRIPT_DIR/analyze-token-usage.py" "$SESSION_FILE"
 ```
 

package/docs/troubleshooting/agent-timeouts.md

@@ -3,9 +3,12 @@
 ## Timeout Configuration
 
 Default timeouts by agent type:
-- Haiku: 2 minutes
-- Sonnet: 5 minutes
-- Opus: 10 minutes
+
+* Haiku: 2 minutes
+
+* Sonnet: 5 minutes
+
+* Opus: 10 minutes
 
 ## Common Causes
 
@@ -16,6 +19,7 @@ Default timeouts by agent type:
 ## Solutions
 
 ### Increase Timeout
+
 Edit `src/agents/timeout-config.ts`:
 ```typescript
 export const AGENT_TIMEOUTS = {
@@ -26,11 +30,15 @@ export const AGENT_TIMEOUTS = {
 ```
 
 ### Break Down Task
-- Split large tasks into smaller chunks
-- Use incremental approach
-- Limit file scope
+
+* Split large tasks into smaller chunks
+
+* Use incremental approach
+
+* Limit file scope
 
 ### Agent Stuck
+
 If agent appears hung:
 1. Use `/ultrapower:cancel`
 2. Clear `.omc/state/` files

package/docs/troubleshooting/common-errors.md

@@ -3,6 +3,7 @@
 ## TypeScript Errors
 
 ### TS2339: Property does not exist
+
 **Cause**: Accessing undefined property or type mismatch
 
 **Solution**:
@@ -11,6 +12,7 @@
 3. Add missing properties or fix type annotations
 
 ### Import Errors
+
 **Cause**: Missing .js extension or wrong path
 
 **Solution**:
@@ -21,6 +23,7 @@
 ## Runtime Errors
 
 ### ENOENT: File not found
+
 **Cause**: Missing file or incorrect path
 
 **Solution**:
@@ -29,6 +32,7 @@
 3. Ensure .omc/ directory structure exists
 
 ### Permission Denied
+
 **Cause**: Insufficient file system permissions
 
 **Solution**:

package/docs/troubleshooting/hook-failures.md

@@ -10,9 +10,12 @@
 3. Identify slow operations
 
 **Solutions**:
-- Increase timeout in hook configuration
-- Optimize hook logic
-- Break into smaller operations
+
+* Increase timeout in hook configuration
+
+* Optimize hook logic
+
+* Break into smaller operations
 
 ## Hook Crash
 
@@ -24,6 +27,9 @@
 3. Verify dependencies loaded
 
 **Solutions**:
-- Add error handling
-- Validate inputs before processing
-- Check for missing dependencies
+
+* Add error handling
+
+* Validate inputs before processing
+
+* Check for missing dependencies