help

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

How OMC Works

OMC 工作原理

You don't need to learn any commands! OMC enhances Claude Code with intelligent behaviors that activate automatically.

你无需学习任何命令！ OMC 为 Claude Code 增添了可自动激活的智能行为。

What Happens Automatically

自动执行的操作

When You...	I Automatically...
Give me a complex task	Parallelize and delegate to specialist agents
Ask me to plan something	Start a planning interview
Need something done completely	Persist until verified complete
Work on UI/frontend	Activate design sensibility
Say "stop" or "cancel"	Intelligently stop current operation

当你...	我会自动...
交给我一项复杂任务	并行处理并委托给专家Agent
让我规划某件事	启动规划访谈
需要完全完成某项工作	持续执行直到验证完成
处理UI/前端相关工作	激活设计敏感度
说"stop"或"cancel"	智能停止当前操作

Magic Keywords (Optional Shortcuts)

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

You can include these words naturally in your request for explicit control:

Keyword	Effect	Example
ralph	Persistence mode	"ralph: fix all the bugs"
ralplan	Iterative planning	"ralplan this feature"
ulw	Max parallelism	"ulw refactor the API"
plan	Planning interview	"plan the new endpoints"

ralph includes ultrawork: When you activate ralph mode, it automatically includes ultrawork's parallel execution. No need to combine keywords.

你可以在请求中自然加入这些词汇，以获得明确的控制权：

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

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

Stopping Things

停止操作

Just say:

"stop"
"cancel"
"abort"

I'll figure out what to stop based on context.

只需说出：

"stop"
"cancel"
"abort"

我会根据上下文判断需要停止的内容。

First Time Setup

首次设置

If you haven't configured OMC yet:

/oh-my-claudecode:omc-setup

This is the only command you need to know. It downloads the configuration and you're done.

如果你还未配置OMC：

/oh-my-claudecode:omc-setup

这是你唯一需要了解的命令。它会下载配置文件，完成后即可使用。

For 2.x Users

针对2.x版本用户

Your old commands still work!

/ralph

/ultrawork

/plan

, etc. all function exactly as before.

But now you don't NEED them - everything is automatic.

你之前的命令仍然可用！

/ralph

、

/ultrawork

、

/plan

等命令的功能与之前完全一致。

但现在你不再需要使用它们——所有操作都是自动的。

Usage Analysis

使用情况分析

Analyze your oh-my-claudecode usage and get tailored recommendations to improve your workflow.

Note: This replaces the former
/oh-my-claudecode:learn-about-omc
skill.

分析你的oh-my-claudecode使用情况，获取定制化建议以优化你的工作流。

注意：此功能替代了之前的
/oh-my-claudecode:learn-about-omc
技能。

What It Does

功能说明

Reads token tracking from
```
~/.omc/state/token-tracking.jsonl
```
Reads session history from
```
.omc/state/session-history.json
```
Analyzes agent usage patterns
Identifies underutilized features
Recommends configuration changes

读取
```
~/.omc/state/token-tracking.jsonl
```
中的令牌追踪数据
读取
```
.omc/state/session-history.json
```
中的会话历史
分析Agent使用模式
识别未充分利用的功能
推荐配置变更

Step 1: Gather Data

步骤1：收集数据

bash

undefined

bash

undefined

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 ""

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

undefined

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

undefined

Step 2: Analyze Agent Usage (if token data exists)

步骤2：分析Agent使用情况（如果有令牌数据）

bash

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

bash

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

Step 3: Generate Recommendations

步骤3：生成建议

Based on patterns found, output recommendations:

If high Opus usage (>40%) and no ecomode:

"Consider using ecomode for routine tasks to save tokens"

If no pipeline usage:

"Try /pipeline for code review workflows"

If no security-reviewer usage:

"Use security-reviewer after auth/API changes"

If defaultExecutionMode not set:

"Set defaultExecutionMode in /omc-setup for consistent behavior"

基于发现的模式，输出建议：

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

"考虑对常规任务使用ecomode以节省令牌"

如果未使用pipeline功能：

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

如果未使用security-reviewer：

"在完成认证/API变更后使用security-reviewer"

如果未设置defaultExecutionMode：

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

Step 4: Output Report

步骤4：输出报告

Format a summary with:

Token summary (total, by model)
Top agents used
Underutilized features
Personalized recommendations

格式化包含以下内容的摘要：

令牌摘要（总数、按模型分类）
使用最多的Agent
未充分利用的功能
个性化建议

Example Output

示例输出

📊 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

📊 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

Graceful Degradation

优雅降级

If no data found:

📊 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.

如果未找到数据：

📊 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.

Need More Help?

需要更多帮助？

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

Version: 4.2.2

README文档：https://github.com/Yeachan-Heo/oh-my-claudecode
问题反馈：https://github.com/Yeachan-Heo/oh-my-claudecode/issues

版本：4.2.2