@liangjie559567/ultrapower 5.0.4

package/skills/ax-evolution/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: ax-evolution
+description: "/ax-evolution — Axiom 进化引擎触发：手动触发知识收割、模式检测和反思"
+triggers: ["ax-evolution", "evolution engine", "进化引擎", "查询知识库", "查询模式库"]
+---
+
+# Axiom 进化引擎触发 Skill
+
+本 skill 是进化引擎的统一入口，提供知识管理的所有操作。
+
+**开始时宣告：** "I'm using the ax-evolution skill to trigger the evolution engine."
+
+## 命令
+
+### /ax-evolution evolve
+处理学习队列，更新知识库和模式库。
+
+等同于 `/ax-evolve`，调用 axiom-evolution-engine agent。
+
+### /ax-evolution reflect
+触发反思引擎，生成会话反思报告。
+
+等同于 `/ax-reflect`，调用 analyst agent 进行反思分析。
+
+### /ax-evolution knowledge [query]
+查询知识库。
+
+```
+搜索 .omc/axiom/evolution/knowledge_base.md
+返回匹配的知识条目摘要
+```
+
+### /ax-evolution patterns [query]
+查询模式库。
+
+```
+搜索 .omc/axiom/evolution/pattern_library.md
+返回匹配的代码模式和模板
+```
+
+### /ax-evolution add [content]
+手动添加知识到学习队列。
+
+```yaml
+learning_queue.add:
+  source_type: manual
+  priority: P2
+  metadata:
+    content: "[用户提供的知识]"
+    added_by: user
+```
+
+### /ax-evolution stats
+显示进化引擎统计数据。
+
+输出：
+- 知识库条目数（按分类）
+- 模式库条目数（按状态）
+- 学习队列待处理数
+- 最近进化时间
+- 知识平均置信度

package/skills/ax-evolve/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: ax-evolve
+description: "/ax-evolve — Axiom 进化工作流：处理学习队列 → 更新知识库 → 模式检测 → 生成进化报告"
+triggers: ["ax-evolve", "evolve", "反思总结", "进化", "ax-reflect"]
+---
+
+# Axiom 进化工作流
+
+本工作流处理积累的学习素材，更新知识库和模式库。
+
+**开始时宣告：** "I'm using the ax-evolve skill to process the learning queue and evolve."
+
+## 触发时机
+
+- **手动**：用户输入 `/ax-evolve`
+- **自动**：状态变为 IDLE 且学习队列不为空
+
+## 执行步骤
+
+### Step 1: 读取学习队列
+
+读取 `.omc/axiom/evolution/learning_queue.md`，按优先级排序（P0 > P1 > P2）。
+
+### Step 2: 处理队列
+
+调用 axiom-evolution-engine agent：
+
+```
+Task(subagent_type="ultrapower:axiom-evolution-engine", model="sonnet", prompt="处理以下学习队列并更新知识库：[队列内容]")
+```
+
+处理规则：
+- `code_change` 类型：提取代码模式，检查是否达到提升阈值（3次）
+- `error_fix` 类型：提取错误模式，更新 Known Issues
+- `workflow_run` 类型：更新工作流指标，生成优化建议
+
+### Step 3: 更新知识库
+
+将高置信知识（confidence >= 0.8）持久化到 project_memory：
+
+```
+project_memory_add_note(category="architecture", content="[知识内容]")
+project_memory_add_directive(directive="[高置信模式]", priority="high")
+```
+
+### Step 4: 模式检测
+
+检查 `pattern_library.md`，提升满足条件的模式：
+```
+IF occurrences >= 3 AND confidence >= 0.7
+THEN status = ACTIVE
+```
+
+### Step 5: 生成进化报告
+
+输出进化报告，包含：
+- 知识更新统计
+- 新增/提升模式
+- 工作流洞察
+- 推荐下一步
+
+### Step 6: 清理队列
+
+删除已处理的学习素材（保留 7 天内的记录）。

package/skills/ax-export/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: ax-export
+description: "/ax-export — Axiom 系统导出：将 Axiom 配置打包为可移植 zip，支持模板模式和完整模式"
+triggers: ["ax-export", "export axiom", "导出系统", "axiom export"]
+---
+
+# Axiom 系统导出
+
+本 skill 将 Axiom 系统配置导出为可移植的 zip 包，用于迁移、备份或分享。
+
+**开始时宣告：** "I'm using the ax-export skill to export the Axiom system."
+
+## 导出模式
+
+### 模板模式（template）
+
+导出干净的 Axiom 框架，不含项目特定数据：
+- 工作流文件（`.agent/workflows/*.md`）
+- Skill 文件（`.agent/skills/*/SKILL.md`）
+- 规则文件（`.agent/rules/*.rule`）
+- 配置模板（不含实际数据）
+
+**适用场景：** 在新项目中复用 Axiom 框架
+
+### 完整模式（full）
+
+导出完整系统，包含所有数据：
+- 模板模式的所有内容
+- 知识库（`.omc/knowledge/`）
+- 记忆文件（`.omc/axiom/`）
+- 项目决策记录
+- 反思日志
+
+**适用场景：** 完整备份或迁移到新环境
+
+## 执行步骤
+
+### Step 1: 确认导出模式
+
+询问用户：
+```
+选择导出模式：
+1. template — 干净框架（不含项目数据）
+2. full — 完整系统（含知识库和记忆）
+
+输入 1 或 2：
+```
+
+### Step 2: 收集文件列表
+
+**模板模式文件清单：**
+```
+.agent/workflows/
+.agent/skills/
+.agent/rules/
+.agent/config/
+skills/ax-*/SKILL.md
+```
+
+**完整模式额外包含：**
+```
+.omc/knowledge/
+.omc/axiom/
+```
+
+### Step 3: 生成导出包
+
+```bash
+# 创建临时目录
+mkdir -p /tmp/axiom-export-[timestamp]
+
+# 复制文件
+cp -r [文件列表] /tmp/axiom-export-[timestamp]/
+
+# 生成 README
+cat > /tmp/axiom-export-[timestamp]/README.md << 'EOF'
+# Axiom Export
+- 导出时间: [timestamp]
+- 导出模式: [template/full]
+- 源项目: [project-name]
+
+## 安装说明
+1. 解压到目标项目根目录
+2. 运行 /ultrapower:deepinit 初始化
+3. 运行 /ax-status 验证安装
+EOF
+
+# 打包
+cd /tmp && zip -r axiom-export-[timestamp].zip axiom-export-[timestamp]/
+```
+
+### Step 4: 输出结果
+
+```
+✓ 导出完成
+
+文件: /tmp/axiom-export-[timestamp].zip
+大小: [X] KB
+包含:
+  - 工作流: X 个
+  - Skills: X 个
+  - 规则: X 个
+  [完整模式额外:]
+  - 知识条目: X 条
+  - 记忆文件: X 个
+
+安装到新项目：
+  unzip axiom-export-[timestamp].zip -d [目标项目路径]
+```
+
+## 注意事项
+
+- 完整模式导出可能包含敏感的项目信息，分享前请检查内容
+- 模板模式适合开源分享
+- 导出包不含 `.git` 目录和 `node_modules`

package/skills/ax-implement/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: ax-implement
+description: "/ax-implement — Axiom 实施交付工作流：按 Manifest 顺序执行原子任务，含 CI 门禁和自动修复"
+triggers: ["ax-implement", "implement feature", "开始开发", "交付流水线", "ax implement"]
+---
+
+# Axiom 实施交付工作流 (Phase 3)
+
+本工作流按照 Manifest 清单顺序执行所有原子任务。
+
+**开始时宣告：** "I'm using the ax-implement skill to start the implementation workflow."
+
+## 前置条件
+
+- Manifest 存在于 `docs/tasks/[feature-id]/manifest.md`
+- 所有依赖任务已完成
+
+## 执行步骤
+
+### Step 1: 读取上下文
+
+```
+Task(subagent_type="ultrapower:axiom-context-manager", model="sonnet", prompt="read_context")
+```
+
+确认当前状态为 IDLE 或 EXECUTING。
+
+### Step 2: 按 DAG 顺序执行任务
+
+对每个任务 T-xxx：
+
+1. 更新状态：`update_state(EXECUTING)`
+2. 调用 executor 执行：
+   ```
+   Task(subagent_type="ultrapower:executor", model="sonnet", prompt="执行任务 T-xxx：[任务描述和验收条件]")
+   ```
+3. 检查输出格式：
+   - `[COMPLETE]`：更新进度，继续下一任务
+   - `[QUESTION]`：暂停，向用户询问
+   - `[BLOCKED]`：触发自动修复流程
+
+### Step 3: CI 门禁（每个任务完成后）
+
+强制执行：
+```bash
+tsc --noEmit          # 零类型错误
+npm run build         # 构建成功
+npm test              # 测试通过
+```
+
+若 CI 失败：
+- 第 1-2 次：自动修复（调用 build-fixer agent）
+- 第 3 次：输出 [BLOCKED]，请求用户介入
+
+### Step 4: 任务归档
+
+每个任务完成后：
+```
+Task(subagent_type="ultrapower:axiom-context-manager", model="sonnet", prompt="archive_task T-xxx")
+```
+
+### Step 5: 全部完成后
+
+1. 更新状态：`update_state(ARCHIVING)`
+2. 触发进化引擎：`/ax-evolve`
+3. 更新状态：`update_state(IDLE)`
+
+## 自动修复策略
+
+```
+错误发生 → 分析根因 → 尝试修复 → 重新验证
+    ↓ 失败
+换方法重试 → 重新验证
+    ↓ 失败
+输出 [BLOCKED]
+```

package/skills/ax-knowledge/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: ax-knowledge
+description: "/ax-knowledge — Axiom 知识查询：搜索知识库和模式库，返回相关条目"
+triggers: ["ax-knowledge", "knowledge query", "pattern query", "知识查询", "模式查询"]
+---
+
+# Axiom 知识查询
+
+本 skill 提供对 Axiom 知识库和模式库的统一查询接口。
+
+**开始时宣告：** "I'm using the ax-knowledge skill to query the knowledge base."
+
+## 查询类型
+
+### 知识条目查询（k-xxx）
+
+搜索 `.omc/knowledge/knowledge_base.md` 索引，返回匹配的知识条目。
+
+**触发词：** `ax-knowledge [关键词]`
+
+### 模式库查询
+
+搜索 `.omc/knowledge/pattern_library.md`，返回匹配的代码模式。
+
+**触发词：** `ax-pattern [关键词]`
+
+## 执行步骤
+
+### Step 1: 解析查询意图
+
+判断用户查询类型：
+- 包含 "pattern"、"模式"、"代码模式" → 模式库查询
+- 其他 → 知识条目查询
+- 两者都包含 → 并行查询两个库
+
+### Step 2: 搜索索引
+
+**知识库查询：**
+读取 `.omc/knowledge/knowledge_base.md`，按关键词匹配：
+- 标题匹配（权重高）
+- 标签匹配（权重中）
+- 描述匹配（权重低）
+
+**模式库查询：**
+读取 `.omc/knowledge/pattern_library.md`，按关键词匹配：
+- 模式名称
+- 触发条件
+- 适用场景
+
+### Step 3: 读取匹配条目
+
+对每个匹配结果，读取完整内容：
+- 知识条目：`.omc/knowledge/k-[slug].md`
+- 模式条目：`.omc/knowledge/patterns/[name].md`
+
+### Step 4: 格式化输出
+
+```markdown
+## 知识查询结果：[关键词]
+
+### 知识条目（X 条）
+
+#### [条目标题]
+- **ID**: k-[slug]
+- **标签**: [标签列表]
+- **核心洞见**: [一句话摘要]
+- **适用场景**: [触发条件]
+[查看完整内容: .omc/knowledge/k-[slug].md]
+
+### 代码模式（X 条）
+
+#### [模式名称]
+- **触发条件**: [何时使用]
+- **解决方案**: [简要描述]
+[查看完整内容: .omc/knowledge/patterns/[name].md]
+```
+
+### Step 5: 无结果处理
+
+若无匹配结果：
+```
+未找到与 "[关键词]" 相关的知识条目。
+
+建议：
+- 尝试更宽泛的关键词
+- 运行 /ultrapower:learner 提取当前会话的知识
+- 查看完整知识库：.omc/knowledge/knowledge_base.md
+```
+
+## 知识库文件结构
+
+```
+.omc/knowledge/
+├── knowledge_base.md      # 索引文件
+├── pattern_library.md     # 模式索引
+├── k-[slug].md            # 知识条目
+└── patterns/
+    └── [name].md          # 模式条目
+```
+
+## 与 learner skill 的关系
+
+- `ax-knowledge`：查询已有知识
+- `/ultrapower:learner`：从当前会话提取新知识并写入知识库

package/skills/ax-reflect/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: ax-reflect
+description: "/ax-reflect — Axiom 反思工作流：会话总结 → 经验提取 → Action Items → 知识入队"
+triggers: ["ax-reflect", "reflect", "反思", "总结", "session reflect"]
+---
+
+# Axiom 反思工作流
+
+本工作流在任务完成后触发系统性反思，提取经验教训。
+
+**开始时宣告：** "I'm using the ax-reflect skill to reflect on the completed work."
+
+## 触发时机
+
+- **自动**：状态从 EXECUTING 变为 ARCHIVING 时
+- **手动**：用户输入 `/ax-reflect`
+
+## 执行步骤
+
+### Step 1: 读取会话数据
+
+读取 `.omc/axiom/active_context.md`，收集：
+- 任务完成情况（完成/失败/阻塞数量）
+- 自动修复次数
+- 回滚次数
+- 耗时分布
+
+### Step 2: 生成反思报告
+
+调用 analyst agent：
+
+```
+Task(subagent_type="ultrapower:analyst", model="opus", prompt="基于以下会话数据生成反思报告：[会话数据]")
+```
+
+反思维度：
+- What Went Well（做得好的）
+- What Could Improve（可以改进的）
+- Learnings（学到了什么）
+- Action Items（待办事项）
+
+### Step 3: 持久化
+
+将反思报告追加到 `.omc/axiom/reflection_log.md`：
+
+```markdown
+## 反思 - YYYY-MM-DD HH:MM
+
+### 做得好的
+- [...]
+
+### 可以改进的
+- [...]
+
+### 学到了什么
+- [...]
+
+### Action Items
+- [ ] [REFLECTION] [待办事项]
+```
+
+### Step 4: Action Items 入队
+
+将 Action Items 追加到 `active_context.md` 的任务队列，标记为 `[REFLECTION]`。
+
+### Step 5: 知识入队
+
+将高价值 Learnings 加入学习队列，等待 `/ax-evolve` 处理。

package/skills/ax-review/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: ax-review
+description: "/ax-review — Axiom 专家评审工作流：5专家并行评审 → 冲突仲裁 → Rough PRD 生成"
+triggers: ["ax-review", "expert review", "需求评审", "专家审查", "ax review"]
+---
+
+# Axiom 专家评审工作流 (Phase 1.5)
+
+本工作流通过 5 个专家角色的视角对 PRD 初稿进行反馈和优化。
+
+**开始时宣告：** "I'm using the ax-review skill to start the expert review workflow."
+
+## 前置条件
+
+- PRD 初稿存在于 `docs/prd/[name]-draft.md`
+
+## 执行步骤
+
+### Step 1: 并行专家评审
+
+并行启动 5 个专家角色评审（使用 Task 工具并行执行）：
+
+```
+# 并行执行以下 5 个 agent
+Task(subagent_type="ultrapower:axiom-ux-director", model="sonnet", prompt="评审 PRD 初稿：[draft内容]，输出到 docs/reviews/[name]/review_ux.md")
+Task(subagent_type="ultrapower:axiom-product-director", model="sonnet", prompt="评审 PRD 初稿：[draft内容]，输出到 docs/reviews/[name]/review_product.md")
+Task(subagent_type="ultrapower:axiom-domain-expert", model="sonnet", prompt="评审 PRD 初稿：[draft内容]，输出到 docs/reviews/[name]/review_domain.md")
+Task(subagent_type="ultrapower:axiom-tech-lead", model="sonnet", prompt="评审 PRD 初稿：[draft内容]，输出到 docs/reviews/[name]/review_tech.md")
+Task(subagent_type="ultrapower:axiom-critic", model="sonnet", prompt="评审 PRD 初稿（安全/质量）：[draft内容]，输出到 docs/reviews/[name]/review_critic.md")
+```
+
+等待所有 5 份评审报告生成于 `docs/reviews/[name]/`
+
+### Step 2: 汇总与仲裁
+
+调用 `axiom-review-aggregator` agent：
+
+```
+Task(subagent_type="ultrapower:axiom-review-aggregator", model="sonnet", prompt="汇总以下 5 份评审意见并生成 Rough PRD：[5份评审内容]")
+```
+
+冲突仲裁优先级：安全 > 技术 > 战略 > 逻辑 > 体验
+
+### Step 3: 用户确认门禁
+
+展示 Rough PRD 路径，询问：
+"专家评审已完成。这是最终的粗设 PRD：`docs/prd/[name]-rough.md`。是否进入任务拆解阶段？"
+
+- **是**：调用 `/ax-decompose` skill
+- **修改**：用户可要求手动修改，如需要可重跑 Step 2
+- **否**：在此停止

package/skills/ax-rollback/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: ax-rollback
+description: "/ax-rollback — Axiom 回滚工作流：回滚到最近检查点，恢复系统状态"
+triggers: ["ax-rollback", "rollback", "回滚", "恢复状态", "undo"]
+---
+
+# Axiom 回滚工作流
+
+本工作流将系统回滚到最近的稳定检查点。
+
+**开始时宣告：** "I'm using the ax-rollback skill to rollback to the last checkpoint."
+
+## 执行步骤
+
+### Step 1: 读取检查点信息
+
+读取 `.omc/axiom/active_context.md` 中的 `last_checkpoint` 字段。
+
+显示可用检查点列表：
+```bash
+git tag -l "checkpoint-*" --sort=-version:refname | head -10
+```
+
+### Step 2: 用户确认
+
+询问用户：
+"检测到以下检查点：
+- [checkpoint-xxx] - [时间]
+- [checkpoint-yyy] - [时间]
+
+确认回滚到 [最近检查点]？这将撤销该检查点之后的所有变更。(Yes/No)"
+
+### Step 3: 执行回滚
+
+用户确认后：
+
+```bash
+# 回滚代码
+git reset --hard [checkpoint-tag]
+
+# 更新状态
+```
+
+调用 axiom-context-manager：
+```
+Task(subagent_type="ultrapower:axiom-context-manager", model="sonnet", prompt="update_state IDLE，记录回滚操作")
+```
+
+### Step 4: 验证回滚
+
+```bash
+tsc --noEmit && npm run build
+```
+
+### Step 5: 更新记忆
+
+将回滚事件记录到 `reflection_log.md`，并将回滚原因加入学习队列。
+
+## 安全规则
+
+- 回滚前必须用户确认
+- 只能回滚到 `checkpoint-*` 标签，不能回滚到任意 commit
+- 回滚后自动触发 CI 验证

package/skills/ax-status/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: ax-status
+description: "/ax-status — Axiom 状态仪表盘：显示当前任务状态、进度、记忆摘要和系统健康"
+triggers: ["ax-status", "axiom status", "查看状态", "系统状态", "status"]
+---
+
+# Axiom 状态仪表盘
+
+本 skill 提供 Axiom 系统的完整状态概览。
+
+**开始时宣告：** "I'm using the ax-status skill to show the system dashboard."
+
+## 执行步骤
+
+### Step 1: 读取所有状态文件
+
+并行读取：
+- `.omc/axiom/active_context.md` — 当前任务状态
+- `.omc/state/axiom-context.json` — 状态机状态
+- `.omc/axiom/evolution/learning_queue.md` — 待处理学习素材数量
+- `.omc/axiom/evolution/workflow_metrics.md` — 工作流指标
+
+### Step 2: 生成状态报告
+
+输出格式：
+
+```markdown
+# Axiom 状态仪表盘 - YYYY-MM-DD HH:MM
+
+## 系统状态
+- 当前状态: [IDLE/PLANNING/EXECUTING/...]
+- 上次检查点: [checkpoint-xxx]
+- 活跃任务: [T-xxx 或 无]
+
+## 任务进度
+- 总任务数: X
+- 已完成: X (X%)
+- 进行中: X
+- 阻塞: X
+
+## 记忆系统
+- 知识条目: X 条 (活跃: X, 废弃: X)
+- 代码模式: X 个 (活跃: X, 待提升: X)
+- 学习队列: X 条待处理
+- 反思日志: X 条
+
+## 工作流指标
+- 最近工作流: [名称] (成功率: X%)
+- 平均任务耗时: X 分钟
+- 自动修复成功率: X%
+
+## 推荐操作
+- [基于当前状态的建议]
+```
+
+### Step 3: 健康检查
+
+检查以下文件是否存在且格式正确：
+- `.omc/axiom/active_context.md`
+- `.omc/axiom/project_decisions.md`
+- `.omc/axiom/evolution/knowledge_base.md`
+
+若文件缺失，提示用户运行 `/ax-context init` 初始化。