@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/design/delegation-enforcer-integration.md

@@ -42,7 +42,7 @@ orchestrator *should* delegate. `processPreToolUse` in delegation-enforcer handl
 ### 2.2 Relationship with processOrchestratorPreTool
 
 | Concern | Module | Action |
-|---------|--------|--------|
+| --------- | -------- | -------- |
 | Should orchestrator direct-edit? | omc-orchestrator | Block / warn |
 | Which model for Task/Agent? | delegation-enforcer | Inject model |
 
@@ -55,7 +55,7 @@ tool calls; omc-orchestrator activates for Edit/Write/Bash tool calls.
 
 **Trigger:** `pre-tool-use` only.
 
-**Tool filter:** `toolName === 'Task' || toolName === 'Agent'`
+**Tool filter:** `toolName === 'Task' | | toolName === 'Agent'`
 
 All other tools (Bash, Edit, Write, Read, Glob, etc.) pass through unchanged.
 
@@ -83,7 +83,7 @@ substitutes it for the original tool input when `continue: true`.
 ### 4.2 Injection Rules
 
 | Condition | Behavior |
-|-----------|----------|
+| ----------- | ---------- |
 | `model` already present | Preserve original; no injection |
 | `model` absent, agent type known | Inject from agent definition |
 | `model` absent, agent type unknown | Pass through unchanged (no throw) |
@@ -94,7 +94,7 @@ substitutes it for the original tool input when `continue: true`.
 Default models come from `getAgentDefinitions()`. Key mappings:
 
 | Agent | Default Model |
-|-------|--------------|
+| ------- | -------------- |
 | explore, explore-low | haiku |
 | executor, executor-medium | sonnet |
 | executor-high, deep-executor | opus |
@@ -127,10 +127,12 @@ When no injection occurs (model already set or non-agent tool):
 
 ## 5. Error Handling
 
-- Unknown agent types: log debug warning, return `modifiedInput: originalInput`
+* Unknown agent types: log debug warning, return `modifiedInput: originalInput`
   (no throw — robustness over strictness in hot path)
-- `getAgentDefinitions()` failure: catch, log error, pass through unchanged
-- Preserves `run_in_background`, `resume`, and all other input fields
+
+* `getAgentDefinitions()` failure: catch, log error, pass through unchanged
+
+* Preserves `run_in_background`, `resume`, and all other input fields
 
 ---
 
@@ -154,7 +156,7 @@ return, the delegation-enforcer is called:
 ```typescript
 // Enforce model parameter for Task/Agent calls
 const delegationResult = enforceDelegationModel(
-  input.toolName || '',
+  input.toolName | | '',
   input.toolInput,
 );
 

package/docs/design/project-session-manager.md

@@ -42,10 +42,14 @@ Project Session Manager（PSM）使用 git worktrees 和 tmux 会话与 Claude C
 ### 解决方案
 
 PSM 提供统一接口来：
-- 用单个命令创建隔离的 worktrees
-- 生成预配置的带 Claude Code 的 tmux 会话
-- 跟踪和管理所有活跃会话
-- 自动清理已完成的工作
+
+* 用单个命令创建隔离的 worktrees
+
+* 生成预配置的带 Claude Code 的 tmux 会话
+
+* 跟踪和管理所有活跃会话
+
+* 自动清理已完成的工作
 
 ---
 
@@ -54,13 +58,17 @@ PSM 提供统一接口来：
 ### 2.1 PR 审查
 
 ```bash
+
 # 审查 ultrapower 仓库的 PR #123
+
 /psm review omc#123
 
 # 审查任意 GitHub URL 的 PR
-/psm review https://github.com/anthropics/claude-code/pull/456
+
+/psm review <https://github.com/anthropics/claude-code/pull/456>
 
 # 带特定关注点的审查
+
 /psm review omc#123 --focus "security implications"
 ```
 
@@ -74,14 +82,18 @@ PSM 提供统一接口来：
 ### 2.2 问题修复
 
 ```bash
+
 # 修复问题 #42
+
 /psm fix omc#42
 
 # 使用分支名称覆盖修复
+
 /psm fix omc#42 --branch fix/auth-timeout
 
 # 从问题 URL 修复
-/psm fix https://github.com/anthropics/claude-code/issues/789
+
+/psm fix <https://github.com/anthropics/claude-code/issues/789>
 ```
 
 **发生了什么：**
@@ -94,13 +106,17 @@ PSM 提供统一接口来：
 ### 2.3 功能开发
 
 ```bash
+
 # 开始新功能
+
 /psm feature omc "add-webhook-support"
 
 # 从现有分支开始功能
+
 /psm feature omc --branch feature/webhooks
 
 # 使用特定基础的功能
+
 /psm feature omc "dark-mode" --base develop
 ```
 
@@ -113,13 +129,17 @@ PSM 提供统一接口来：
 ### 2.4 发布准备
 
 ```bash
+
 # 准备发布
+
 /psm release omc v3.5.0
 
 # 发布候选版本
+
 /psm release omc v3.5.0-rc1 --draft
 
 # 热修复发布
+
 /psm release omc v3.4.1 --hotfix --base v3.4.0
 ```
 
@@ -132,38 +152,50 @@ PSM 提供统一接口来：
 ### 2.5 会话管理
 
 ```bash
+
 # 列出所有会话
+
 /psm list
 
 # 列出特定项目的会话
+
 /psm list omc
 
 # 附加到现有会话
+
 /psm attach omc:pr-123
 
 # 分离当前会话（返回主界面）
+
 /psm detach
 
 # 终止特定会话
+
 /psm kill omc:pr-123
 
 # 终止项目的所有会话
+
 /psm kill omc --all
 
 # 清理已完成的会话
+
 /psm cleanup
 
 # 强制清理
+
 /psm cleanup --force --older-than 7d
 ```
 
 ### 2.6 快速上下文切换
 
 ```bash
+
 # 切换到另一个会话（分离当前，附加目标）
+
 /psm switch omc:feature-auth
 
 # 使用会话选择器切换（fzf）
+
 /psm switch
 ```
 
@@ -174,7 +206,7 @@ PSM 提供统一接口来：
 ### 3.1 主要命令
 
 | 命令 | 描述 | 别名 |
-|---------|-------------|---------|
+| --------- | ------------- | --------- |
 | `review <ref>` | 开始 PR 审查会话 | `pr`, `r` |
 | `fix <ref>` | 开始问题修复会话 | `issue`, `i` |
 | `feature <name>` | 开始功能开发 | `feat`, `f` |
@@ -190,7 +222,7 @@ PSM 提供统一接口来：
 ### 3.2 全局标志
 
 | 标志 | 描述 | 默认值 |
-|------|-------------|---------|
+| ------ | ------------- | --------- |
 | `--project`, `-p` | 项目标识符或路径 | 当前目录 |
 | `--no-claude` | 跳过 Claude Code 启动 | false |
 | `--no-tmux` | 使用当前终端 | false |
@@ -203,16 +235,21 @@ PSM 提供统一接口来：
 PSM 支持多种引用格式：
 
 ```bash
+
 # 短别名（需要 ~/.psm/projects.json 配置）
+
 omc#123
 
 # 完整 GitHub 引用
+
 anthropics/claude-code#123
 
 # GitHub URL
-https://github.com/anthropics/claude-code/pull/123
+
+<https://github.com/anthropics/claude-code/pull/123>
 
 # 本地路径
+
 /path/to/repo#123
 
 # 当前目录（隐式）
@@ -400,7 +437,7 @@ User Command
     "pr_number": 123,
     "pr_title": "Add webhook support",
     "pr_author": "contributor",
-    "pr_url": "https://github.com/anthropics/ultrapower/pull/123"
+    "pr_url": "<https://github.com/anthropics/ultrapower/pull/123">
   },
   "state": "active",
   "notes": []
@@ -416,7 +453,7 @@ User Command
 格式：`psm:<project>:<type>-<identifier>`
 
 | 类型 | 模式 | 示例 |
-|------|---------|---------|
+| ------ | --------- | --------- |
 | PR 审查 | `psm:<proj>:pr-<num>` | `psm:omc:pr-123` |
 | 问题修复 | `psm:<proj>:issue-<num>` | `psm:omc:issue-42` |
 | 功能 | `psm:<proj>:feat-<name>` | `psm:omc:feat-auth` |
@@ -428,7 +465,7 @@ User Command
 格式：`<type>-<identifier>`
 
 | 类型 | 模式 | 示例 |
-|------|---------|---------|
+| ------ | --------- | --------- |
 | PR 审查 | `pr-<num>` | `pr-123` |
 | 问题修复 | `issue-<num>` | `issue-42` |
 | 功能 | `feat-<name>` | `feat-auth` |
@@ -437,7 +474,7 @@ User Command
 ### 6.3 分支名称
 
 | 类型 | 模式 | 示例 |
-|------|---------|---------|
+| ------ | --------- | --------- |
 | PR 审查 | （使用 PR 分支） | `feature/add-hooks` |
 | 问题修复 | `fix/<issue>-<slug>` | `fix/42-auth-timeout` |
 | 功能 | `feature/<name>` | `feature/auth` |
@@ -657,7 +694,7 @@ steps:
 ### 9.1 清理级别
 
 | 级别 | 命令 | 清理内容 |
-|-------|---------|----------------|
+| ------- | --------- | ---------------- |
 | 安全 | `/psm cleanup` | 已合并 PR、已关闭问题、已归档 |
 | 适度 | `/psm cleanup --stale` | + 不活跃 > 14 天 |
 | 激进 | `/psm cleanup --force` | + 所有已分离会话 |
@@ -735,7 +772,7 @@ def cleanup(options):
 ### 10.1 OMC Skill 集成
 
 | OMC Skill | PSM 集成 |
-|-----------|-----------------|
+| ----------- | ----------------- |
 | `autopilot` | 可为隔离工作生成 PSM 会话 |
 | `ultrawork` | 跨 PSM 会话的并行 agents |
 | `ralph` | 每个 PSM 会话的持久性跟踪 |
@@ -764,7 +801,7 @@ interface ClawdbotPSMIntegration {
 ### 10.3 GitHub 集成
 
 | 功能 | 集成 |
-|---------|-------------|
+| --------- | ------------- |
 | PR 创建 | 从功能会话自动创建草稿 PR |
 | PR 状态 | 跟踪合并状态以便清理 |
 | 问题关联 | 自动将提交关联到问题 |
@@ -774,13 +811,17 @@ interface ClawdbotPSMIntegration {
 ### 10.4 编辑器集成
 
 ```bash
+
 # VSCode
+
 /psm review omc#123 --editor vscode
 
 # Cursor
+
 /psm review omc#123 --editor cursor
 
 # Neovim
+
 /psm review omc#123 --editor nvim
 ```
 
@@ -801,7 +842,7 @@ OMC HUD 状态栏中的 PSM 状态：
 ### 11.1 常见边缘情况
 
 | 场景 | 处理方式 |
-|----------|----------|
+| ---------- | ---------- |
 | Worktree 已存在 | 提供选项：附加、重建或中止 |
 | Tmux 会话名称冲突 | 追加时间戳后缀 |
 | PR 分支被强制推送 | 警告并提供重新获取选项 |
@@ -814,16 +855,21 @@ OMC HUD 状态栏中的 PSM 状态：
 ### 11.2 错误恢复
 
 ```bash
+
 # 从现有 worktrees 和 tmux 重建 sessions.json
+
 /psm repair
 
 # 修复孤立的 tmux 会话（无 worktree）
+
 /psm repair --orphaned-tmux
 
 # 修复孤立的 worktrees（无会话记录）
+
 /psm repair --orphaned-worktrees
 
 # 完整重建
+
 /psm repair --full
 ```
 
@@ -847,9 +893,11 @@ OMC HUD 状态栏中的 PSM 状态：
 
 ### 12.1 凭据处理
 
-- **GitHub Token**：使用现有 `gh` CLI 认证，PSM 从不存储
-- **SSH 密钥**：依赖系统 SSH agent
-- **Worktrees 中的密钥**：Worktrees 继承 .gitignore，密钥不会被复制
+* **GitHub Token**：使用现有 `gh` CLI 认证，PSM 从不存储
+
+* **SSH 密钥**：依赖系统 SSH agent
+
+* **Worktrees 中的密钥**：Worktrees 继承 .gitignore，密钥不会被复制
 
 ### 12.2 路径清理
 
@@ -868,9 +916,11 @@ def sanitize_session_name(name: str) -> str:
 
 ### 12.3 权限
 
-- Worktree 目录：`0755`（用户 rwx，其他 rx）
-- 会话元数据：`0600`（仅用户）
-- 配置文件：`0600`（仅用户）
+* Worktree 目录：`0755`（用户 rwx，其他 rx）
+
+* 会话元数据：`0600`（仅用户）
+
+* 配置文件：`0600`（仅用户）
 
 ---
 
@@ -879,7 +929,7 @@ def sanitize_session_name(name: str) -> str:
 ### 13.1 计划功能
 
 | 功能 | 优先级 | 描述 |
-|---------|----------|-------------|
+| --------- | ---------- | ------------- |
 | 会话模板 | 高 | 自定义工作流模板 |
 | 团队共享 | 中 | 共享会话配置 |
 | 会话录制 | 中 | 录制会话以供回放 |
@@ -910,10 +960,13 @@ interface PSMPlugin {
 
 ### 13.3 潜在集成
 
-- **Linear**：从 Linear 问题创建会话
-- **Jira**：从 Jira 工单创建会话
-- **Slack**：会话事件通知
-- **Discord**：团队会话协调
+* **Linear**：从 Linear 问题创建会话
+
+* **Jira**：从 Jira 工单创建会话
+
+* **Slack**：会话事件通知
+
+* **Discord**：团队会话协调
 
 ---
 
@@ -944,7 +997,7 @@ interface PSMPlugin {
 │ 引用格式                                                    │
 │   omc#123               项目别名 + 编号                    │
 │   org/repo#123          完整 GitHub 引用                   │
-│   https://...           GitHub URL                        │
+│   <https://...>           GitHub URL                        │
 └────────────────────────────────────────────────────────────┘
 ```
 

package/docs/dev-standards/context-collection.md

@@ -3,30 +3,35 @@
 ## 编码前强制检索清单（7项必查）
 
 ### 1. 文件名搜索（必须）
+
 ```bash
 desktop-commander.start_search searchType="files" pattern="关键词"
 ```
 目标：找到5-10个候选文件
 
 ### 2. 内容搜索（必须）
+
 ```bash
-desktop-commander.start_search searchType="content" pattern="函数名|类名"
+desktop-commander.start_search searchType="content" pattern="函数名 | 类名"
 ```
 目标：找到关键实现位置
 
 ### 3. 阅读相似实现（必须≥3个）
+
 ```bash
 Read file_path
 ```
 关注：实现模式、可复用组件、注意事项
 
 ### 4. 开源实现搜索（通用功能必做）
+
 ```bash
 github.search_code query="具体功能" language:"语言"
 ```
 目标：学习最佳实践
 
 ### 5. 官方文档查询（涉及库/框架必做）
+
 ```bash
 context7 resolve-library-id libraryName="库名"
 context7 get-library-docs context7CompatibleLibraryID="库ID"
@@ -34,10 +39,12 @@ context7 get-library-docs context7CompatibleLibraryID="库ID"
 目标：避免错误用法
 
 ### 6. 测试代码分析（必须）
+
 ```bash
-desktop-commander.start_search pattern="describe|it|test"
+desktop-commander.start_search pattern="describe | it | test"
 ```
 目标：理解测试策略
 
 ### 7. 模式提取（必须）
+
 使用 sequential-thinking 分析检索结果

package/docs/dev-standards/context-summary-template.md

@@ -1,49 +1,73 @@
 # 上下文摘要模板
 
 ## 项目上下文摘要（[任务名称]）
+
 生成时间：[YYYY-MM-DD HH:mm:ss]
 
 ### 1. 相似实现分析
-- **实现1**: src/foo/bar.ts:123-156
+
+* **实现1**: src/foo/bar.ts:123-156
   - 模式：[设计模式]
   - 可复用：[具体函数/类]
   - 需注意：[关键事项]
 
-- **实现2**: src/baz/qux.ts:78-90
+* **实现2**: src/baz/qux.ts:78-90
   - 模式：[设计模式]
   - 可复用：[具体函数/类]
   - 需注意：[关键事项]
 
 ### 2. 项目约定
-- **命名约定**: [变量/函数/类/文件命名规则]
-- **文件组织**: [目录结构和模块划分]
-- **导入顺序**: [导入语句排序规则]
-- **代码风格**: [缩进/括号/空格等]
+
+* **命名约定**: [变量/函数/类/文件命名规则]
+
+* **文件组织**: [目录结构和模块划分]
+
+* **导入顺序**: [导入语句排序规则]
+
+* **代码风格**: [缩进/括号/空格等]
 
 ### 3. 可复用组件清单
-- `src/utils/validator.ts`: 验证工具函数
-- `src/core/base.ts`: 基类和接口
-- `src/helpers/formatter.ts`: 格式化工具
+
+* `src/utils/validator.ts`: 验证工具函数
+
+* `src/core/base.ts`: 基类和接口
+
+* `src/helpers/formatter.ts`: 格式化工具
 
 ### 4. 测试策略
-- **测试框架**: [Jest/Mocha/Vitest等]
-- **测试模式**: [单元/集成/E2E]
-- **参考文件**: tests/unit/example.spec.ts
-- **覆盖要求**: [正常流程 + 边界条件 + 错误处理]
+
+* **测试框架**: [Jest/Mocha/Vitest等]
+
+* **测试模式**: [单元/集成/E2E]
+
+* **参考文件**: tests/unit/example.spec.ts
+
+* **覆盖要求**: [正常流程 + 边界条件 + 错误处理]
 
 ### 5. 依赖和集成点
-- **外部依赖**: [lodash, axios等]
-- **内部依赖**: [模块间依赖关系]
-- **集成方式**: [事件总线/依赖注入/直接调用]
-- **配置来源**: [配置文件路径]
+
+* **外部依赖**: [lodash, axios等]
+
+* **内部依赖**: [模块间依赖关系]
+
+* **集成方式**: [事件总线/依赖注入/直接调用]
+
+* **配置来源**: [配置文件路径]
 
 ### 6. 技术选型理由
-- **为什么用这个方案**: [具体理由]
-- **优势**: [关键优势]
-- **劣势和风险**: [需要注意的点]
+
+* **为什么用这个方案**: [具体理由]
+
+* **优势**: [关键优势]
+
+* **劣势和风险**: [需要注意的点]
 
 ### 7. 关键风险点
-- **并发问题**: [潜在的竞态条件]
-- **边界条件**: [需要处理的边界情况]
-- **性能瓶颈**: [可能的性能问题]
-- **安全考虑**: [需要注意的安全问题]
+
+* **并发问题**: [潜在的竞态条件]
+
+* **边界条件**: [需要处理的边界情况]
+
+* **性能瓶颈**: [可能的性能问题]
+
+* **安全考虑**: [需要注意的安全问题]

package/docs/dev-standards/dev-standards.md

@@ -1,23 +1,37 @@
 # 开发标准
 
 ## 编码要求
-- 编码前先描述方案并等待批准
-- 修改超3个文件需先分解任务
-- 代码完成后列出潜在问题和测试用例
-- 发现bug先写复现测试
-- 每次被纠正后在此文件添加规则
+
+* 编码前先描述方案并等待批准
+
+* 修改超3个文件需先分解任务
+
+* 代码完成后列出潜在问题和测试用例
+
+* 发现bug先写复现测试
+
+* 每次被纠正后在此文件添加规则
 
 ## 语言规范
-- **强制使用简体中文**：所有回复、文档、注释、日志、提交信息
-- 唯一例外：代码标识符遵循项目命名约定
+
+* **强制使用简体中文**：所有回复、文档、注释、日志、提交信息
+
+* 唯一例外：代码标识符遵循项目命名约定
 
 ## 验证机制
-- 拒绝 CI/远程验证，所有验证本地执行
-- 每次改动提供可重复验证步骤
-- 验证失败立即终止提交
+
+* 拒绝 CI/远程验证，所有验证本地执行
+
+* 每次改动提供可重复验证步骤
+
+* 验证失败立即终止提交
 
 ## 代码质量
-- 遵循 SOLID、DRY 原则
-- 禁止 MVP/占位符，必须完整实现
-- 删除过时/重复代码
-- 评估性能影响
+
+* 遵循 SOLID、DRY 原则
+
+* 禁止 MVP/占位符，必须完整实现
+
+* 删除过时/重复代码
+
+* 评估性能影响

package/docs/dev-standards/quality-review.md

@@ -3,9 +3,11 @@
 ## 审查职责（Claude Code 独立执行）
 
 ### 使用工具
-- sequential-thinking 进行深度分析
+
+* sequential-thinking 进行深度分析
 
 ### 输出内容
+
 1. 技术维度评分（代码质量、测试覆盖、规范遵循）
 2. 战略维度评分（需求匹配、架构一致、风险评估）
 3. 综合评分（0-100）
@@ -14,21 +16,30 @@
 
 ## 审查清单
 
-- [ ] 需求字段完整性
-- [ ] 覆盖原始意图无遗漏
-- [ ] 交付物映射明确
-- [ ] 依赖与风险评估完毕
-- [ ] 审查结论已留痕
+* [ ] 需求字段完整性
+
+* [ ] 覆盖原始意图无遗漏
+
+* [ ] 交付物映射明确
+
+* [ ] 依赖与风险评估完毕
+
+* [ ] 审查结论已留痕
 
 ## 决策规则
 
-- 综合评分 ≥90 分且建议"通过" → 确认通过
-- 综合评分 <80 分且建议"退回" → 确认退回
-- 80-89 分或建议"需讨论" → 仔细审阅后决策
+* 综合评分 ≥90 分且建议"通过" → 确认通过
+
+* 综合评分 <80 分且建议"退回" → 确认退回
+
+* 80-89 分或建议"需讨论" → 仔细审阅后决策
 
 ## 验证机制
 
-- 拒绝 CI/远程验证
-- 所有验证本地执行
-- 提供可重复验证步骤
-- 验证失败立即终止
+* 拒绝 CI/远程验证
+
+* 所有验证本地执行
+
+* 提供可重复验证步骤
+
+* 验证失败立即终止