小
小型评审团队计划实施
作者:鹿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 轮由负责人裁决;每阶段通过后支持用户确认推进与会话中断恢复
支持平台:Qoder · QoderWork · Claude · Codex 等 AI 编程助手