omc-help

OMC 如何工作

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

自动发生的事

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

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

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

关键词	效果	示例
ralph	持久化模式	“ralph: fix all the bugs”
ralplan	迭代式规划	“ralplan this feature”
ulw	最大并行度	“ulw refactor the API”
plan	规划访谈	“plan the new endpoints”

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

停止操作

只需说：

• “stop”
• “cancel”
• “abort”

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

首次设置

如果你还没有配置 OMC：

/oh-my-claudecode:omc-setup

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

面向 2.x 用户

你的旧命令仍然有效！/ralph、/ultrawork、/omc-plan 等都与之前完全一样。

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

---

使用情况分析

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

注意：这会取代此前的 /oh-my-claudecode:learn-about-omc skill。

它会做什么

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%）且没有 ：

• “考虑将 用于日常任务以节省 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:
- : 0 uses (could save ~30% on routine tasks)
- pipeline: 0 uses (great for review workflows)

RECOMMENDATIONS:
1. Set defaultExecutionMode: "" 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