@liangjie559567/ultrapower 5.5.2 → 5.5.3

package/skills/writing-plans/SKILL.md

@@ -33,7 +33,7 @@ description: 在有规格或需求的多步骤任务时使用，在接触代码
 ```markdown
 # [Feature Name] Implementation Plan
 
-> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+> **For Claude:** REQUIRED SUB-SKILL: Use ultrapower:executing-plans to implement this plan task-by-task.
 
 **Goal:** [一句话描述构建内容]
 
@@ -107,13 +107,13 @@ git commit -m "feat: add specific feature"
 **选择哪种方式？"**
 
 **如果选择 Subagent 驱动：**
-- **必需子 skill：** 使用 superpowers:subagent-driven-development
+- **必需子 skill：** 使用 ultrapower:subagent-driven-development
 - 保持在本 session
 - 每个任务新 subagent + 代码审查
 
 **如果选择并行 Session：**
 - 引导他们在 worktree 中打开新 session
-- **必需子 skill：** 新 session 使用 superpowers:executing-plans
+- **必需子 skill：** 新 session 使用 ultrapower:executing-plans
 
 ## 路由触发
 

package/skills/writing-skills/SKILL.md

@@ -15,7 +15,7 @@ description: 创建新 skill、编辑现有 skill 或在部署前验证 skill
 
 **核心原则：** 如果你没有观察过 agent 在没有 skill 的情况下失败，你就不知道 skill 是否教了正确的东西。
 
-**必需背景：** 使用本 skill 前，你必须理解 superpowers:test-driven-development。该 skill 定义了基本的 RED-GREEN-REFACTOR 循环。本 skill 将 TDD 适配到文档。
+**必需背景：** 使用本 skill 前，你必须理解 ultrapower:test-driven-development。该 skill 定义了基本的 RED-GREEN-REFACTOR 循环。本 skill 将 TDD 适配到文档。
 
 **官方指导：** 关于 Anthropic 官方 skill 编写最佳实践，请参阅 anthropic-best-practices.md。该文档提供了补充本 skill TDD 方法的额外模式和指南。
 
@@ -278,8 +278,8 @@ wc -w skills/path/SKILL.md
 **编写引用其他 skill 的文档时：**
 
 仅使用 skill 名称，带明确的要求标记：
-- 好：`**REQUIRED SUB-SKILL:** Use superpowers:test-driven-development`
-- 好：`**REQUIRED BACKGROUND:** You MUST understand superpowers:systematic-debugging`
+- 好：`**REQUIRED SUB-SKILL:** Use ultrapower:test-driven-development`
+- 好：`**REQUIRED BACKGROUND:** You MUST understand ultrapower:systematic-debugging`
 - 差：`See skills/testing/test-driven-development`（不清楚是否必需）
 - 差：`@skills/testing/test-driven-development/SKILL.md`（强制加载，消耗上下文）
 
@@ -388,7 +388,7 @@ NO SKILL WITHOUT A FAILING TEST FIRST
 - 不要在运行测试时"适配"
 - 删除意味着删除
 
-**必需背景：** superpowers:test-driven-development skill 解释了为何重要。同样的原则适用于文档。
+**必需背景：** ultrapower:test-driven-development skill 解释了为何重要。同样的原则适用于文档。
 
 ## 测试所有 Skill 类型
 

package/skills/writing-skills/testing-skills-with-subagents.md

@@ -10,7 +10,7 @@
 
 **核心原则：** 如果你没有看到 agent 在没有 skill 的情况下失败，你就不知道 skill 是否防止了正确的失败。
 
-**必要背景：** 使用此 skill 前，你必须理解 superpowers:test-driven-development。该 skill 定义了基本的 RED-GREEN-REFACTOR 循环。此 skill 提供 skill 特定的测试格式（压力场景、合理化表格）。
+**必要背景：** 使用此 skill 前，你必须理解 ultrapower:test-driven-development。该 skill 定义了基本的 RED-GREEN-REFACTOR 循环。此 skill 提供 skill 特定的测试格式（压力场景、合理化表格）。
 
 **完整示例：** 参见 examples/CLAUDE_MD_TESTING.md，其中有测试 CLAUDE.md 文档变体的完整测试活动。
 

package/templates/tasks/README.md

@@ -0,0 +1,45 @@
+# 任务模板库
+
+## 可用模板
+
+### 功能开发
+文件: `feature-development.md`
+适用于: 实现新功能或改进现有功能
+包含: 需求分析、设计、实现、测试、文档
+
+### Bug 修复
+文件: `bug-fix.md`
+适用于: 修复 bug 和问题
+包含: 问题复现、根因分析、修复、回归测试
+
+### 代码审查
+文件: `code-review.md`
+适用于: 审查代码变更
+包含: 质量检查、功能验证、性能安全、文档测试
+
+### 重构
+文件: `refactoring.md`
+适用于: 改进代码结构
+包含: 现状分析、设计、实现、测试、文档
+
+### 安全审计
+文件: `security-audit.md`
+适用于: 安全审查和加固
+包含: 威胁建模、代码审查、依赖检查、配置审查
+
+## 使用方式
+
+```bash
+# 查看模板
+cat templates/tasks/feature-development.md
+
+# 应用模板到任务
+/template apply feature-development "功能描述"
+```
+
+## 模板特点
+
+- ✅ 预定义检查清单
+- ✅ 标准化工作流程
+- ✅ 最佳实践指导
+- ✅ 易于定制扩展

package/templates/tasks/bug-fix.md

@@ -0,0 +1,37 @@
+# Bug 修复模板
+
+## 问题信息
+- **Bug ID**: [ID]
+- **严重级别**: [Critical/High/Medium/Low]
+- **影响范围**: [模块/功能]
+- **报告者**: [姓名]
+
+## 问题复现
+- [ ] 理解问题现象
+- [ ] 确认复现步骤
+- [ ] 收集错误日志
+- [ ] 确认影响版本
+
+## 根因分析
+- [ ] 定位问题代码
+- [ ] 分析根本原因
+- [ ] 评估影响范围
+- [ ] 制定修复方案
+
+## 修复实现
+- [ ] 编写修复代码
+- [ ] 添加防护措施
+- [ ] 代码审查
+- [ ] 本地验证
+
+## 回归测试
+- [ ] 验证问题已解决
+- [ ] 检查相关功能
+- [ ] 运行完整测试套件
+- [ ] 性能检查
+
+## 发布
+- [ ] 更新变更日志
+- [ ] 标记版本
+- [ ] 发布补丁
+- [ ] 通知用户

package/templates/tasks/code-review.md

@@ -0,0 +1,36 @@
+# 代码审查模板
+
+## 审查信息
+- **PR ID**: [ID]
+- **作者**: [姓名]
+- **审查者**: [姓名]
+- **变更类型**: [Feature/Fix/Refactor/Docs]
+
+## 代码质量
+- [ ] 代码风格一致
+- [ ] 命名规范正确
+- [ ] 无重复代码
+- [ ] 复杂度合理
+
+## 功能正确性
+- [ ] 逻辑正确
+- [ ] 边界情况处理
+- [ ] 错误处理完善
+- [ ] 测试充分
+
+## 性能和安全
+- [ ] 无性能问题
+- [ ] 无安全漏洞
+- [ ] 资源管理正确
+- [ ] 依赖版本安全
+
+## 文档和测试
+- [ ] 代码注释清晰
+- [ ] 文档已更新
+- [ ] 测试覆盖充分
+- [ ] 变更日志已更新
+
+## 审查结论
+- [ ] 批准合并
+- [ ] 需要修改
+- [ ] 需要重新审查

package/templates/tasks/feature-development.md

@@ -0,0 +1,43 @@
+# 功能开发模板
+
+## 任务信息
+- **功能名称**: [功能名称]
+- **优先级**: [P0/P1/P2]
+- **预计工时**: [X 人天]
+- **负责人**: [姓名]
+
+## 需求分析
+- [ ] 理解用户需求和使用场景
+- [ ] 确认验收标准
+- [ ] 识别依赖关系和风险
+- [ ] 评估工作量
+
+## 设计审查
+- [ ] 架构设计和模块划分
+- [ ] API 接口设计
+- [ ] 数据模型设计
+- [ ] 性能和安全考虑
+
+## 实现
+- [ ] 编写核心代码
+- [ ] 添加错误处理
+- [ ] 代码审查
+- [ ] 集成测试
+
+## 测试
+- [ ] 单元测试 (>80% 覆盖率)
+- [ ] 集成测试
+- [ ] 端到端测试
+- [ ] 性能测试
+
+## 文档
+- [ ] API 文档
+- [ ] 用户指南
+- [ ] 变更日志
+- [ ] 示例代码
+
+## 验收
+- [ ] 所有测试通过
+- [ ] 代码审查通过
+- [ ] 文档完整
+- [ ] 性能达标

package/templates/tasks/refactoring.md

@@ -0,0 +1,37 @@
+# 重构模板
+
+## 重构信息
+- **模块名称**: [模块名]
+- **重构范围**: [文件/目录]
+- **预计工时**: [X 人天]
+- **目标**: [改进目标]
+
+## 现状分析
+- [ ] 分析现有代码结构
+- [ ] 识别技术债务
+- [ ] 评估重构风险
+- [ ] 制定重构计划
+
+## 重构设计
+- [ ] 新架构设计
+- [ ] 模块划分
+- [ ] 接口定义
+- [ ] 迁移策略
+
+## 实现变更
+- [ ] 编写新代码
+- [ ] 迁移现有逻辑
+- [ ] 更新依赖关系
+- [ ] 代码审查
+
+## 测试验证
+- [ ] 单元测试通过
+- [ ] 集成测试通过
+- [ ] 回归测试通过
+- [ ] 性能对比
+
+## 文档更新
+- [ ] 架构文档
+- [ ] API 文档
+- [ ] 迁移指南
+- [ ] 变更日志

package/templates/tasks/security-audit.md

@@ -0,0 +1,37 @@
+# 安全审计模板
+
+## 审计信息
+- **审计范围**: [模块/系统]
+- **审计日期**: [日期]
+- **审计员**: [姓名]
+- **风险等级**: [Critical/High/Medium/Low]
+
+## 威胁建模
+- [ ] 识别资产
+- [ ] 识别威胁
+- [ ] 评估风险
+- [ ] 制定对策
+
+## 代码审查
+- [ ] 检查认证机制
+- [ ] 检查授权控制
+- [ ] 检查输入验证
+- [ ] 检查加密实现
+
+## 依赖检查
+- [ ] 扫描已知漏洞
+- [ ] 检查版本更新
+- [ ] 评估依赖风险
+- [ ] 制定升级计划
+
+## 配置审查
+- [ ] 检查密钥管理
+- [ ] 检查访问控制
+- [ ] 检查日志记录
+- [ ] 检查错误处理
+
+## 修复和验证
+- [ ] 修复发现的问题
+- [ ] 验证修复有效性
+- [ ] 更新安全文档
+- [ ] 计划后续审计

package/docs/prd/ultrapower-standards-draft.md

@@ -1,191 +0,0 @@
-# PRD: ultrapower 全链路规范体系 - Draft
-
-> **状态**: DRAFT
-> **作者**: Product Design Expert (axiom-product-designer)
-> **版本**: 0.1
-> **日期**: 2026-02-26
-> **项目**: ultrapower v5.0.21
-
----
-
-## 1. 背景与目标
-
-### 1.1 背景
-
-ultrapower（OMC）是 Claude Code 的多 agent 编排框架，当前版本 v5.0.21 已具备完整的 agent 目录、skill 体系和 hook 机制。随着功能复杂度提升，三类系统性问题开始显现：
-
-- **运行时 BUG**：Hook 执行顺序不确定、状态文件并发读写冲突、Agent 生命周期管理缺失（参考已知问题：2026-02-12 Race Condition）
-- **使用混乱**：用户不清楚何时用 skill、何时用 agent、何时用 MCP，导致错误路由和资源浪费
-- **贡献无序**：新增 skill/agent/hook 缺乏统一模板和检查清单，引入不一致的实现模式
-
-### 1.2 目标
-
-建立覆盖全链路的规范体系，使 ultrapower 从"能用"升级为"可靠、易用、可扩展"。
-
-### 1.3 成功指标
-
-| 指标 | 当前状态 | 目标 |
-| --- | --- | --- |
-| 并发场景有明确处理指引 | 无 | 100% 覆盖 |
-| 新用户选出正确 skill 的时间 | 未知 | ≤ 5 分钟 |
-| 新增 skill 有完整检查清单 | 无 | 100% 覆盖 |
-| 三类 BUG 来源有对应规范 | 无 | 全覆盖 |
-
----
-
-## 2. 用户故事
-
-| 角色 | 目标 | 收益 |
-| --- | --- | --- |
-| 框架使用者（新用户） | 快速判断应该调用哪个 skill 或 agent | 5 分钟内做出正确决策，不走弯路 |
-| 框架使用者（老用户） | 在并发/复杂场景下得到明确的操作指引 | 避免状态冲突和运行时错误 |
-| 框架贡献者 | 按照统一模板新增 skill/agent/hook | 一次通过代码审查，不引入不一致模式 |
-| 框架维护者 | 快速定位 BUG 根因并有规范可依 | 减少排查时间，修复有据可查 |
-
----
-
-## 3. 高层需求（MVP）
-
-### P0 - 运行时防护规范（必须交付）
-
-1. **Hook 执行顺序规范**：定义 PreToolUse / PostToolUse / Stop 三类 hook 的触发时序、优先级和互斥规则
-2. **状态文件读写规范**：明确 `.omc/state/` 下各文件的读写锁策略，禁止并发写入同一状态文件
-3. **Agent 生命周期规范**：定义 agent 从 spawn 到 shutdown 的标准状态机，包含超时和异常退出处理
-
-### P1 - 用户使用规范（核心体验）
-
-4. **Skill 调用决策树**：提供可视化决策流程，帮助用户在 skill / agent / MCP 三者间做出正确选择
-5. **Agent 路由规范**：明确各 agent 角色的适用场景边界，避免错误路由（如用 executor 做分析）
-6. **常见反模式清单**：列举并解释 10 个最常见的错误用法，每条附正确替代方案
-
-### P2 - 开发贡献规范（生态健康）
-
-7. **Skill 标准模板**：包含触发词、约束、输出格式、测试用例的完整模板
-8. **Agent 标准模板**：包含角色定义、工具权限、输入输出契约的标准结构
-9. **Hook 标准模板**：包含事件类型、必需字段、错误处理的标准结构
-10. **贡献检查清单**：新增任何组件前必须通过的 checklist（含测试要求和版本兼容性验证）
-
----
-
-## 4. 业务流程
-
-### 4.1 用户使用决策流程
-
-```mermaid
-graph TD
-    A[用户有任务] --> B{任务类型判断}
-    B --> |简单单步操作| C[直接处理]
-    B --> |需要代码实现| D{复杂度判断}
-    B --> |需要分析/规划| E[MCP 工具优先]
-    B --> |多文件/多领域| F[Team 模式]
-
-    D --> |标准实现| G[executor / sonnet]
-    D --> |复杂自主任务| H[deep-executor / opus]
-
-    E --> |文档查找| I[Context7 MCP]
-    E --> |架构分析| J[ask_codex]
-    E --> |UI/设计| K[ask_gemini]
-
-    F --> L[team-plan]
-    L --> M[team-prd]
-    M --> N[team-exec]
-    N --> O[team-verify]
-    O --> |通过| P[complete]
-    O --> |失败| Q[team-fix]
-    Q --> N
-```
-
-### 4.2 运行时状态机（Agent 生命周期）
-
-```mermaid
-stateDiagram-v2
-    [*] --> SPAWNED : Task() 调用
-    SPAWNED --> RUNNING : 工具调用开始
-    RUNNING --> WAITING : 等待用户输入
-    WAITING --> RUNNING : 收到输入
-    RUNNING --> IDLE : 当前 turn 结束
-    IDLE --> RUNNING : 收到新消息
-    IDLE --> SHUTDOWN : shutdown_request
-    RUNNING --> ERROR : 异常/超时
-    ERROR --> SHUTDOWN : 错误处理完成
-    SHUTDOWN --> [*]
-```
-
-### 4.3 Hook 执行时序
-
-```mermaid
-sequenceDiagram
-    participant U as 用户
-    participant C as Claude
-    participant H as Hook 系统
-    participant S as 状态文件
-
-    U->>C: 发送指令
-    C->>H: PreToolUse hook
-    H->>S: 读取状态（只读）
-    H-->>C: hook success / block
-    C->>C: 执行工具调用
-    C->>H: PostToolUse hook
-    H->>S: 写入状态（加锁）
-    S-->>H: 写入完成
-    H-->>C: hook success
-    C->>H: Stop hook（turn 结束）
-    H->>S: 清理临时状态
-```
-
----
-
-## 5. 非功能需求
-
-| 类别 | 要求 |
-| --- | --- |
-| 可读性 | 所有规范文档使用中文，代码示例使用英文 |
-| 可维护性 | 规范文档与代码同仓库，随版本迭代更新 |
-| 向后兼容 | P0/P1 规范不得破坏现有 v5.0.x 用户的使用习惯 |
-| 可发现性 | 规范入口在 README 和 CLAUDE.md 中有明确链接 |
-
----
-
-## 6. 验收标准
-
-| 编号 | 验收项 | 验证方法 |
-| --- | --- | --- |
-| AC-01 | 并发场景有明确处理指引 | 检查 P0 规范是否覆盖：并行 agent 写同一状态文件的场景 |
-| AC-02 | 新用户 5 分钟内选出正确 skill | 用户测试：给出 3 个典型场景，新用户按决策树选择，准确率 ≥ 80% |
-| AC-03 | 新增 skill 有完整检查清单 | 检查 P2 checklist 是否包含：触发词、测试用例、版本兼容性三项 |
-| AC-04 | 三类 BUG 来源均有对应规范 | 逐一映射：运行时 BUG → P0，使用混乱 → P1，贡献无序 → P2 |
-
----
-
-## 7. Impact Scope（影响文件范围）
-
-本 PRD 实现后，预期新增/修改的文件范围：
-
-**新增文件（规范文档）：**
-- `docs/standards/runtime-protection.md` — P0 运行时防护规范
-- `docs/standards/user-guide.md` — P1 用户使用规范（含决策树）
-- `docs/standards/contribution-guide.md` — P2 开发贡献规范
-- `docs/standards/templates/skill-template.md` — Skill 标准模板
-- `docs/standards/templates/agent-template.md` — Agent 标准模板
-- `docs/standards/templates/hook-template.md` — Hook 标准模板
-
-**修改文件（入口链接）：**
-- `README.md` — 添加规范文档入口
-- `CLAUDE.md` — 添加规范引用
-
-**不在范围内（v2 延期）：**
-- 自动化规范检查工具（lint 插件）
-- 规范合规性 CI 检查
-- 多语言版本（英文版）
-
----
-
-## 8. 暂不包含（v2 延期）
-
-- 自动化规范合规检查（需要额外工具链投入）
-- 英文版规范文档（当前用户群以中文为主）
-- 视频教程或交互式引导（超出文档范围）
-- 规范覆盖率度量仪表盘
-- 历史 BUG 的规范回溯标注
-
-