| name | iteration-work-notes |
| description | Use when a complex task will span turns or sessions and needs structured working notes to survive context compression or handoff; short single-turn work does not trigger it. |
Iteration Work Notes
概述
这个 skill 用来把复杂任务和复杂 debug 的“易丢失上下文”外部化到当前迭代目录下的 work/。
目标不是写第二份 README.md,而是保证在以下场景里不会失忆:
- 上下文压缩
- 多次对话
- 长时间等待
- 中途交接
- 多轮实验后需要回看证据
何时使用
当任务满足以下任一特征时使用:
- 会跨多个阶段或多次对话
- 复杂 debug / 长链路排查
- 需要较长时间等待构建、发布、回归或线上观察
- 需要记录多条假设、证据、已排除路径与下一步
- 用户明确要求“记笔记”“保留过程”“避免上下文丢失”
以下情况通常不需要:
- 小而直接、单阶段、低风险的改动
- 纯措辞调整、轻量文档修补
默认落点
优先使用当前对应迭代目录下的:
docs/logs/v<semver>-<slug>/work/working-notes.md
规则:
- 默认先只用一个
working-notes.md
- 只有当内容明显分叉或持续膨胀时,才拆出更多文件
- 不要仅为了记笔记提前新建新的迭代目录
如果对应迭代目录已经存在,直接在其下创建或更新 work/。
如果对应迭代目录还不存在:
- 用户明确要求提前留痕:可以先建对应迭代目录并开始记
- 用户没有明确要求:先按项目迭代制度判断,不要只为了笔记新开迭代
推荐结构
working-notes.md 默认至少包含以下模块:
当前目标
当前事实
关键约束 / 不变量
证据 / 观察点
活跃假设
已排除项
关键决策
下一步
剩余缺口 / 交接提醒
其中: