---
name: rpi
description: 通用 RPI（调研、计划、实施、迭代）执行技能。用于用户要求“先调研、再计划、再实施、最后迭代”的工程任务，或任务复杂度高、风险高、影响面不清晰时。该技能不依赖特定命令行工具或平台，适用于任意支持技能机制的 AI 代理。
---

# RPI

## 概览

- 使用四阶段流程：`调研 -> 计划 -> 实施 -> 迭代`。
- 严格保持阶段边界：调研/计划阶段不改代码，实现阶段必须验证。
- 每阶段产出结构化结果，确保下一阶段可以直接复用。

## 使用方式

在同一会话中按阶段推进：

1. 进入 `调研`，只收集事实和约束。
2. 进入 `计划`，输出可审核执行计划。
3. 计划确认后进入 `实施`，执行改动并验证。
4. 完成实施后进入 `迭代`，复盘并给出改进优先级。

## 工作流决策

1. 需求不清晰或上下文不足时，先做 `调研`。
2. 关键事实明确后，做 `计划` 并等待确认。
3. 计划确认后，执行 `实施`。
4. 实施完成后，执行 `迭代`。
5. 出现关键前提变化时，回退到 `调研` 或 `计划`。

## 阶段规范

### 1) 调研

目标：建立可信上下文，不改代码。

动作：

- 明确问题定义、成功标准、约束边界。
- 识别相关代码、依赖、配置与现有模式。
- 区分事实、假设、未知项。
- 提炼进入计划阶段的决策信息。

输出结构：

1. 概要
2. 关键发现
3. 上下文
4. 待确认问题
5. 建议

### 2) 计划

目标：形成可执行、可验证、可审阅的计划，不改代码。

动作：

- 基于已确认事实拆解步骤。
- 标注受影响文件、风险、回滚思路。
- 定义验证方案与完成标准。
- 等待确认后再进入实施阶段。

输出结构：

1. 目标
2. 前提假设
3. 范围与涉及文件
4. 执行步骤
5. 风险与缓解
6. 验证方案

### 3) 实施

目标：按计划实施改动并持续验证。

动作：

- 按步骤实施，控制改动范围。
- 每批改动后立即验证（测试、lint、type-check、功能检查）。
- 偏离计划时先说明原因并更新计划。
- 记录进度与剩余工作。

输出结构：

1. 已完成改动
2. 验证结果
3. 偏离说明
4. 剩余工作

### 4) 迭代

目标：系统复盘并定义下一轮优化。

动作：

- 评估正确性、健壮性、可维护性与可观测性。
- 检查边界条件、失败路径、性能与安全风险。
- 识别测试缺口和技术债。
- 输出按优先级排序的改进项。

输出结构：

1. 优点
2. 问题
3. 边界情况与缺口
4. 优先级改进项

## 质量门禁

- 在 `调研` 与 `计划` 阶段禁止直接改代码。
- 在 `实施` 阶段禁止跳过验证直接宣告完成。
- 在 `迭代` 阶段禁止只给结论，必须给可执行改进项。
- 每阶段结束必须输出结构化结果。

## 参考

- 读取 `references/rpi-playbook.md` 获取详细检查清单与提示词模板。