进展汇报件

位置：交付期第 12 步。上一步 slice-closeout，下一步 cleanup。顺序与例外见入口技能 single-session-dev-flow。

人把注意力移开之后，靠汇报件把控进度、健康度并快速反馈。汇报件的目的不是留档，是让人的注意力停在架构、产品、交互体验三个层面，不下到技术与代码细节。

汇报讲的是思维模型 think-ought-vs-is 里的差异：和之前比变了什么，和目标比还缺什么。

什么时候出

• 每次顶层回看之后，有变化就出一份。
• 每个切片收口之后。
• 一程交付时出最后一份，连同交付声明。

没有变化时不出。空汇报比没汇报更坏。

三种形式

讲法

用追进度的讲法，加载技能 pstack:ketchup：说变化，不说过程；说「测试过了」，不说「门禁绿了」；不写哈希、路径、命令、测试数，除非人要据此做决定。开头一句话说有什么等人决定，没有就说没有。待人决定的每一项给出自己的建议、依据和风险。不编造决定来填篇幅。

汇报件是代理交给人的一次转手，人读得完、验得完的才算交到了。转手会丢信息，回路越紧越稳，一块多大由接的一方验得完多少定。做法加载技能 think-closed-loop。

没验收的库存

每份汇报件都有一栏「没验收的库存」：代理做出来、人还没上手验过的行为，每样写人怎么验、要几分钟、证据在哪，末尾写合计与人的验收窗口。它看着是进度，其实是风险，人据此决定回来先验什么。每一程都有这一栏，不因为人越过了哪条提醒而多写或少写。Markdown 版照汇报件骨架写；网页生成脚本不出这一栏，要它时另附一份按骨架写的 Markdown。看到人这一侧的风险就说一次：提醒、依据、建议、选择。做法加载技能 candid-friend。

晨间交付

人交了夜间一程、早上回来看的那一份汇报件，三条规矩：

1. 第一行写有什么等人决定，没有就说没有。
2. 每样交付写怎么上手验、要几分钟、证据在哪，就是「没验收的库存」那一栏。
3. 没做的、跳过的、停在最后一步之前等人授权的，逐条明说。不写「全部完成」。

放在哪

统一放操作系统临时目录，各操作系统一致，借用系统的定期清理：

<系统临时目录>/pqw-skills/<会话标识>/<一程标识>/artifacts/

路径由 scripts/artifacts-dir.mjs 解析并创建，系统临时目录按 Node 的 os.tmpdir() 取值：Linux 与 macOS 通常是 $TMPDIR 或 /tmp，Windows 是 %TEMP%。会话标识从宿主环境变量取，取不到时由调用方传。汇报件不进仓库，不进项目 tmp。

要人看时直接在 IDE 打开，不只给路径。

清理

用完即弃。切片交付和一程交付后的清理归 cleanup，加载它。汇报件是这一程的材料，随清理删。里面属于约束的（架构与领域边界、规格的六样、能写成检查或证明的）在交付前落到它的拥有者；其余不搬。