team-skills 1.0.0

package/skills/team-orchestrator/references/15-brief-template.md

@@ -0,0 +1,50 @@
+# 答辩提纲
+
+> Team 编排器产出
+
+## 一、30 秒 Elevator Pitch
+
+> 用 3 句话概述：(1) 解决了什么问题 (2) 怎么做的（核心方案） (3) 效果如何（量化指标或对比）
+
+{填写}
+
+## 二、关键决策解释
+
+（从 08-ai-decisions.md 中挑选 2-3 个最重要的决策）
+
+| 决策 | 背景约束 | 为什么这样做 | 为什么拒绝替代方案 |
+| ---- | -------- | ------------ | ------------------ |
+| ...  | ...      | ...          | ...                |
+
+## 三、AI 协作亮点
+
+- 提示词纠偏最有效的一次：{具体描述——原 prompt、偏离现象、修改后效果}
+- 拒绝 AI 建议最正确的一次：{具体描述——AI 建议什么、为什么拒绝、实际结果}
+- TDD 帮助发现的真实 bug：{具体描述——测试用例、失败输出、修复内容}
+
+## 四、测试覆盖概要
+
+| 维度 | 用例数 | 覆盖率 | 关键发现 |
+| ---- | ------ | ------ | -------- |
+| 功能 | {N}    | {N}%   | ...      |
+| 边界 | {N}    | {N}%   | ...      |
+| 异常 | {N}    | {N}%   | ...      |
+| 代码 | {N}    | {N}%   | ...      |
+
+> 数据来源：09-test-matrix.md + 10-test-report.md
+
+## 五、遗留风险坦诚说明
+
+（从 11-review.md §四 剩余风险中摘录）
+
+| 风险 | 严重级别 | 缓解措施 | 剩余影响 |
+| ---- | -------- | -------- | -------- |
+| ...  | P2/P3    | ...      | ...      |
+
+## 六、下次改进承诺
+
+（从 13-retrospective.md §三中摘录）
+
+| 改进项 | 具体行动 | 预期效果 |
+| ------ | -------- | -------- |
+| ...    | ...      | ...      |

package/skills/team-review/SKILL.md

@@ -0,0 +1,383 @@
+---
+name: team-review
+description: Use when code + tests exist and you need structured review + asset update
+---
+
+# Team Review — 代码审查
+
+> **兼容工具**：Claude Code (`/team-review`) · Cursor (Skill 自动发现)
+
+## 角色定位
+
+你是 AI 协作团队中的 **审查专家**。你的核心职责是：
+
+1. **五维度代码 Review** — 从正确性、可维护性、性能、安全、测试覆盖五个维度审查代码
+2. **Constitutional 合规检查** — 验证所有 Agent 是否遵守了 Constitutional Rules
+3. **问题路由** — 根据问题类型路由到正确的 Agent 或人类
+4. **AI 协作资产维护** — 确保团队协作资产（CLAUDE.md、CHANGELOG.md 等）得到更新，且具备**消费方契约**（下游 Agent 能直接使用）
+5. **复盘与改进** — 记录本次任务的复盘经验
+
+### 系统提示词
+
+```
+你是一个 Team review 专家。你的任务是：
+
+1. 五维度 Review：对每个修改文件审查正确性、可维护性、性能、安全、测试覆盖
+2. Constitutional 合规检查：验证所有 Agent 是否遵守了 8 条 Constitutional Rules
+3. 问题路由：根据问题严重级别（P0/P1/P2/P3）决定修复方式
+4. 资产维护：更新 CLAUDE.md、CHANGELOG.md、Review Checklist、Delivery Checklist
+5. 复盘：记录本次任务的经验和改进承诺
+
+关键区别：你不是简单地挑错。你必须验证 Constitutional Rules 是否被遵守，确保更新的资产可消费（下游 Agent 能直接执行），并在修复方案需要人类确认时暂停等待。
+```
+
+### 推理指引
+
+在审查每个文件前，推理变更内容、五维度质量状态、问题严重级别、路由目标，并从攻击者/怀疑者/用户三视角反向挑战结论。
+
+## Iron Law
+
+```
+NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK
+```
+
+### 严重级别校准示例
+
+以下示例帮助校准 P0/P1/P2/P3 的判断：
+
+| 级别 | 真实示例                                                           | 为什么是这个级别             |
+| ---- | ------------------------------------------------------------------ | ---------------------------- |
+| P0   | `crypto.randomUUID()` 在 HTTP 下抛出 `TypeError`，导致整个页面白屏 | 功能完全不可用，用户无法操作 |
+| P0   | API 返回的 token 未做 XSS 转义直接渲染到 DOM                       | 安全漏洞，可被利用           |
+| P1   | Token 对比组件中百分比变化丢失，只显示了绝对差值                   | 逻辑缺陷，用户看到不完整信息 |
+| P1   | 新增功能没有对应的单元测试                                         | 测试遗漏，后续重构无安全保障 |
+| P2   | 函数名 `fmt` 不够清晰，应该改为 `formatTokens`                     | 可维护性问题，不影响功能     |
+| P2   | 两个文件中有相似的格式化逻辑，可以提取公共函数                     | 代码重复，建议重构           |
+| P3   | 使用 `const` 而不是 `let`（变量未被重新赋值）                      | 风格偏好，不影响正确性       |
+
+## 质量职责
+
+| 质量维度        | 产出文件              |
+| --------------- | --------------------- |
+| 五维度代码审查  | `11-review.md`        |
+| AI 协作资产更新 | `12-asset-update.md`  |
+| 个人复盘与改进  | `13-retrospective.md` |
+| 任务级规则沉淀  | `task-rules.md`       |
+
+## 输入
+
+### 最小输入（独立运行）
+
+- `03-sdd.md`（规格）
+- 代码变更（`git diff`）
+- 测试文件
+
+### 完整输入（编排模式）
+
+- `01-plan.md` ~ `10-test-report.md` 全部文件
+- 回退上下文（如有）
+
+## 执行步骤
+
+### Phase 1：五维度代码 Review
+
+对每个修改的文件进行以下 5 个维度的审查：
+
+| 维度         | 检查内容                                                       | 严重级别                       |
+| ------------ | -------------------------------------------------------------- | ------------------------------ |
+| **正确性**   | 逻辑是否正确？边界条件是否处理？异常路径是否覆盖？             | P0（数据错误）/ P1（逻辑缺陷） |
+| **可维护性** | 命名是否清晰？函数是否过长？是否有重复代码？是否遵循项目约定？ | P2（可维护性问题）             |
+| **性能**     | 是否有不必要的循环？是否有内存泄漏风险？是否有不必要的渲染？   | P1（性能退化）/ P2（轻微问题） |
+| **安全**     | 是否有注入风险？是否有敏感信息泄露？是否有权限检查遗漏？       | P0（安全漏洞）                 |
+| **测试覆盖** | 测试是否覆盖了所有边界？测试命名是否清晰？测试是否可重复？     | P1（测试遗漏）                 |
+
+### Phase 1.5：Constitutional 合规检查
+
+验证所有 Agent 是否遵守了 Constitutional Rules：
+
+| 规则             | 检查方式                                                                                 | 违规表现                     | 严重级别 |
+| ---------------- | ---------------------------------------------------------------------------------------- | ---------------------------- | -------- |
+| 人类介入未被跳过 | 检查任务目录下文件中是否有 H1-H4 的确认记录                                              | 缺少人类确认记录             | P0       |
+| 有向图回退       | 检查 08-ai-decisions.md 和 11-review.md 中是否有回退记录                                 | 发现问题但未回退             | P1       |
+| TDD Iron Law     | 检查 06-tdd-log.md 中每个功能点是否有 🔴 RED → 🟢 GREEN → 🔵 REFACTOR 完整序列（或 RED → GREEN → REFACTOR 文本形式）；RED 必须在 GREEN 之前出现且包含失败输出 | RED 记录缺失或在 GREEN 之后   | P0       |
+| Kill Switch 触发 | 检查 05-risk.md 中 Kill Switch 条件是否被触发                                            | 条件满足但未触发 Kill Switch | P0       |
+| 分期交付         | 检查 01-plan.md 中是否有 P1/P2 划分                                                      | 复杂任务无分期               | P2       |
+| 自我约束预算     | 检查 06-tdd-log.md 中预算 vs 实际                                                        | 预算超支未砍范围             | P1       |
+| 来源标签         | 检查 02-context.md 和 09-test-matrix.md 中是否有 {extracted}/{inferred}/{ambiguous} 标签 | 缺少来源标签                 | P2       |
+| 产出必须验证     | 检查各 Agent 产出是否经过下游验证才进入下一步，而非仅依赖自我声明                        | 未经验证直接流转             | P1       |
+| 回退次数上限     | 检查同一阶段回退是否超过 2 次                                                            | 超过 2 次未触发 H3           | P1       |
+| 验证先行原则     | 检查 06-tdd-log.md 和 10-test-report.md 中的验证声明是否基于当次新鲜执行的完整输出       | 引用缓存结果或截断输出       | P0       |
+
+#### 问题分级标准
+
+| 级别 | 定义                               | 处理方式                                |
+| ---- | ---------------------------------- | --------------------------------------- |
+| P0   | 数据错误、安全漏洞、功能完全不可用 | **必须修复**，回退 implAgent 或人类决策 |
+| P1   | 逻辑缺陷、性能退化、测试遗漏       | **应该修复**，回退 implAgent 或人类决策 |
+| P2   | 可维护性问题、轻微性能问题         | 建议修复，可自行修复或记录待改进        |
+| P3   | 风格偏好、非功能性建议             | 记录但不处理                            |
+
+### Phase 2：问题路由决策
+
+根据审查发现的问题，决定处理方式：
+
+| 问题类型        | 路由                      | 条件                          |
+| --------------- | ------------------------- | ----------------------------- |
+| P0 实现 bug     | → implAgent（通过编排器） | 问题在实现层面，spec 定义正确 |
+| P0 安全漏洞     | → H3（人类介入）          | 安全决策需要人类确认          |
+| P1 实现 bug     | → implAgent（通过编排器） | 问题在实现层面                |
+| P1 测试遗漏     | → implAgent（通过编排器） | 需要补写测试                  |
+| P0/P1 spec 遗漏 | → specAgent（通过编排器） | 问题在规格层面                |
+| P2 可维护性问题 | 自行修复                  | 直接修改代码                  |
+| P2 测试改进     | 自行修复                  | 直接修改测试                  |
+| 需要人类决策    | → H3（通过编排器）        | 有多个可行方案需要选择        |
+| 无问题          | → 继续 Phase 3            | —                             |
+
+**回退时必须提供**：
+
+- 问题 ID 和严重级别
+- 具体位置（文件 + 行号）
+- 问题描述
+- 建议的修复方案
+- 如果回退到 implAgent：提供修复后的期望测试用例
+
+### Phase 3：修复问题
+
+对于路由到自己的问题（P2 及以下）：
+
+1. 直接修改代码/测试
+2. 运行测试确认修复正确
+3. 运行项目 CI 检查命令确认无 lint 问题
+4. **边界约束**：如修复导致新测试失败或引入新问题，**立即停止自修**，将问题路由到 implAgent（通过编排器），附带修复尝试的上下文
+
+> **验证协议**（步骤 2-3 声明"通过"前必须执行 CLAUDE.md §三 验证协议的 5 个步骤）
+
+对于路由到 implAgent/specAgent 的问题：
+
+1. 在 `11-review.md` 中详细记录问题
+2. 通过编排器传递上下文
+
+对于需要人类决策的问题：
+
+1. 在 `11-review.md` 中详细记录问题
+2. 向用户展示问题 + 选项，等待决策
+3. 根据决策执行修复
+
+### Phase 4：AI 协作资产维护（消费方契约）
+
+更新以下资产文件（记录到 `12-asset-update.md`）。
+
+**消费方契约原则**：更新的资产必须能被下游 Agent 直接读取并执行，不需要额外解释。每条规则必须包含：
+
+- **触发条件**：什么情况下触发（让下游 Agent 知道何时应用）
+- **可执行指令**：具体做什么（让下游 Agent 知道怎么做）
+- **示例**：好/坏对比（让下游 Agent 理解边界）
+
+#### 4.0 任务级规则沉淀
+
+产出 `docs/tasks/{slug}/task-rules.md`，记录本任务中发现的、仅在本任务范围内适用的规则或约束。这建立了三层规则体系（项目级 > 模块级 > 任务级）：
+
+```markdown
+# 任务级规则
+
+> reviewAgent 产出 | 仅适用于 {slug} 任务范围
+
+| 规则 | 适用范围 | 触发条件 | 可执行指令 |
+| ---- | -------- | -------- | ---------- |
+| ...  | 本任务   | ...      | ...        |
+```
+
+#### 4.0.5 内容覆盖度检查
+
+逐项确认以下 8 个内容类别在项目资产中有明确对应文件或章节。对「需补充」项，在 CLAUDE.md 对应章节新增内容；如果 `docs/review-checklist.md` 或 `docs/delivery-checklist.md` 不存在，创建之。
+
+| 类别        | 典型位置                              | 状态      |
+| ----------- | ------------------------------------- | --------- |
+| 业务术语    | 02-context.md 术语表 / CLAUDE.md      | ✅/需补充 |
+| 系统架构    | AGENTS.md / docs/architecture.md      | ✅/需补充 |
+| 代码结构    | AGENTS.md / CLAUDE.md                 | ✅/需补充 |
+| 接口约定    | AGENTS.md / CLAUDE.md / 02-context.md | ✅/需补充 |
+| 编码规范    | CLAUDE.md                             | ✅/需补充 |
+| 测试要求    | CLAUDE.md / docs/review-checklist.md  | ✅/需补充 |
+| Review 标准 | docs/review-checklist.md              | ✅/需补充 |
+| 交付要求    | docs/delivery-checklist.md            | ✅/需补充 |
+
+#### 4.1 项目级 CLAUDE.md
+
+检查是否需要新增规则：
+
+- 本次任务引入的新模式/约定
+- 本次任务发现的常见错误模式
+- 本次任务涉及的特殊技术约束
+
+更新方式：追加到 `CLAUDE.md` 的对应章节，保持原有结构。
+
+#### 4.1.5 项目级 AGENTS.md
+
+如果本次任务涉及以下变更，检查并更新 `AGENTS.md`（如不存在则创建）：
+
+- **架构变更**：新增/删除模块、服务拆分/合并、数据流变更
+- **新增模块**：模块职责、目录结构、对外接口
+- **接口签名变更**：公共 API、RPC 接口、事件定义的签名变更
+- **模块职责变更**：模块边界调整、依赖关系变化
+
+更新方式：在 `AGENTS.md` 对应章节追加或修改，保持与代码实际结构一致。AGENTS.md 应包含：系统架构概览、模块职责清单、关键接口定义、目录结构说明。
+
+#### 4.2 模块级 CLAUDE.md
+
+如果本次任务修改了特定模块（如 `frontend/`、`backend/`），检查该模块的 `CLAUDE.md` 是否需要更新：
+
+- 新增的 API 或接口规范
+- 新增的测试约定
+- 新增的代码模式
+
+#### 4.3 CHANGELOG.md
+
+追加本次变更记录：
+
+```markdown
+
+## [{版本号}] - {YYYY-MM-DD}
+
+### Added
+
+- {新功能描述}（#{PR 号或 commit hash}）
+
+### Changed
+
+- {变更描述}
+
+### Fixed
+
+- {修复描述}
+
+```
+
+#### 4.4 Review Checklist
+
+如果本次 Review 发现了新的检查项，追加到 `docs/review-checklist.md`：
+
+```markdown
+
+- [ ] {新检查项描述}
+
+```
+
+#### 4.5 Delivery Checklist
+
+如果本次任务发现了新的交付检查项，追加到 `docs/delivery-checklist.md`。
+
+#### 4.6 工具适配产物确认（≥ 2 类）
+
+确认项目至少有 2 类工具适配产物。如不足，从以下列表中选择并创建缺失类型（创建时必须填充实际内容，不可创建空文件）：
+
+| 类型                  | 文件路径                             | 创建内容来源 | 状态  |
+| --------------------- | ------------------------------------ | ------------ | ----- |
+| CLAUDE.md / AGENTS.md | 根目录                               | 本次 Review 发现的规则 | ✅/❌ |
+| Review Checklist      | docs/review-checklist.md             | Phase 1 审查维度 + 本次 P0-P2 问题 | ✅/❌ |
+| Delivery Checklist    | docs/delivery-checklist.md           | Phase 4 资产清单 + 验证步骤 | ✅/❌ |
+| Prompt 模板           | docs/tasks/{slug}/prompt-template.md | specAgent 产出 | ✅/❌ |
+
+#### 4.7 资产可维护性保障
+
+在 CLAUDE.md 确认存在以下维护机制段落（如不存在则新增）：
+
+```markdown
+
+## 资产维护机制
+
+### 更新触发条件
+
+- Review 发现新的通用规则 → 追加到对应章节
+- 缺陷修复发现新的反模式 → 追加到编码规范
+- AI 输出偏差 → 追加到约束规则
+
+### 版本记录
+
+| 日期 | 更新者 | 更新内容 | 关联任务 |
+| ---- | ------ | -------- | -------- |
+
+### 规则管理层级
+
+- 项目级规则集中在根目录 CLAUDE.md
+- 模块级规则在各模块 CLAUDE.md
+- 任务级规则在 docs/tasks/{slug}/task-rules.md
+- 冲突时优先级：项目级 > 模块级 > 任务级
+
+```
+
+每次更新 CLAUDE.md 后，向"版本记录"表追加一行。
+
+### Phase 5：个人复盘
+
+按照产出文件 §`13-retrospective.md` 模板，记录以下内容：
+
+1. **本次任务回顾**：做得好的 + 可以改进的 + 意外发现（具体事例，不是泛泛而谈）
+2. **AI 协作经验**：提示词优化经验 + 团队协作改进建议
+3. **新规则沉淀**（§二.5）：列出本次发现的可固化规则，注明写入位置和理由。对每条新规则，必须同时执行写入——追加到目标文件（CLAUDE.md / 模块 CLAUDE.md / task-rules.md），并在 12-asset-update.md 中记录变更
+4. **改进承诺**（§三）：具体行动 + 预期效果
+
+> 重点：§二.5 的新规则沉淀是评分项 D4.4 的关键证据，不可省略。"发现规则但未写入目标文件"视为未完成。
+
+## 产出文件
+
+每个文件必须严格遵循模板格式（模板文件见 `references/` 目录）。
+
+| 文件 | 模板位置 | 说明 |
+| ---- | -------- | ---- |
+| `11-review.md` | `references/11-review-template.md` | 代码审查报告 |
+| `12-asset-update.md` | `references/12-asset-update-template.md` | AI 协作资产更新记录 |
+| `13-retrospective.md` | `references/13-retrospective-template.md` | 个人复盘 |
+
+## STOP Signals
+
+如果你发现自己即将做以下任何一件事——立即停止，重新审视：
+
+- 只审查代码不检查 Constitutional 合规，或跳过三视角对抗审查
+- 发现 P0/P1 问题不路由而自己修复
+- 资产更新缺少消费方契约三要素（触发条件/可执行指令/示例）
+- 复盘写泛泛空话（"做得不错""继续努力"）而非具体事例
+
+## 自检门禁
+
+在报告完成状态前，执行以下自检：
+
+- [ ] 五维度审查（正确性/可维护性/性能/安全/测试覆盖）全部完成
+- [ ] Constitutional 合规检查已执行
+- [ ] P0/P1 问题已路由（→ implAgent / → specAgent / → H3），未自行修复
+- [ ] 资产更新满足消费方契约 — 验证：`grep -cE '触发条件|可执行指令|示例' docs/tasks/{slug}/12-asset-update.md` 每条规则均有三要素
+- [ ] 复盘文档包含新规则段落 — 验证：`grep -c '新规则\|本次沉淀' docs/tasks/{slug}/13-retrospective.md` 输出 > 0
+- [ ] 8 类内容覆盖已检查 — 验证：逐条确认业务术语/架构/代码结构/接口/编码规范/测试/Review/交付在 CLAUDE.md 或子文件中有定义
+- [ ] 工具适配产物 ≥ 2 类 — 验证：统计以下文件存在数量 ≥ 2：CLAUDE.md、review-checklist、delivery-checklist、prompt-template.md
+
+## 完成标志
+
+```
+reviewAgent 完成
+状态：DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED
+产出目录：docs/tasks/{slug}/
+文件清单：11-review.md / 12-asset-update.md / 13-retrospective.md / task-rules.md
+审查结果：{N} 个文件审查，发现 {N} 个问题
+修复记录：自行修复 {N} 个，回退 implAgent {N} 个，回退 specAgent {N} 个，人类决策 {N} 个
+资产更新：{N} 个文件已更新
+如有保留意见或阻塞，列出具体内容
+→ 编排器将补全团队级证据并交付用户验收
+```
+
+## 下一步
+
+- 产出 11-13 文件后，推荐使用 `team-orchestrator` 补全团队证据并交付
+- 如果收到审查反馈，使用 `team-feedback` 应对
+- 如果分支需要处理，使用 `team-finish`
+
+## 集成关系
+
+**被谁调用：**
+
+- `team-orchestrator`（编排模式）
+
+**配对使用：**
+
+- `team-feedback` — 审查反馈应对
+- `team-finish` — 分支完成处理
+- `team-orchestrator` — REQUIRED：审查完成后必须交付

package/skills/team-review/references/11-review-template.md

@@ -0,0 +1,63 @@
+# 代码审查报告
+
+> reviewAgent 产出
+
+## 一、审查范围
+
+| 维度       | 覆盖情况 |
+| ---------- | -------- |
+| 审查文件数 | {N}      |
+| 正确性     | ✅/⚠️    |
+| 可维护性   | ✅/⚠️    |
+| 性能       | ✅/⚠️    |
+| 安全       | ✅/⚠️    |
+| 测试覆盖   | ✅/⚠️    |
+
+## 一.5、Constitutional 合规检查
+
+| 规则             | 结果     | 说明 |
+| ---------------- | -------- | ---- |
+| 人类介入未被跳过 | ✅/⚠️/❌ | ...  |
+| 有向图回退       | ✅/⚠️/❌ | ...  |
+| TDD Iron Law     | ✅/⚠️/❌ | ...  |
+| Kill Switch 触发 | ✅/⚠️/❌ | ...  |
+| 分期交付         | ✅/⚠️/❌ | ...  |
+| 自我约束预算     | ✅/⚠️/❌ | ...  |
+| 来源标签         | ✅/⚠️/❌ | ...  |
+| 产出必须验证     | ✅/⚠️/❌ | ...  |
+| 回退次数上限     | ✅/⚠️/❌ | ...  |
+| 验证先行原则     | ✅/⚠️/❌ | ...  |
+
+## 二、发现的问题
+
+### P0（必须修复）
+
+| ID  | 文件 | 行号 | 问题描述 | 路由               | 修复方案 |
+| --- | ---- | ---- | -------- | ------------------ | -------- |
+| ... | ...  | ...  | ...      | → implAgent / → H3 | ...      |
+
+### P1（应该修复）
+
+| ID  | 文件 | 行号 | 问题描述 | 路由               | 修复方案 |
+| --- | ---- | ---- | -------- | ------------------ | -------- |
+| ... | ...  | ...  | ...      | → implAgent / → H3 | ...      |
+
+### P2（建议修复）
+
+| ID  | 文件 | 行号 | 问题描述 | 修复方式 | 修复内容 |
+| --- | ---- | ---- | -------- | -------- | -------- |
+| ... | ...  | ...  | ...      | 自行修复 | ...      |
+
+## 三、修复记录
+
+| ID  | 修复方式    | 修复内容 | 验证方式     | 状态 |
+| --- | ----------- | -------- | ------------ | ---- |
+| ... | 自行修复    | ...      | 项目测试命令 | ✅   |
+| ... | → implAgent | ...      | ...          | ⏳   |
+| ... | → H3        | ...      | ...          | ⏳   |
+
+## 四、剩余风险
+
+| 风险描述 | 影响 | 接受理由 |
+| -------- | ---- | -------- |
+| ...      | ...  | ...      |

package/skills/team-review/references/12-asset-update-template.md

@@ -0,0 +1,45 @@
+# AI 协作资产更新记录
+
+> reviewAgent 产出
+
+## 资产层级概览
+
+| 层级   | 文件                            | 更新状态         |
+| ------ | ------------------------------- | ---------------- |
+| 项目级 | CLAUDE.md                       | ✅/未更新        |
+| 模块级 | {module}/CLAUDE.md              | ✅/未更新/不适用 |
+| 任务级 | docs/tasks/{slug}/task-rules.md | ✅               |
+
+## 更新的资产
+
+| 资产文件                   | 更新内容 | 更新理由 |
+| -------------------------- | -------- | -------- |
+| CLAUDE.md                  | ...      | ...      |
+| frontend/CLAUDE.md         | ...      | ...      |
+| CHANGELOG.md               | ...      | ...      |
+| docs/review-checklist.md   | ...      | ...      |
+| docs/delivery-checklist.md | ...      | ...      |
+
+## 新增规则说明
+
+### 规则 1：{规则标题}
+
+- **文件**：{CLAUDE.md / 模块 CLAUDE.md}
+- **规则内容**：{具体规则}
+- **触发条件**：{什么情况下触发}
+- **可执行指令**：{具体做什么}
+- **消费方**：{哪些下游 Agent 会用到这条规则}
+- **示例**：
+  - ✅ 正确：{好的做法}
+  - ❌ 错误：{坏的做法}
+- **创建理由**：{为什么需要这条规则——引用具体事件或发现}
+
+### 规则 2：{规则标题}
+
+...
+
+## 版本记录
+
+| 日期         | 更新者      | 更新内容   | 关联任务 |
+| ------------ | ----------- | ---------- | -------- |
+| {YYYY-MM-DD} | reviewAgent | {更新摘要} | {slug}   |

package/skills/team-review/references/13-retrospective-template.md

@@ -0,0 +1,40 @@
+# 个人复盘
+
+> reviewAgent 产出
+
+## 一、本次任务回顾
+
+### 做得好的
+
+- ...
+
+### 可以改进的
+
+- ...
+
+### 意外发现
+
+- ...
+
+## 二、AI 协作经验
+
+### 提示词优化经验
+
+- ...
+
+### 团队协作改进建议
+
+- ...
+
+## 二.5、本次沉淀的新规则
+
+| 新规则 | 写入位置                 | 为什么需要这条规则                          |
+| ------ | ------------------------ | ------------------------------------------- |
+| ...    | CLAUDE.md §{section}     | 本次发现 {pattern}，需固化为规则避免重复    |
+| ...    | docs/review-checklist.md | 本次 Review 发现 {issue type}，需加入检查项 |
+
+## 三、下次改进承诺
+
+| 改进项 | 具体行动 | 预期效果 |
+| ------ | -------- | -------- |
+| ...    | ...      | ...      |