Iteration Pattern

应用拉尔夫循环（Ralph loop）解决ai执行不到位，说执行了，实际没执行或执行不完全的问题。 迭代优化工作流模式。当任务复杂、一次完成质量可能不高时使用，通过循环检查和优化提升输出质量。 触发条件：(1) 用户说"迭代模式"、"用迭代方式"、"循环优化"，(2) 复杂任务需要多轮改进，(3) 创建 Skill/代码等需要反复检查的任务。

迭代模式 (Iteration Pattern)

循环检查优化 → 达到标准 → 输出完成

---

什么是迭代模式

一种迭代优化的工作流，通过循环检查和改进直到达到质量标准。

text

执行 → 检查 → 优化 → 检查 → 优化 → ... → 达标 → 完成

---

适用场景

简单任务（可一次完成）

• 产出物单一明确
• 完成标准容易定义（1-3条）
• 测试方法简单（目视检查即可）
• 不需要运行验证

复杂任务（建议用迭代模式）

• 产出物多个或复杂
• 完成标准需要多条（4条以上）
• 需要运行测试验证
• 可能需要多轮优化
• 代码/Skill等需要实际可运行

---

不适用场景

场景	原因
简单任务	一次就能做好，不需要迭代
需要快速出结果	迭代耗时
任务无法判断是否达标	没有明确标准

---

工作流步骤

1. 明确任务目标

必须先定义：

• 任务要产出什么？
• 交付物是什么？（文件？代码？文档？）

2. 设定完成标准

在开始前，定义可衡量的标准：

markdown

## 完成标准（必须明确）

### 交付物
- [ ] 产出：SKILL.md 文件
- [ ] 路径：skills/xxx/SKILL.md

### 质量标准
- [ ] name 字段非空
- [ ] description 字段非空
- [ ] 文档语法正确
- [ ] 示例代码可执行

### 功能标准
- [ ] Skill 可以正常加载
- [ ] 触发条件正确

3. 设定测试方法

关键：用什么方法验证每个标准？

markdown

## 测试方法

| 标准 | 测试方法 |
|------|---------|
| name 字段非空 | grep 检查非空 |
| 文档语法正确 | 读取文件检查 YAML 格式 |
| 示例可执行 | 运行示例代码 |
| Skill 可加载 | 执行 skillhub list 检查 |

4. 执行第一版

按照任务要求完成初始版本。

5. 逐项测试

对照完成标准，用测试方法逐项验证：

• 哪些达标了？✅
• 哪些没达标？❌ + 原因

6. 优化改进

针对没达标的部分进行优化。

7. 重复测试

回到步骤 5，直到：

• 所有标准都达标，或
• 达到最大迭代次数

8. 输出完成

输出明确的完成报告：

markdown

## 完成报告

### 迭代次数：N次

### 交付物
- 文件路径：xxx

### 最终状态
- ✅ 标准1
- ✅ 标准2
- ❌ 标准3（原因：xxx）

### 结论
任务完成 / 部分完成 / 无法完成

---

完成标准模板

markdown

## 完成标准模板

### 1. 交付物定义
明确要产出什么：
- [ ] 文件：xxx
- [ ] 代码：xxx
- [ ] 文档：xxx

### 2. 质量标准
**必须可验证**：
- [ ] 标准A：具体描述
- [ ] 标准B：具体描述
- [ ] 标准C：具体描述

### 3. 测试方法
**每项标准都要有验证方式**：
| 标准 | 测试命令/方法 |
|------|-------------|
| 标准A | 命令/检查方式 |
| 标准B | 命令/检查方式 |

### 4. 迭代上限
建议 3-5 次

---

结构化需求说明

每次使用迭代模式前，必须先填写以下结构化需求：

markdown

# 任务需求说明

## 1. 任务目标
- 产出物：<明确要产出什么>
- 存放位置：<文件路径>
- 格式要求：<如：Markdown/YAML/代码>

## 2. 完成标准（必须可验证）
- [ ] 标准1：<具体、可衡量的标准>
- [ ] 标准2：<具体、可衡量的标准>
- [ ] 标准3：<具体、可衡量的标准>

## 3. 测试方法
| 标准 | 验证方式 |
|------|---------|
| 标准1 | <具体的验证命令或检查方法> |
| 标准2 | <具体的验证命令或检查方法> |
| 标准3 | <具体的验证命令或检查方法> |

## 4. 约束条件
- 技术限制：<如：只能用开源方案>
- 环境要求：<如：需要Node.js环境>
- 时间限制：<如：3天内>

## 5. 迭代上限
<建议3-5次>

重要：不填写结构化需求说明，就不能开始迭代！

---

快速判断：要不要用迭代模式？

回答以下问题：

问题	答案=简单	答案=复杂
产出物有几个？	1个	2个以上
完成标准有几条？	1-3条	4条以上
需要运行测试吗？	否	是
代码需要实际可运行吗？	否	是
之前做过类似任务吗？	做过多次	第一次/不熟练

判断标准：如果3个以上回答"复杂"，就用迭代模式。

---

提示词模板

基础模板

markdown

# 迭代模式

请用迭代模式完成以下任务。

## 任务目标
<描述要产出什么>

## 完成标准
- [ ] 标准1：具体、可验证
- [ ] 标准2：具体、可验证
- [ ] 标准3：具体、可验证

## 测试方法
| 标准 | 测试方式 |
|------|---------|
| 标准1 | 命令/检查 |
| 标准2 | 命令/检查 |

## 最大迭代次数
3次

请开始执行，每轮完成后报告测试结果。

Skill 创建模板

markdown

# 迭代模式 - Skill 创建

请用迭代模式创建一个 Skill。

## Skill 需求
<描述 Skill 要做什么>

## 完成标准

### 交付物
- [ ] SKILL.md 文件存在于 skills/<name>/ 目录

### 结构标准（必须满足）
- [ ] name 字段：非空，符合规范
- [ ] description 字段：非空，清晰描述功能
- [ ] body：包含使用说明

### 质量标准
- [ ] YAML 语法正确（无格式错误）
- [ ] 触发条件明确
- [ ] 示例代码存在且可参考

### 可运行标准
- [ ] Skill 可被 skillhub 识别
- [ ] 依赖已安装（如有）

## 测试方法
| 标准 | 测试方式 |
|------|---------|
| name 字段 | grep 检查非空 |
| YAML 语法 | python -c "import yaml; yaml.safe_load(...)" |
| 文件存在 | ls 检查文件路径 |
| Skill 识别 | skillhub list |

## 最大迭代次数
3次

请开始创建，每轮完成后报告各项测试结果。

---

迭代 vs 一次完成

模式	流程	适用
一次完成	做完交稿	简单任务
迭代模式	做→检查→改→检查→改→...→完成	复杂任务

---

关键原则

1. 标准必须可验证 — 避免"做得好"这种模糊标准
2. 测试方法必须具体 — 用命令/检查方式，不是"检查一下"
3. 每轮都要有测试结果 — 不能跳过验证
4. 迭代次数要有限制 — 防止无限循环
5. 最终要有明确结论 — 完成/部分完成/无法完成