---
name: autodev
description: Feature auto-development — clarify requirements, generate spec, dispatch dev sub-agent to implement and merge into current branch
trigger: /autodev, autodev
---

# /autodev — Feature Auto-Development Workflow

当用户输入 `/autodev <功能描述>` 时，你按以下三个阶段工作。

---

## Phase 1: 需求澄清

首先用 `read_file` 读取 `AGENTS.md`，了解项目当前模块、架构和规范（重点：第 4 节项目结构、第 5 节开发流程）。

然后向用户提 **2-3 个关键澄清问题，每次只问一个**：

1. **功能边界**：明确实现什么、不实现什么
2. **验收标准**：什么样的测试证明功能完成（单元测试？eval 用例？）
3. **影响范围**：新增文件为主还是修改已有模块

2-3 轮澄清后直接进入 Phase 2，不要过度追问。

---

## Phase 2: Spec 生成与确认

以如下格式生成并展示 spec：

```
## Feature Spec: <标题>

### 功能描述
<简洁描述该功能做什么>

### 实现范围
新增文件：
- internal/<pkg>/<file>.go
- internal/<pkg>/<file>_test.go

修改文件：
- cmd/harness9/main.go（如需注册新工具）

### 验收标准
- [ ] go build ./... 通过
- [ ] go test ./... 通过
- [ ] （如涉及 Agent 行为）internal/evals/dataset/ 新增 eval 用例

### 不在范围内
- <明确列出不做的事>
```

展示完成后，输出以下提示，**不要调用任何工具，直接结束本轮回复**（TUI 会自动等待用户输入）：

> **请确认 spec（输入「确认」继续实现），或告知需要修改的地方。**

如果用户要求修改，更新 spec 后重新展示，再次等待确认。
只有用户明确输入「确认」后才进入 Phase 3。

---

## Phase 3: 前置检查 + 委派实现

### 3.1 前置检查

依次用 bash 执行以下检查，任一失败则停下来告知用户并等待修复：

```bash
# 检查 Go 已安装（项目要求 1.25+）
go version
```

```bash
# 检查 git 可用
git --version
```

如果 `SANDBOX_ENABLED=true`，还需检查 Go 镜像是否配置：
```bash
echo "SANDBOX_IMAGE=${SANDBOX_IMAGE:-未设置}"
# 若未设置或不含 golang，提示用户在 .env 中添加：
# SANDBOX_IMAGE=golang:1.25-bookworm
```

### 3.2 创建 git worktree

从 spec 标题生成 slug（全小写，空格替换为 `-`，去掉非 ASCII 字母数字字符），然后执行：
示例：`"Add WebSocket 支持"` → `"add-websocket-"`（中文字符去掉）→ 可简化为 `"add-websocket-support"`

```bash
git worktree add .autodev/<slug> -b feature/autodev-<slug>
```

用 bash 获取绝对路径：
```bash
readlink -f .autodev/<slug>
```

### 3.3 委派 dev sub-agent

调用 task 工具委派 dev sub-agent：

```
task("dev", "以下是需要实现的 Feature Spec：\n\n<spec 全文>\n\n工作目录（git worktree 绝对路径）：<worktreePath>")
```

### 3.4 处理结果

**成功（sub-agent 返回 `AUTODEV_RESULT: SUCCESS`）：**

从 sub-agent 返回结果中提取 `BRANCH: <branch-name>`，然后执行合并：

```bash
# 将 feature 分支合并到当前分支
git merge feature/autodev-<slug>
```

若合并成功：
1. 展示：「✓ 已合并到当前分支：feature/autodev-<slug>」
2. 清理 worktree：`git worktree remove .autodev/<slug>`

若合并产生冲突：
1. 展示冲突文件列表
2. 保留 worktree：「存在合并冲突，worktree 保留在 .autodev/<slug>，请手动解决冲突」
3. 告知用户解决后执行：`git worktree remove .autodev/<slug> --force`

**失败（sub-agent 报告无法通过测试）：**
1. 展示错误摘要
2. 保留 worktree 供排查：「worktree 保留在 .autodev/<slug>，可用 `cd .autodev/<slug>` 进入排查」
3. 告知用户可手动删除：`git worktree remove .autodev/<slug> --force`