迭代模式 (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. 最终要有明确结论 — 完成/部分完成/无法完成