@liangjie559567/ultrapower 5.0.4

package/skills/code-review/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: code-review
+description: 运行全面的代码审查
+---
+
+# 代码审查 Skill
+
+对代码质量、安全性和可维护性进行全面审查，并提供按严重程度分级的反馈。
+
+## 使用时机
+
+此 skill 在以下情况激活：
+- 用户请求 "review this code"、"code review"
+- 合并 pull request 之前
+- 实现主要功能之后
+- 用户需要质量评估
+
+## 功能
+
+委托给 `code-reviewer` agent（Opus 模型）进行深度分析：
+
+1. **识别变更**
+   - 运行 `git diff` 查找已更改文件
+   - 确定审查范围（特定文件或整个 PR）
+
+2. **审查类别**
+   - **安全** —— 硬编码密钥、注入风险、XSS、CSRF
+   - **代码质量** —— 函数大小、复杂度、嵌套深度
+   - **性能** —— 算法效率、N+1 查询、缓存
+   - **最佳实践** —— 命名、文档、错误处理
+   - **可维护性** —— 重复、耦合、可测试性
+
+3. **严重程度评级**
+   - **CRITICAL** —— 安全漏洞（合并前必须修复）
+   - **HIGH** —— Bug 或主要代码异味（合并前应修复）
+   - **MEDIUM** —— 次要问题（尽可能修复）
+   - **LOW** —— 样式/建议（考虑修复）
+
+4. **具体建议**
+   - 每个问题的 file:line 位置
+   - 具体修复建议
+   - 适用时提供代码示例
+
+## Agent 委托
+
+```
+Task(
+  subagent_type="ultrapower:code-reviewer",
+  model="opus",
+  prompt="CODE REVIEW TASK
+
+Review code changes for quality, security, and maintainability.
+
+Scope: [git diff or specific files]
+
+Review Checklist:
+- Security vulnerabilities (OWASP Top 10)
+- Code quality (complexity, duplication)
+- Performance issues (N+1, inefficient algorithms)
+- Best practices (naming, documentation, error handling)
+- Maintainability (coupling, testability)
+
+Output: Code review report with:
+- Files reviewed count
+- Issues by severity (CRITICAL, HIGH, MEDIUM, LOW)
+- Specific file:line locations
+- Fix recommendations
+- Approval recommendation (APPROVE / REQUEST CHANGES / COMMENT)"
+)
+```
+
+## 外部模型咨询（推荐）
+
+code-reviewer agent 应咨询 Codex 进行交叉验证。
+
+### 协议
+1. **先独立完成审查** —— 独立完成审查
+2. **咨询验证** —— 与 Codex 交叉核对结论
+3. **批判性评估** —— 永不盲目采纳外部结论
+4. **优雅回退** —— 工具不可用时永不阻塞
+
+### 何时咨询
+- 安全敏感的代码变更
+- 复杂的架构模式
+- 不熟悉的代码库或语言
+- 高风险的生产代码
+
+### 何时跳过
+- 简单重构
+- 熟悉的模式
+- 时间紧迫的审查
+- 小型、独立的变更
+
+### 工具使用
+首次使用 MCP 工具前，调用 `ToolSearch("mcp")` 发现延迟加载的 MCP 工具。
+使用 `mcp__x__ask_codex` 配合 `agent_role: "code-reviewer"`。
+若 ToolSearch 未找到 MCP 工具，回退到 `code-reviewer` Claude agent。
+
+**注意：** Codex 调用最多需要 1 小时。咨询前请考虑审查时间线。
+
+## Output Format
+
+```
+CODE REVIEW REPORT
+==================
+
+Files Reviewed: 8
+Total Issues: 15
+
+CRITICAL (0)
+-----------
+(none)
+
+HIGH (3)
+--------
+1. src/api/auth.ts:42
+   Issue: User input not sanitized before SQL query
+   Risk: SQL injection vulnerability
+   Fix: Use parameterized queries or ORM
+
+2. src/components/UserProfile.tsx:89
+   Issue: Password displayed in plain text in logs
+   Risk: Credential exposure
+   Fix: Remove password from log statements
+
+3. src/utils/validation.ts:15
+   Issue: Email regex allows invalid formats
+   Risk: Accepts malformed emails
+   Fix: Use proven email validation library
+
+MEDIUM (7)
+----------
+...
+
+LOW (5)
+-------
+...
+
+RECOMMENDATION: REQUEST CHANGES
+
+Critical security issues must be addressed before merge.
+```
+
+## 审查检查清单
+
+code-reviewer agent 检查：
+
+### 安全
+- [ ] 无硬编码密钥（API keys、密码、token）
+- [ ] 所有用户输入已净化
+- [ ] SQL/NoSQL 注入防护
+- [ ] XSS 防护（转义输出）
+- [ ] 状态变更操作的 CSRF 保护
+- [ ] 认证/授权正确执行
+
+### 代码质量
+- [ ] 函数 < 50 行（指导原则）
+- [ ] 圈复杂度 < 10
+- [ ] 无深度嵌套代码（> 4 层）
+- [ ] 无重复逻辑（DRY 原则）
+- [ ] 清晰、描述性的命名
+
+### 性能
+- [ ] 无 N+1 查询模式
+- [ ] 适当的缓存
+- [ ] 高效算法（O(n) 可行时避免 O(n²)）
+- [ ] 无不必要的重渲染（React/Vue）
+
+### 最佳实践
+- [ ] 错误处理存在且适当
+- [ ] 适当级别的日志记录
+- [ ] 公共 API 的文档
+- [ ] 关键路径的测试
+- [ ] 无注释掉的代码
+
+## 批准标准
+
+**APPROVE** —— 无 CRITICAL 或 HIGH 问题，仅有次要改进
+**REQUEST CHANGES** —— 存在 CRITICAL 或 HIGH 问题
+**COMMENT** —— 仅有 LOW/MEDIUM 问题，无阻塞性关注点
+
+## 与其他 Skill 配合使用
+
+**与 Pipeline 配合：**
+```
+/pipeline review "implement user authentication"
+```
+将代码审查作为实现工作流的一部分。
+
+**与 Ralph 配合：**
+```
+/ralph code-review then fix all issues
+```
+审查代码，获取反馈，修复直到批准。
+
+**与 Ultrawork 配合：**
+```
+/ultrawork review all files in src/
+```
+跨多个文件并行代码审查。
+
+## 最佳实践
+
+- **尽早审查** —— 在问题积累前发现
+- **频繁审查** —— 小而频繁的审查优于大型审查
+- **优先处理 CRITICAL/HIGH** —— 立即修复安全和 bug
+- **考虑上下文** —— 某些"问题"可能是有意的权衡
+- **从审查中学习** —— 利用反馈改进编码实践

package/skills/configure-discord/SKILL.md

@@ -0,0 +1,244 @@
+---
+name: configure-discord
+description: 通过自然语言配置 Discord webhook/bot 通知
+triggers:
+  - "configure discord"
+  - "setup discord"
+  - "discord notifications"
+  - "discord webhook"
+---
+
+# 配置 Discord 通知
+
+设置 Discord 通知，让 OMC 在会话结束、需要输入或完成后台任务时通知你。
+
+## 此 Skill 的工作方式
+
+这是一个交互式自然语言配置 skill。通过 AskUserQuestion 引导用户完成设置。将结果写入 `~/.claude/.omc-config.json`。
+
+## 步骤 1：检测现有配置
+
+```bash
+CONFIG_FILE="$HOME/.claude/.omc-config.json"
+
+if [ -f "$CONFIG_FILE" ]; then
+  # Check for existing discord config
+  HAS_DISCORD=$(jq -r '.notifications.discord.enabled // false' "$CONFIG_FILE" 2>/dev/null)
+  HAS_DISCORD_BOT=$(jq -r '.notifications["discord-bot"].enabled // false' "$CONFIG_FILE" 2>/dev/null)
+  WEBHOOK_URL=$(jq -r '.notifications.discord.webhookUrl // empty' "$CONFIG_FILE" 2>/dev/null)
+  MENTION=$(jq -r '.notifications.discord.mention // empty' "$CONFIG_FILE" 2>/dev/null)
+
+  if [ "$HAS_DISCORD" = "true" ] || [ "$HAS_DISCORD_BOT" = "true" ]; then
+    echo "EXISTING_CONFIG=true"
+    echo "WEBHOOK_CONFIGURED=$HAS_DISCORD"
+    echo "BOT_CONFIGURED=$HAS_DISCORD_BOT"
+    [ -n "$WEBHOOK_URL" ] && echo "WEBHOOK_URL=$WEBHOOK_URL"
+    [ -n "$MENTION" ] && echo "MENTION=$MENTION"
+  else
+    echo "EXISTING_CONFIG=false"
+  fi
+else
+  echo "NO_CONFIG_FILE"
+fi
+```
+
+若找到现有配置，向用户显示当前配置并询问是否要更新或重新配置。
+
+## 步骤 2：选择 Discord 方式
+
+使用 AskUserQuestion：
+
+**问题：** "How would you like to send Discord notifications?"
+
+**选项：**
+1. **Webhook（推荐）** —— 在 Discord 频道中创建 webhook。简单，无需 bot。只需粘贴 URL。
+2. **Bot API** —— 使用 Discord bot token + 频道 ID。更灵活，需要 bot 应用程序。
+
+## 步骤 3A：Webhook 设置
+
+若用户选择 Webhook：
+
+使用 AskUserQuestion：
+
+**问题：** "Paste your Discord webhook URL. To create one: Server Settings > Integrations > Webhooks > New Webhook > Copy URL"
+
+用户将在 "Other" 字段中输入 webhook URL。
+
+**验证** URL：
+- 必须以 `https://discord.com/api/webhooks/` 或 `https://discordapp.com/api/webhooks/` 开头
+- 若无效，解释格式并再次询问
+
+## 步骤 3B：Bot API 设置
+
+若用户选择 Bot API：
+
+询问两个问题：
+
+1. **"Paste your Discord bot token"** —— 来自 discord.com/developers > Your App > Bot > Token
+2. **"Paste the channel ID"** —— 右键点击频道 > Copy Channel ID（需要开发者模式）
+
+## 步骤 4：配置提及（用户 Ping）
+
+使用 AskUserQuestion：
+
+**问题：** "Would you like notifications to mention (ping) someone?"
+
+**选项：**
+1. **Yes, mention a user** —— 通过 Discord 用户 ID 标记特定用户
+2. **Yes, mention a role** —— 通过角色 ID 标记角色
+3. **No mentions** —— 仅发布消息而不 ping 任何人
+
+### 若用户想提及用户：
+
+询问："What is the Discord user ID to mention? (Right-click user > Copy User ID, requires Developer Mode)"
+
+The mention format is: `<@USER_ID>` (e.g., `<@1465264645320474637>`)
+
+### 若用户想提及角色：
+
+询问："What is the Discord role ID to mention? (Server Settings > Roles > right-click role > Copy Role ID)"
+
+## 步骤 5：配置事件
+
+使用带 multiSelect 的 AskUserQuestion：
+
+**问题：** "Which events should trigger Discord notifications?"
+
+**选项（multiSelect: true）：**
+1. **Session end（推荐）** —— Claude 会话结束时
+2. **Input needed** —— Claude 等待你回应时（适合长时间运行的任务）
+3. **Session start** —— 新会话开始时
+4. **Session continuing** —— 持久化模式保持会话活跃时
+
+默认选择：session-end + ask-user-question。
+
+## 步骤 6：可选用户名覆盖
+
+使用 AskUserQuestion：
+
+**问题：** "Custom bot display name? (Shows as the webhook sender name in Discord)"
+
+**选项：**
+1. **OMC（默认）** —— 显示为 "OMC"
+2. **Claude Code** —— 显示为 "Claude Code"
+3. **Custom** —— 输入自定义名称
+
+## 步骤 7：写入配置
+
+读取现有配置，合并新的 Discord 设置并写回：
+
+```bash
+CONFIG_FILE="$HOME/.claude/.omc-config.json"
+mkdir -p "$(dirname "$CONFIG_FILE")"
+
+if [ -f "$CONFIG_FILE" ]; then
+  EXISTING=$(cat "$CONFIG_FILE")
+else
+  EXISTING='{}'
+fi
+```
+
+### For Webhook method:
+
+Build the notifications object with the collected values and merge into `.omc-config.json` using jq:
+
+```bash
+# WEBHOOK_URL, MENTION, USERNAME are collected from user
+# EVENTS is the list of enabled events
+
+echo "$EXISTING" | jq \
+  --arg url "$WEBHOOK_URL" \
+  --arg mention "$MENTION" \
+  --arg username "$USERNAME" \
+  '.notifications = (.notifications // {enabled: true}) |
+   .notifications.enabled = true |
+   .notifications.discord = {
+     enabled: true,
+     webhookUrl: $url,
+     mention: (if $mention == "" then null else $mention end),
+     username: (if $username == "" then null else $username end)
+   }' > "$CONFIG_FILE"
+```
+
+### For Bot API method:
+
+```bash
+echo "$EXISTING" | jq \
+  --arg token "$BOT_TOKEN" \
+  --arg channel "$CHANNEL_ID" \
+  --arg mention "$MENTION" \
+  '.notifications = (.notifications // {enabled: true}) |
+   .notifications.enabled = true |
+   .notifications["discord-bot"] = {
+     enabled: true,
+     botToken: $token,
+     channelId: $channel,
+     mention: (if $mention == "" then null else $mention end)
+   }' > "$CONFIG_FILE"
+```
+
+### Add event-specific config if user didn't select all events:
+
+For each event NOT selected, disable it:
+
+```bash
+# Example: disable session-start if not selected
+echo "$(cat "$CONFIG_FILE")" | jq \
+  '.notifications.events = (.notifications.events // {}) |
+   .notifications.events["session-start"] = {enabled: false}' > "$CONFIG_FILE"
+```
+
+## 步骤 8：测试配置
+
+写入配置后，提供发送测试通知的选项：
+
+使用 AskUserQuestion：
+
+**问题：** "Send a test notification to verify the setup?"
+
+**选项：**
+1. **Yes, test now（推荐）** —— 向你的 Discord 频道发送测试消息
+2. **No, I'll test later** —— 跳过测试
+
+报告成功或失败。若失败，帮助用户调试（检查 URL、权限等）。
+
+## 步骤 9：确认
+
+显示最终配置摘要：
+
+```
+Discord Notifications Configured!
+
+  Method:   Webhook / Bot API
+  Mention:  <@1465264645320474637> (or "none")
+  Events:   session-end, ask-user-question
+  Username: OMC
+
+Config saved to: ~/.claude/.omc-config.json
+
+You can also set these via environment variables:
+  OMC_DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...
+  OMC_DISCORD_MENTION=<@1465264645320474637>
+
+To reconfigure: /ultrapower:configure-discord
+To configure Telegram: /ultrapower:configure-telegram
+```
+
+## 环境变量替代方案
+
+用户可以通过在 shell 配置文件中设置环境变量来完全跳过此向导：
+
+**Webhook 方式：**
+```bash
+export OMC_DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..."
+export OMC_DISCORD_MENTION="<@1465264645320474637>"  # optional
+```
+
+**Bot API 方式：**
+```bash
+export OMC_DISCORD_NOTIFIER_BOT_TOKEN="your-bot-token"
+export OMC_DISCORD_NOTIFIER_CHANNEL="your-channel-id"
+export OMC_DISCORD_MENTION="<@1465264645320474637>"  # optional
+```
+
+环境变量由通知系统自动检测，无需 `.omc-config.json`。

package/skills/configure-telegram/SKILL.md

@@ -0,0 +1,232 @@
+---
+name: configure-telegram
+description: 通过自然语言配置 Telegram bot 通知
+triggers:
+  - "configure telegram"
+  - "setup telegram"
+  - "telegram notifications"
+  - "telegram bot"
+---
+
+# 配置 Telegram 通知
+
+设置 Telegram 通知，让 OMC 在会话结束、需要输入或完成后台任务时向你发送消息。
+
+## 此 Skill 的工作方式
+
+这是一个交互式自然语言配置 skill。通过 AskUserQuestion 引导用户完成设置。将结果写入 `~/.claude/.omc-config.json`。
+
+## 步骤 1：检测现有配置
+
+```bash
+CONFIG_FILE="$HOME/.claude/.omc-config.json"
+
+if [ -f "$CONFIG_FILE" ]; then
+  HAS_TELEGRAM=$(jq -r '.notifications.telegram.enabled // false' "$CONFIG_FILE" 2>/dev/null)
+  CHAT_ID=$(jq -r '.notifications.telegram.chatId // empty' "$CONFIG_FILE" 2>/dev/null)
+  PARSE_MODE=$(jq -r '.notifications.telegram.parseMode // "Markdown"' "$CONFIG_FILE" 2>/dev/null)
+
+  if [ "$HAS_TELEGRAM" = "true" ]; then
+    echo "EXISTING_CONFIG=true"
+    echo "CHAT_ID=$CHAT_ID"
+    echo "PARSE_MODE=$PARSE_MODE"
+  else
+    echo "EXISTING_CONFIG=false"
+  fi
+else
+  echo "NO_CONFIG_FILE"
+fi
+```
+
+若找到现有配置，向用户显示当前配置并询问是否要更新或重新配置。
+
+## 步骤 2：创建 Telegram Bot
+
+若用户没有 bot，引导其创建：
+
+```
+To set up Telegram notifications, you need a Telegram bot token and your chat ID.
+
+CREATE A BOT (if you don't have one):
+1. Open Telegram and search for @BotFather
+2. Send /newbot
+3. Choose a name (e.g., "My OMC Notifier")
+4. Choose a username (e.g., "my_omc_bot")
+5. BotFather will give you a token like: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
+
+GET YOUR CHAT ID:
+1. Start a chat with your new bot (send /start)
+2. Visit: https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
+3. Look for "chat":{"id":YOUR_CHAT_ID}
+   - Personal chat IDs are positive numbers (e.g., 123456789)
+   - Group chat IDs are negative numbers (e.g., -1001234567890)
+```
+
+## 步骤 3：收集 Bot Token
+
+使用 AskUserQuestion：
+
+**问题：** "Paste your Telegram bot token (from @BotFather)"
+
+用户将在 "Other" 字段中输入 token。
+
+**验证** token：
+- 必须匹配模式：`digits:alphanumeric`（如 `123456789:ABCdefGHI...`）
+- 若无效，解释格式并再次询问
+
+## 步骤 4：收集 Chat ID
+
+使用 AskUserQuestion：
+
+**问题：** "Paste your Telegram chat ID (the number from getUpdates API)"
+
+用户将在 "Other" 字段中输入 chat ID。
+
+**验证** chat ID：
+- 必须是数字（个人为正数，群组为负数）
+- 若无效，提供帮助查找：
+
+```bash
+# Help user find their chat ID
+BOT_TOKEN="USER_PROVIDED_TOKEN"
+echo "Fetching recent messages to find your chat ID..."
+curl -s "https://api.telegram.org/bot${BOT_TOKEN}/getUpdates" | jq '.result[-1].message.chat.id // .result[-1].message.from.id // "No messages found - send /start to your bot first"'
+```
+
+## 步骤 5：选择解析模式
+
+使用 AskUserQuestion：
+
+**问题：** "Which message format do you prefer?"
+
+**选项：**
+1. **Markdown（推荐）** —— 使用 Markdown 语法的粗体、斜体、代码块
+2. **HTML** —— 使用 HTML 标签的粗体、斜体、代码
+
+## 步骤 6：配置事件
+
+使用带 multiSelect 的 AskUserQuestion：
+
+**问题：** "Which events should trigger Telegram notifications?"
+
+**选项（multiSelect: true）：**
+1. **Session end（推荐）** —— Claude 会话结束时
+2. **Input needed** —— Claude 等待你回应时（适合长时间运行的任务）
+3. **Session start** —— 新会话开始时
+4. **Session continuing** —— 持久化模式保持会话活跃时
+
+默认选择：session-end + ask-user-question。
+
+## 步骤 7：写入配置
+
+读取现有配置，合并新的 Telegram 设置并写回：
+
+```bash
+CONFIG_FILE="$HOME/.claude/.omc-config.json"
+mkdir -p "$(dirname "$CONFIG_FILE")"
+
+if [ -f "$CONFIG_FILE" ]; then
+  EXISTING=$(cat "$CONFIG_FILE")
+else
+  EXISTING='{}'
+fi
+
+# BOT_TOKEN, CHAT_ID, PARSE_MODE are collected from user
+echo "$EXISTING" | jq \
+  --arg token "$BOT_TOKEN" \
+  --arg chatId "$CHAT_ID" \
+  --arg parseMode "$PARSE_MODE" \
+  '.notifications = (.notifications // {enabled: true}) |
+   .notifications.enabled = true |
+   .notifications.telegram = {
+     enabled: true,
+     botToken: $token,
+     chatId: $chatId,
+     parseMode: $parseMode
+   }' > "$CONFIG_FILE"
+```
+
+### 若用户未选择所有事件，添加事件特定配置：
+
+对每个未选择的事件，禁用它：
+
+```bash
+# Example: disable session-start if not selected
+echo "$(cat "$CONFIG_FILE")" | jq \
+  '.notifications.events = (.notifications.events // {}) |
+   .notifications.events["session-start"] = {enabled: false}' > "$CONFIG_FILE"
+```
+
+## 步骤 8：测试配置
+
+写入配置后，提供发送测试通知的选项：
+
+使用 AskUserQuestion：
+
+**问题：** "Send a test notification to verify the setup?"
+
+**选项：**
+1. **Yes, test now (Recommended)** - 向你的 Telegram 聊天发送测试消息
+2. **No, I'll test later** - 跳过测试
+
+### 若测试：
+
+```bash
+BOT_TOKEN="USER_PROVIDED_TOKEN"
+CHAT_ID="USER_PROVIDED_CHAT_ID"
+PARSE_MODE="Markdown"
+
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  "https://api.telegram.org/bot${BOT_TOKEN}/sendMessage" \
+  -d "chat_id=${CHAT_ID}" \
+  -d "parse_mode=${PARSE_MODE}" \
+  -d "text=OMC test notification - Telegram is configured!")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -1)
+BODY=$(echo "$RESPONSE" | head -1)
+
+if [ "$HTTP_CODE" = "200" ]; then
+  echo "Test notification sent successfully!"
+else
+  echo "Failed (HTTP $HTTP_CODE):"
+  echo "$BODY" | jq -r '.description // "Unknown error"' 2>/dev/null || echo "$BODY"
+fi
+```
+
+报告成功或失败。常见问题：
+- **401 Unauthorized**：Bot token 无效
+- **400 Bad Request: chat not found**：Chat ID 错误，或用户未向 bot 发送 `/start`
+- **Network error**：检查与 api.telegram.org 的连接
+
+## 步骤 9：确认
+
+显示最终配置摘要：
+
+```
+Telegram Notifications Configured!
+
+  Bot:        @your_bot_username
+  Chat ID:    123456789
+  Format:     Markdown
+  Events:     session-end, ask-user-question
+
+Config saved to: ~/.claude/.omc-config.json
+
+You can also set these via environment variables:
+  OMC_TELEGRAM_BOT_TOKEN=123456789:ABCdefGHI...
+  OMC_TELEGRAM_CHAT_ID=123456789
+
+To reconfigure: /ultrapower:configure-telegram
+To configure Discord: /ultrapower:configure-discord
+```
+
+## 环境变量替代方案
+
+用户可以通过在 shell 配置文件中设置环境变量来完全跳过此向导：
+
+```bash
+export OMC_TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
+export OMC_TELEGRAM_CHAT_ID="123456789"
+```
+
+环境变量由通知系统自动检测，无需 `.omc-config.json`。