| name | iteration-reflection-guard-zh |
| description | 中文迭代反思守门技能：用于科研、算法、工程、方案设计等任何“继续迭代/提出计划/改进方法/复盘经验/避免重复历史错误/保证创新性/列出致命痛点/自我迭代”的场景。Use when: 流程迭代开始前需要吸取历史经验并提出计划，提出新方法后需要列出5个致命痛点，并在痛点分析后连续自我修订3-5轮再定稿；迭代完成后需要主动总结经验、失败边界和下次不要重复的错路。 |
迭代反思守门
Project structure gate / 文件树结构门禁
只要本工作流将初始化或重组项目，或新建、移动应用、服务、包、模块、页面、API、研究步骤、实验、流水线、测试、文档或多文件产物树，必须先使用 project-structure-architect。
- 开始前：读取适用的
AGENTS.md、PROJECT_STRUCTURE.md、.project-structure.yaml 和现有文件树，锁定项目类型、蓝图及唯一合理路径。
- 运行中：每次新增或移动文件前先判断职责、所有者、复用范围和对应测试；禁止同义目录、根目录堆放、跨层混放及无关重组。
- 阶段收口：纵向切片或阶段完成后检查结构漂移；新项目或重大重组更新结构文档，最终运行结构审计。出现
BLOCK 时停止结构性写入并先修正或询问用户。
纯内容编辑且目标路径已由用户或现有规范唯一确定时，可不重复调用。
目标
把“想到一个方案就执行”改成“先吸取历史、再提出单主假设、再反向审查、再自我修正、最后沉淀经验”的闭环。该技能是流程守门，不替代具体领域技能；科研任务可与 research-coach-zh、research-experiment-ops-zh、research-iteration-audit-zh 联用。
工作流
1. 迭代前先吸取历史
在提出计划前，先读取或回顾可用历史材料，至少形成四类清单：
- 已经失败的路线：明确哪些方向不能再走。
- 已经成立的证据：哪些结论可以继承，不要重复验证。
- 当前硬约束：项目规则、冻结口径、指标 gate、文件维护要求。
- 本轮可用缺口：历史没有否定、且仍有创新空间的问题。
如果历史材料不完整，先基于已有上下文列出“暂定历史经验”，不要凭空声称已验证。
2. 提出计划时必须防重复
计划必须先回答：
- 本轮单主假设是什么。
- 它解决的缺口是什么。
- 它为什么不是历史失败路线的改名重试。
- 它的创新性在哪里。
- 它要改善哪个核心指标或细节指标。
- 它的最小验证方式和止损条件是什么。
禁止一次提出多个互相独立的新机制；如果计划必须依赖多个机制，先拆成只读预审或降级。
3. 计划后列出五个致命痛点
每个新计划提出后，必须主动列出且只列出五个最致命痛点。每个痛点包含：
- 痛点描述：为什么它可能击穿方案。
- 击穿方式：会在哪个指标、数据集、工程约束或论文叙事上失败。
- 否决条件：出现什么证据就应停止。
- 修正方向：能否通过改计划解决；若不能，必须止损。
痛点要尖锐，不要写成普通风险提示。
4. 自我迭代 3-5 轮后再定稿
针对五个痛点修订计划。不能只做一轮痛点分析后直接总结；必须围绕同一个单主假设连续做 3-5 轮自我迭代，再给出定稿或止损结论。
每一轮都必须包含：
- 本轮针对上一轮哪些痛点做了修订。
- 哪些痛点被消除、降级或仍然保留。
- 修订后是否引入了新的致命痛点。
- 本轮三色判断和进入下一轮的理由。
每轮修订后做三色判断：
- 绿灯：痛点已被证据或约束合理处理，可以进入下一步。
- 黄灯：可继续，但必须先补一个只读预审或最小验证。
- 红灯：不能继续执行；必须换方向、降 claim 或请求关键证据。
默认在同一答复中做 3 轮 自我迭代；若第 3 轮后仍是黄灯且存在明确修正空间，可继续到第 4-5 轮。第 5 轮后必须定稿或止损，不得继续美化方案。
提前停止条件：
- 第 1-2 轮出现不可绕过的硬红灯时，可以提前止损，但必须明确说明“未满 3 轮的原因”。
- 如果用户明确要求只要简短结论，可以压缩表达，但仍要保留 3 轮修订逻辑。
- 如果进入执行会违反项目规则、伦理边界或实验 gate，必须止损，不能为了凑满轮数而提出伪修订。
5. 迭代完成后主动总结经验
每次迭代、实验、方案审查或流程闭环结束后，主动回答“这一轮可以总结什么经验”。总结至少包含：
- 这次真正学到了什么。
- 哪些假设被支持，哪些被否定。
- 下次不能再走的错路。
- 后续计划必须继承的新约束。
- 是否需要写入项目文档、Tracing、报告或 skill。
不要只总结结果，要总结可迁移的判断规则。
6. 五轮停滞必须深度复盘
如果同一目标连续 5 轮迭代 没有实质效果，必须暂停继续提出新候选，先做一次“停滞复盘”。满足任一条件即视为没有实质效果：
- 核心指标未达到预设 gate 或采纳门槛。
- 只有单 seed、单场景、局部标签收益，综合指标不稳定。
- 每轮都在同一类小修小补上徘徊，未改变瓶颈排序。
- 新方案反复被历史失败原因击穿。
- 结果虽偶有正向，但无法解释机制或无法复现。
停滞复盘必须输出：
- 最近 5 轮的候选、数据、失败原因和共同模式。
- 哪些方向已应判定为收益枯竭，不再重复。
- 当前最可信的瓶颈证据链，而不是直觉。
- 下一步最需要补的证据、工具、压测、profile 或理论分析。
- 继续优化、换方向、冻结成果、重构测量体系四者中的明确选择。
停滞复盘完成前，不得继续扩大实验或新增机制。
输出模板
## 历史经验吸收
- 已失败路线：
- 已成立证据：
- 当前硬约束：
- 本轮可用缺口：
## 初始计划
- 单主假设：
- 非重复性：
- 创新性：
- 指标目标：
- 最小验证：
- 止损条件：
## 五个致命痛点
1. ...
2. ...
3. ...
4. ...
5. ...
## 自我迭代
### 第 1 轮修订
- 针对痛点：
- 修订点：
- 剩余痛点：
- 三色判定：
### 第 2 轮修订
- 针对痛点：
- 修订点：
- 剩余痛点：
- 三色判定：
### 第 3 轮修订
- 针对痛点：
- 修订点：
- 剩余痛点：
- 三色判定：
### 第 4-5 轮修订（仅黄灯且仍有修正空间时）
- 继续修订点：
- 是否定稿：
## 定稿或止损
- 最终方案：
- 不能执行的边界：
- 下一步：
## 本轮经验
- 学到的规则：
- 不再重复的错路：
- 下次必须继承的约束：
硬性规则
- 不读历史就不提出正式计划。
- 不列五个致命痛点就不进入执行。
- 不完成 3 轮自我修订就不定稿；除非出现不可绕过硬红灯，并明确说明提前止损原因。
- 第 4-5 轮只能用于处理仍有修正空间的黄灯，不得为了美化红灯方案而拖延止损。
- 红灯未解除不新增机制、不启动实验、不扩大任务。
- 历史失败路线不能换名字重试。
- 迭代结束必须沉淀经验，而不是只报告完成。
- 连续 5 轮没有实质效果时，必须先做停滞复盘和方向重选，再进入下一轮。
