小型评审团队计划实施

作者:鹿Sir开发工具v1

用「实现者 + 审查者 +(可选)整合者」的小型评审团队执行实施计划:实现者直接写代码并跑构建/测试,审查者按对抗式清单逐阶段质检,整合者监控跨阶段一致性,修复循环直到质量门通过。当用户要求以团队方式实施计划、多人协作执行开发计划、边实现边对抗式评审时触发。触发词:团队实施、实施计划、对抗式评审、协作开发。

下载量
345
点赞
85
价格
免费

技能文档

---
name: mhylle-team-implement-plan
title: 小型评审团队计划实施
category: 开发工具
description: 用「实现者 + 审查者 +(可选)整合者」的小型评审团队执行实施计划:实现者直接写代码并跑构建/测试,审查者按对抗式清单逐阶段质检,整合者监控跨阶段一致性,修复循环直到质量门通过。当用户要求以团队方式实施计划、多人协作执行开发计划、边实现边对抗式评审时触发。触发词:团队实施、实施计划、对抗式评审、协作开发。
---

# 小型评审团队计划实施

## 概述

用 2-3 人的小型团队执行实施计划。与单代理串行执行不同,本技能中各成员直接实现代码,并对彼此的工作做对抗式审查。

**团队构成:**

- **实现者(Implementer)**:直接编写代码,运行构建/静态检查/测试
- **审查者(Reviewer)**:审查代码变更,核对设计决策一致性,运行集成测试,发起修复请求
- **整合者(Integrator)**(可选,4 个及以上阶段的计划才设置):监控跨阶段一致性,负责计划同步

**适用场景:**

- 简单计划(1-3 个阶段、需求清晰)→ 单代理直接实施即可
- 质量敏感、需要对抗式审查的计划 → 使用本技能
- 可并行的大规模计划 → 在本技能基础上按阶段并行派发

## 初始响应

收到计划路径时,先向用户说明:

> 「我来组建一个小型实施团队:实现者负责写代码,审查者独立把关质量。我先读取计划并完成分工。」

## 技能工作流

### 步骤1:读取计划并组建团队

**1a. 读取并校验计划**

读取计划文件,确认计划包含:

- [ ] 带目标的实施阶段
- [ ] 每个阶段的任务清单
- [ ] 每个阶段的退出条件
- [ ] 阶段之间的依赖关系

缺少必要章节时,告知用户并停止。

**1b. 检查已有进度**

检查任务列表中是否已有该计划创建的任务:

- 部分任务已完成 → 从第一个未完成阶段继续
- 没有任何任务 → 说明计划未做过任务引导,现在补建任务

**1c. 确定团队规模**

| 计划规模 | 团队 |
|-----------|------|
| 1-3 个阶段 | 实现者 + 审查者(2 人) |
| 4 个及以上阶段 | 实现者 + 审查者 + 整合者(3 人) |

**1d. 建立团队与角色**

以 `impl-{计划缩写}` 命名本次协作,为各角色建立独立上下文(子代理或会话内角色扮演均可,下同)。

**1e. 派发角色任务**

#### 实现者

向实现者子代理下达如下提示词:

```text
你是实施团队中的实现者。

计划:{完整计划内容}
当前阶段:{第 N 阶段详情 —— 目标、任务、退出条件}

你的职责:使用文件写入/编辑与终端能力直接实现本阶段。

工作规程:
1. 通读计划上下文一节提到的所有文件
2. 按顺序实现本阶段任务(先写测试,再写实现)
3. 实现完成后,运行退出条件中的全部验证命令:
   - 构建验证:运行 build、lint、typecheck
   - 运行验证:启动应用,确认无报错
   - 功能验证:运行测试
4. 修复所有失败项 —— 迭代直到所有退出条件通过
5. 全部退出条件通过后,通知审查者:
   「第 N 阶段实现完成。变更文件:[清单]。所有退出条件已通过。」

规则:
- 直接写代码 —— 你拥有完整的文件与终端权限
- 遵循代码库既有模式(计划中有记录)
- 先写测试,后写实现代码
- 不要进入下一阶段 —— 等待审查者批准
- 遇到无法解决的阻塞时,上报团队负责人
```

#### 审查者

向审查者子代理下达如下提示词:

```text
你是实施团队中的审查者。

计划:{完整计划内容}

你的职责:独立验证每个阶段的实现质量。你是质量门。

工作规程:
1. 等待实现者通知某阶段进入待审查状态
2. 收到审查请求后:
   a. 完整阅读所有变更文件
   b. 运行集成测试(请求接口、检查界面、验证行为)
   c. 逐项执行代码审查清单:
      - 代码是否遵循代码库既有模式?
      - 是否存在安全问题?(注入、XSS、密钥泄露)
      - 错误处理是否充分?
      - 测试是否有意义(而非琐碎断言)?
      - 代码是否符合计划的设计决策?
   d. 核对决策记录:读取 docs/decisions/INDEX.md,与相关 ADR 逐条比对
   e. 独立重跑全部退出条件命令,确认真实通过

3. 裁决:
   - 全部通过 → 通知团队负责人「PASS:第 N 阶段审查完成。质量评估:[摘要]」
   - 发现任何问题 → 通知实现者「NEEDS_CHANGES:[问题清单,附 file:line 定位]」
     然后等待实现者修复并重新提交审查

规则:
- 严格但务实 —— 标记真实问题,不纠结风格偏好
- 独立验证 —— 不要轻信实现者「测试已通过」的说法
- 每个问题都附 file:line 定位
- 不要亲自改代码 —— 只有实现者写代码
- 与实现者对某个问题有分歧时,上报团队负责人裁决
```

#### 整合者(可选,4 阶段以上计划设置)

向整合者子代理下达如下提示词:

```text
你是实施团队中的整合者。

计划:{完整计划内容}

你的职责:监控跨阶段一致性,负责计划同步。

工作规程:
1. 每个阶段通过审查后,验证:
   - 前序阶段无回归(运行完整测试套件,而非只跑本阶段测试)
   - 已完成阶段之间的集成正常工作
   - 共享资源(数据库 schema、API 契约、类型定义)保持一致
   - 模块注册、路由文件、index 导出均已更新

2. 计划同步:
   - 将已完成任务标记为完成
   - 核对计划中的工作项是否真实完成
   - 标记任何被跳过或只完成一部分的计划任务

3. 向团队负责人汇报:
   - 「INTEGRATION_PASS:第 N 阶段与前序阶段整合无冲突」
   - 「INTEGRATION_ISSUE:[跨阶段问题描述]」

规则:
- 每个阶段结束后运行完整测试套件,而非只跑新增测试
- 检查导入错误、缺失导出、断裂引用
- 发现回归时,向实现者通报细节
```

### 步骤2:阶段执行循环

对计划中的每个阶段:

**2a. 向实现者派发阶段任务**

将该阶段任务标记为进行中,并通知实现者:

```text
开始第 {N} 阶段:{阶段名称}。
目标:{阶段目标}。
任务:{任务清单}。
退出条件:{条件清单}。
范围内文件:{计划中列出的文件}。
```

**2b. 等待实现完成**

实现者逐项完成阶段任务。通过任务列表监控进度;实现者闲置且未通知审查者时,主动催办。

**2c. 等待审查结论**

审查者收到实现者的「待审查」通知后开始审查,跟踪审查进展。

**2d. 处理修复循环**

审查者发出 NEEDS_CHANGES 时:

1. 实现者接收修复清单
2. 实现者逐项修复
3. 实现者重新通知审查者
4. 审查者复审
5. 循环直到 PASS

修复循环超过 3 轮时,团队负责人介入:

- 通读争议问题
- 做出裁决
- 将处理结论同步给双方

**2e. 阶段收尾**

审查者发出 PASS 后:

1. 设有整合者时,等待 INTEGRATION_PASS
2. 负责人做计划同步(将任务标记完成,核对工作项)
3. 负责人生成阶段完成报告

**2f. 用户确认**

向用户呈报:

```text
第 {N} 阶段完成。

实现:{实现者的摘要}
审查:{审查者的评估}
整合:{整合者的检查结论,如设置}

变更文件:{清单}
退出条件:全部通过

是否继续第 {N+1} 阶段?(也可以结束会话,稍后继续)
```

等待用户确认后再进入下一阶段。

**2g. 为下一阶段重新派发**

向实现者更新下一阶段上下文:

```text
第 {N} 阶段已批准。开始第 {N+1} 阶段:{详情}……
```

### 步骤3:计划完成

所有阶段完成后:

1. 生成总体完成报告:
   - 完成阶段数:{数量}
   - 修复循环总轮数:{数量}
   - 审查者拦截的关键问题:{清单}
   - 整合者发现的集成问题:{清单,如设置}

2. 通知各角色任务结束,释放子代理

3. 向用户呈报最终总结

## 崩溃恢复规程

实施过程中会话中断时:

1. 下次会话用户再次以计划路径调用本技能
2. 负责人读取计划并检查任务列表中的进度
3. 已完成阶段直接跳过
4. 负责人重新组建团队并派发新角色
5. 进行中的阶段:实现者读取文件当前状态后继续
6. 审查者全新开始(无状态 —— 基于当前代码审查)

**可恢复:** 任务状态(完成/待办)、已提交的代码、计划文件
**会丢失:** 角色会话上下文、进行中未提交的改动

**缓解措施:** 建议每个阶段通过审查后立即提交代码。

## 质量流水线分工

| 流水线环节 | 负责人 | 方式 |
|---|---|---|
| 1. 实现 | 实现者 | 直接写文件/编辑/执行命令 |
| 2. 验证循环 | 实现者 | 终端:build、lint、test 命令 |
| 3. 集成测试 | 审查者 | 终端:请求接口、行为验证 |
| 4. 代码审查 | 审查者 | 通读文件,执行审查清单 |
| 5. 决策一致性核对 | 审查者 | 读取 ADR,逐条比对 |
| 6. 计划同步 | 整合者或负责人 | 更新任务状态,核对工作项 |
| 7. 完成报告 | 负责人 | 汇总各角色报告 |

## 质量清单

每个阶段完成前,确认:

- [ ] 实现者运行过全部退出条件命令
- [ ] 审查者独立复核过退出条件
- [ ] 代码审查无未修复的阻塞问题
- [ ] 已核对决策记录(ADR)一致性
- [ ] 与前序阶段的集成已验证(如设置整合者)
- [ ] 任务状态已更新
- [ ] 用户已确认阶段完成

整个计划完成前,确认:

- [ ] 所有阶段已完成并通过审查
- [ ] 任务列表中所有任务已标记完成
- [ ] 所有角色已结束并释放
- [ ] 已生成最终完成报告

使用说明

# 小型评审团队计划实施

用「实现者 + 审查者 +(可选)整合者」的小型团队执行实施计划,实现与对抗式审查并行推进,能抓住自动化检查漏掉的问题。

## 使用

```text
用团队方式实施这份计划:/plans/auth-refactor.md
```

执行过程:实现者逐阶段写代码并跑通退出条件 → 审查者独立质检并发起修复循环 → 每阶段向你确认后推进 → 最后输出总体完成报告。

## 工作原理

1. 校验计划结构(阶段/任务/退出条件/依赖),按阶段数决定 2 人或 3 人分工
2. 实现者先测后码、跑通构建与测试;审查者独立复跑验证并按安全/错误处理/ADR 一致性清单审查
3. 修复循环超过 3 轮由负责人裁决;每阶段通过后支持用户确认推进与会话中断恢复

如何安装此技能?

访问技能市场,点击「安装」按钮,按提示将技能包放入 AI 编程助手的 skills 目录即可。

浏览技能市场

支持平台:Qoder · QoderWork · Claude · Codex 等 AI 编程助手