# oh-my-ashclaw

Ash-Claw 多智能体编排系统 - 零学习曲线，最大威力。

> 基于 [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) 改造，适配 ash-claw CLI。

---

## 功能特性

- **零配置** - 开箱即用，智能默认值
- **团队优先编排** - Team 是核心多智能体协作面
- **自然语言界面** - 无需记忆命令，只需描述你想要什么
- **自动并行化** - 复杂任务自动分配给专业代理
- **持久执行** - 直到任务验证完成才会停止
- **成本优化** - 智能模型路由节省 30-50% tokens
- **经验学习** - 自动提取并重用问题解决模式

---

## 安装指南

### 前提条件

- [ash-claw](https://github.com/anthropics/claude-code) CLI 已安装
- Ash-Claw Max/Pro 订阅或 API 密钥

### 方式一：一键安装脚本（推荐）

将 `oh-my-ashclaw` 目录复制到目标电脑后：

**Windows：**
```cmd
cd oh-my-ashclaw
install.bat
```

**Linux/macOS：**
```bash
cd oh-my-ashclaw
chmod +x install.sh
./install.sh
```

脚本会自动完成：
- ✅ 检查 ash-claw 是否安装
- ✅ 检查并安装 ripgrep（支持 winget/scoop/choco/npm/手动下载）
- ✅ 添加插件到 Marketplace
- ✅ 安装插件
- ✅ 验证安装结果

### 方式二：手动安装

```bash
# Step 1: 添加到 Marketplace
ash-claw plugin marketplace add /path/to/oh-my-ashclaw

# Step 2: 安装插件
ash-claw plugin install oh-my-ashclaw

# Step 3: 安装 ripgrep
# Windows (npm 方式，最通用):
npm install -g ripgrep
# 或者直接下载 rg.exe: https://github.com/BurntSushi/ripgrep/releases
# 国内镜像: https://ghfast.top/https://github.com/BurntSushi/ripgrep/releases

# Linux:
sudo apt install ripgrep          # Ubuntu/Debian
sudo dnf install ripgrep          # Fedora
sudo pacman -S ripgrep            # Arch

# macOS:
brew install ripgrep

# Step 4: 启动 ash-claw 并运行设置
ash-claw
# 进入会话后输入:
/setup
```

### 方式三：免安装模式

```bash
ash-claw --plugin-dir /path/to/oh-my-ashclaw
```

### 方式四：npm 全局安装

```bash
cd /path/to/oh-my-ashclaw
npm install
npm run build
npm link
```

然后使用：

```bash
omac setup
omac launch
```

---

## 快速开始

### Step 1: 安装插件

```bash
ash-claw plugin marketplace add /path/to/oh-my-ashclaw
ash-claw plugin install oh-my-ashclaw
```

### Step 2: 运行 Setup

在 ash-claw 会话中：

```
/setup
```

或从终端：

```bash
omac setup
```

### Step 3: 开始使用

```
/autopilot "构建一个任务管理的 REST API"
```

或使用关键词触发：

```
autopilot: 构建一个任务管理的 REST API
```

---

## 可用技能

### 工作流技能

| 技能 | 说明 | 示例 |
|------|------|------|
| `/autopilot` | 全自主执行（从想法到代码） | `/autopilot "构建一个 todo 应用"` |
| `/ralph` | 持久模式（验证修复循环） | `/ralph "重构认证模块"` |
| `/ultrawork` | 最大并行化 | `/ultrawork "修复所有错误"` |
| `/team` | 多 Agent 协同任务 | `/team 3:executor "修复所有 TypeScript 错误"` |
| `/ultraqa` | QA 循环测试验证 | `/ultraqa` |
| `/verify` | 验证变更是否真正生效 | `/verify` |
| `/trace` | 证据驱动的因果追踪 | `/trace` |
| `/deep-interview` | 两阶段调研（苏格拉底式需求澄清） | `/deep-interview "我想构建一个任务管理应用"` |
| `/ralplan` | 迭代共识规划 | `/ralplan "规划这个功能"` |
| `/plan` | 战略规划 | `/plan` |

### 工具技能

| 技能 | 说明 |
|------|------|
| `/debug` | 诊断当前会话或仓库状态 |
| `/self-improve` | 自主代码进化引擎 |
| `/wiki` | LLM 知识库 |
| `/skill` | 管理本地技能 |
| `/doctor` | 诊断安装问题 |
| `/cancel` | 取消活动执行模式 |

### 关键词触发

在消息中使用关键词自动激活技能：

| 关键词 | 触发技能 |
|--------|----------|
| `ralph`, `don't stop`, `must complete` | `$ralph` |
| `autopilot`, `build me`, `I want a` | `$autopilot` |
| `ultrawork`, `ulw`, `parallel` | `$ultrawork` |
| `ralplan`, `consensus plan` | `$ralplan` |
| `deep interview`, `interview me` | `$deep-interview` |
| `cancel`, `stop`, `abort` | `$cancel` |

---

## 团队模式（推荐）

Team 是 OMAC 的核心多智能体编排面：

```
/team 3:executor "修复所有 TypeScript 错误"
```

Team 运行为分阶段流水线：

`team-plan → team-prd → team-exec → team-verify → team-fix (循环)`

### 启用原生团队

在 `~/.ash-claw/settings.json` 中添加：

```json
{
  "env": {
    "ASHCLAW_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}
```

---

## 配置

### 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `ASH_CONFIG_DIR` | 配置目录 | `~/.ash-claw` |
| `ASHCLAWCODE` | 会话检测（由 ash-claw 自动设置） | - |
| `OMAC_PLUGIN_ROOT` | 插件根目录 | - |

### 配置目录

- `~/.ash-claw/` - 主配置目录
- `~/.ash-claw/settings.json` - 设置文件
- `~/.ash-claw/commands/` - 自定义命令
- `~/.ash-claw/skills/` - 用户技能
- `.omac/` - 项目级状态目录

---

## 平台支持

### tmux 要求

某些功能（如 `omac team`）需要 tmux：

| 平台 | 安装命令 |
|------|----------|
| macOS | `brew install tmux` |
| Ubuntu/Debian | `sudo apt install tmux` |
| Fedora | `sudo dnf install tmux` |
| Windows | `winget install psmux` |
| Windows (WSL2) | `sudo apt install tmux` |

---

## 更新

### 通过 Marketplace 更新

```bash
ash-claw plugin marketplace update omac
/setup
```

### 手动更新

```bash
cd /path/to/oh-my-ashclaw
git pull
ash-claw plugin install oh-my-ashclaw
/setup
```

---

## 故障排除

### 诊断问题

```
/omac-doctor
```

### 清理缓存

如果更新后出现问题：

```bash
# 清理旧插件缓存
rm -rf ~/.ash-claw/plugins/oh-my-ashclaw

# 重新安装
ash-claw plugin install oh-my-ashclaw
/setup
```

### Stop Hook 错误

如果看到 "Stop hook error"，这通常是 ash-claw 底层问题，不影响插件核心功能。可以忽略或检查 ash-claw 配置。

---

## 与原版 oh-my-claudecode 的差异

| 项目 | oh-my-claudecode | oh-my-ashclaw |
|------|------------------|---------------|
| CLI 命令 | `claude` | `ash-claw` |
| 配置目录 | `~/.claude` | `~/.ash-claw` |
| 环境变量 | `CLAUDE_CONFIG_DIR` | `ASH_CONFIG_DIR` |
| 会话检测 | `CLAUDECODE` | `ASHCLAWCODE` |
| 插件命令 | `omc` | `omac` |
| 插件目录 | `.claude-plugin` | `.ash-claw-plugin` |

---

## 从 oh-my-claudecode 迁移

如果你之前使用 oh-my-claudecode：

1. 复制配置文件：
```bash
cp -r ~/.claude ~/.ash-claw
```

2. 重命名配置文件：
```bash
mv ~/.ash-claw/CLAUDE.md ~/.ash-claw/ASHCLAW.md
mv ~/.ash-claw/CLAUDE-omc.md ~/.ash-claw/ASHCLAW-omac.md
```

3. 更新环境变量引用（如果有脚本使用 `CLAUDE_CONFIG_DIR`）

---

## 致谢

本项目基于 [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) 改造。

感谢原作者 **Yeachan Heo** 和所有贡献者。

---

## 许可证

MIT
