名称: omc-help 描述: 关于使用oh-my-claudecode插件的指南
OMC如何工作
您不需要学习任何命令! OMC通过自动激活的智能行为增强Claude Code。
自动发生的情况
| 当您… | 我自动… |
|---|---|
| 给我一个复杂任务 | 并行化并委托给专业代理 |
| 要求我计划某事 | 开始计划访谈 |
| 需要某事完全完成 | 坚持直到验证完成 |
| 处理UI/前端工作 | 激活设计感知 |
| 说“stop”或“cancel” | 智能停止当前操作 |
魔法关键词(可选快捷键)
您可以在请求中自然包含这些词以进行显式控制:
| 关键词 | 效果 | 示例 |
|---|---|---|
| ralph | 持久模式 | “ralph: 修复所有错误” |
| 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技能。
它做什么
- 从
~/.omc/state/token-tracking.jsonl读取令牌跟踪 - 从
.omc/state/session-history.json读取会话历史 - 分析代理使用模式
- 识别未充分利用的功能
- 推荐配置更改
步骤1:收集数据
# 检查令牌跟踪数据
TOKEN_FILE="$HOME/.omc/state/token-tracking.jsonl"
SESSION_FILE=".omc/state/session-history.json"
CONFIG_FILE="$HOME/.claude/.omc-config.json"
echo "分析OMC使用情况..."
echo ""
# 检查可用数据
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_COUNT"
fi
if [[ -f "$SESSION_FILE" ]]; then
HAS_SESSIONS=true
SESSION_COUNT=$(cat "$SESSION_FILE" | jq '.sessions | length' 2>/dev/null || echo "0")
echo "找到会话: $SESSION_COUNT"
fi
if [[ -f "$CONFIG_FILE" ]]; then
HAS_CONFIG=true
DEFAULT_MODE=$(cat "$CONFIG_FILE" | jq -r '.defaultExecutionMode // "not set"')
echo "默认执行模式: $DEFAULT_MODE"
fi
步骤2:分析代理使用情况(如果令牌数据存在)
if [[ "$HAS_TOKENS" == "true" ]]; then
echo ""
echo "按使用量排名前代理:"
cat "$TOKEN_FILE" | jq -r '.agentName // "main"' | sort | uniq -c | sort -rn | head -10
echo ""
echo "模型分布:"
cat "$TOKEN_FILE" | jq -r '.modelName' | sort | uniq -c | sort -rn
fi
步骤3:生成建议
基于发现的模式,输出建议:
如果Opus使用率高(>40%)且无:
- “考虑使用以节省令牌”
如果无管道使用:
- “尝试/pipeline进行代码审查工作流程”
如果无安全审查员使用:
- “在身份验证/API更改后使用安全审查员”
如果defaultExecutionMode未设置:
- “在/omc-setup中设置defaultExecutionMode以保持行为一致”
步骤4:输出报告
格式化摘要,包括:
- 令牌摘要(总计,按模型)
- 使用最多的代理
- 未充分利用的功能
- 个性化建议
示例输出
📊 您的OMC使用分析
TOKEN SUMMARY:
- 总记录: 1,234
- 按模型: 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
优雅降级
如果未找到数据:
📊 可用使用数据有限
未找到令牌跟踪。要启用跟踪:
1. 确保~/.omc/state/目录存在
2. 运行任何OMC命令以开始跟踪
提示:运行/omc-setup以正确配置OMC。
需要更多帮助?
- README: https://github.com/Yeachan-Heo/oh-my-claudecode
- Issues: https://github.com/Yeachan-Heo/oh-my-claudecode/issues
版本: 4.2.3