help

OMC 的工作原理

你不需要学习任何命令！ OMC 通过自动激活的智能行为来增强 Claude Code。

自动发生的事

当你……	我会自动……
给我一个复杂任务	并行处理并委派给专家 Agent
让我规划某件事	启动规划访谈
需要彻底完成某件事	坚持直到验证完成为止
处理 UI/前端	激活设计感知力
说 "stop" 或 "cancel"	智能停止当前操作

魔法关键词（可选快捷方式）

你可以在请求中自然地包含这些词，以获得显式控制：

关键词	效果	示例
ralph	持久模式	"ralph: 修复所有 bug"
ralplan	迭代式规划	"ralplan 这个功能"
ulw	最大并行度	"ulw 重构 API"
plan	规划访谈	"plan 新端点"

ralph 包含 ultrawork： 当你激活 ralph 模式时，它会自动包含 ultrawork 的并行执行。无需组合关键词。

停止操作

只需说：

• "stop"
• "cancel"
• "abort"

我会根据上下文判断要停止什么。

首次设置

如果你还没有配置 OMC：

/oh-my-claudecode:omc-setup

这是你唯一需要知道的命令。它会下载配置，然后你就完成了。

致 2.x 用户

你的旧命令仍然可用！/ralph、/ultrawork、/plan 等都与之前完全一样地工作。

但现在你不再需要它们——一切都是自动的。

---

使用情况分析

分析你的 oh-my-claudecode 使用情况，并获得量身定制的建议来改进你的工作流。

注意：这将取代之前的 /oh-my-claudecode:learn-about-omc 技能。

它的作用

1. 从 ~/.omc/state/token-tracking.jsonl 读取 token 跟踪数据
2. 从 .omc/state/session-history.json 读取会话历史
3. 分析 Agent 使用模式
4. 识别未充分利用的功能
5. 推荐配置更改

第 1 步：收集数据

# Check for token tracking data
TOKEN_FILE="$HOME/.omc/state/token-tracking.jsonl"
SESSION_FILE=".omc/state/session-history.json"
CONFIG_FILE="$HOME/.claude/.omc-config.json"

echo "Analyzing OMC Usage..."
echo ""

# Check what data is available
HAS_TOKENS=false
HAS_SESSIONS=false
HAS_CONFIG=false

if [[ -f "$TOKEN_FILE" ]]; then
  HAS_TOKENS=true
  TOKEN_COUNT=$(wc -l < "$TOKEN_FILE")
  echo "Token records found: $TOKEN_COUNT"
fi

if [[ -f "$SESSION_FILE" ]]; then
  HAS_SESSIONS=true
  SESSION_COUNT=$(cat "$SESSION_FILE" | jq '.sessions | length' 2>/dev/null || echo "0")
  echo "Sessions found: $SESSION_COUNT"
fi

if [[ -f "$CONFIG_FILE" ]]; then
  HAS_CONFIG=true
  DEFAULT_MODE=$(cat "$CONFIG_FILE" | jq -r '.defaultExecutionMode // "not set"')
  echo "Default execution mode: $DEFAULT_MODE"
fi

第 2 步：分析 Agent 使用情况（如果存在 token 数据）

if [[ "$HAS_TOKENS" == "true" ]]; then
  echo ""
  echo "TOP AGENTS BY USAGE:"
  cat "$TOKEN_FILE" | jq -r '.agentName // "main"' | sort | uniq -c | sort -rn | head -10

  echo ""
  echo "MODEL DISTRIBUTION:"
  cat "$TOKEN_FILE" | jq -r '.modelName' | sort | uniq -c | sort -rn
fi

第 3 步：生成建议

根据发现的模式，输出建议：

如果 Opus 使用率较高（>40%）且未使用 ecomode：

• "考虑对常规任务使用 ecomode 以节省 token"

如果未使用 pipeline：

• "尝试使用 /pipeline 进行代码审查工作流"

如果未使用 security-reviewer：

• "在 auth/API 变更后使用 security-reviewer"

如果未设置 defaultExecutionMode：

• "在 /omc-setup 中设置 defaultExecutionMode 以获得一致的行为"

第 4 步：输出报告

格式化摘要，包含：

• Token 摘要（总量、按模型）
• 最常用的 Agent
• 未充分利用的功能
• 个性化建议

示例输出

📊 Your OMC Usage Analysis

TOKEN SUMMARY:
- Total records: 1,234
- By Model: opus 45%, sonnet 40%, haiku 15%

TOP AGENTS:
1. executor (234 uses)
2. architect (89 uses)
3. explore (67 uses)

UNDERUTILIZED FEATURES:
- ecomode: 0 uses (could save ~30% on routine tasks)
- pipeline: 0 uses (great for review workflows)

RECOMMENDATIONS:
1. Set defaultExecutionMode: "ecomode" to save tokens
2. Try /pipeline review for PR reviews
3. Use explore agent before architect to save context

优雅降级

如果未找到数据：

📊 Limited Usage Data Available

No token tracking found. To enable tracking:
1. Ensure ~/.omc/state/ directory exists
2. Run any OMC command to start tracking

Tip: Run /omc-setup to configure OMC properly.

需要更多帮助？

• README：https://github.com/Yeachan-Heo/oh-my-claudecode
• Issues：https://github.com/Yeachan-Heo/oh-my-claudecode/issues

---

版本：4.2.3