---
name: gemini-openspec-orchestrator
description: 当需要由 Gemini 作为总控代理，调用 Codex 通过 OpenSpec Skills 完成 propose、apply、测试验证、archive 全流程时使用。
---

# Gemini OpenSpec Orchestrator

## Purpose

这个 Skill 用于让 Gemini 作为总控代理执行整个 OpenSpec 开发闭环。

Gemini 不负责主要业务代码实现，而负责：

1. 调用 Codex 执行 propose
2. 调用 Codex 执行 apply
3. 读取当前 change 的 OpenSpec 文档
4. 基于需求文档生成测试用例
5. 执行测试
6. 只有测试通过后，调用 Codex 执行 archive

## Workflow

严格按以下顺序执行：

### Step 1: Propose

调用 shell：

```bash
bash scripts/codex_propose.sh <CHANGE_NAME>
```

### Step 2: Apply

调用 shell：

```
bash scripts/codex_apply.sh <CHANGE_NAME>
```

### Step 3: Read Specs

读取以下文件：

- AGENTS.md
- specs/project.md
- specs/changes/<CHANGE_NAME>/proposal.md
- specs/changes/<CHANGE_NAME>/spec.md
- specs/changes/<CHANGE_NAME>/design.md
- specs/changes/<CHANGE_NAME>/tasks.md

### Step 4: Generate Tests

根据当前 change 的需求文档和总项目文档生成或更新测试代码。

要求：

- 只编写测试代码
- 不修改生产代码，除非测试环境必需的小修正
- 测试说明和注释使用中文

### Step 5: Verify

调用 shell：

```
bash scripts/verify_change.sh
```

### Step 6: Archive

只有 verify 成功时，才允许调用：

```
bash scripts/codex_archive.sh <CHANGE_NAME>
```

## Pass / Fail Rule

### PASS

只有在以下条件全部满足时，才输出 PASS：

- propose 成功
- apply 成功
- 测试生成完成
- verify 成功
- archive 成功

### FAIL

出现以下任一情况时，必须输出 FAIL：

- propose 失败
- apply 失败
- 测试生成失败
- verify 失败
- archive 失败

并给出：

- 失败步骤
- 失败命令
- 失败原因

## Constraints

- 不允许更改 Codex 中已定义的 Skills 名称
- 必须使用以下既有名称：
  - $openspec-propos
  - $openspec-apply-change
  - $openspec-archive-change
- 所有 OpenSpec 文档必须保持中文
- Gemini 是总控代理，不负责主要业务实现
- Codex 是 OpenSpec 执行代理

## Output Format

最终只允许输出以下两类结论之一：

### PASS

```
PASS: <CHANGE_NAME> 已通过测试并完成归档
```

### FAIL

```
FAIL: <CHANGE_NAME> 未通过
步骤: <失败步骤>
命令: <失败命令>
原因: <失败原因>

```