初始化设置 (Setup)

OMC 框架的项目启动器 - 快速初始化新项目

什么是 Setup？

Setup 帮助快速启动新项目：

项目结构创建
依赖安装
基础配置
开发环境就绪

安装 OMC

1. 安装 OMC

# 通过 npm
npm install -g oh-my-claudecode

# 或通过 Homebrew
brew install oh-my-claudecode

2. 验证安装

omc --version
omc doctor

创建新项目

基本用法

# 创建新项目
omc setup new my-project

# 指定模板
omc setup new my-project --template react
omc setup new my-project --template vue
omc setup new my-project --template node
omc setup new my-project --template python

初始化现有项目

# 在已有项目目录
omc setup init

# 指定技能集
omc setup init --skills plan,ralph,autopilot

创建的内容

1. 项目结构

my-project/
├── .omc/
│   ├── config.json
│   ├── skills/
│   └── state/
├── src/
├── tests/
├── docs/
└── README.md

2. 配置文件

.omc/config.json - OMC 配置
.claude/settings.json - Claude 配置

3. 自动化

Git hooks
CI/CD 模板

OMC 配置

基本配置

{
  "skills": {
    "plan": { "enabled": true },
    "ralph": { "enabled": true },
    "autopilot": { "enabled": true },
    "team": { "enabled": true }
  },
  "mcp": {
    "enabled": true,
    "services": ["filesystem", "git", "bash"]
  }
}

环境变量

export OMC_DEBUG=true
export OMC_LOG_LEVEL=info
export OMC_DATA_PATH=~/.omc

验证和维护

运行诊断

omc doctor              # 检查安装
omc doctor --verbose   # 详细诊断
omc doctor --fix       # 自动修复

常见问题

问题	解决方案
技能不加载	`omc setup --repair`
MCP 连接失败	检查网络和配置
权限问题	检查文件权限

官方文档: setup/SKILL.md