用途:把人工 QA 中零散的 UI 打磨项集中成一份 punch-list,避免边测边改、逐条打断。
主要能力:分 capture、dispatch、verify 三种模式独立运行。capture 只记录不修改产品代码、配置、文案或资源,仅写清单行、Held 备注和 QA 截图;dispatch 仅在用户明确指示后触发,按 PROJECT-CODE 分组交给编码 CLI,每个任务限定“只修列出的项,不重构、不顺手改”;verify 对比实际服务输出而非源码,逐行给出证据,标记 verified 或 reopened。
使用方式:清单存放于 <artifacts-root>/specs/qa/<SPEC-ID>-punchlist.md,无 spec 时按日期命名。表格列为 #、PROJECT-CODE、Where、Wrong → Right、Shot、Status。状态流转为 open → dispatched → verified 或 reopened。每次阶段转换输出 Stage / Found / Next / Needs user。
适用场景:跨仓库或单仓库项目中,人工 QA 阶段收集纯视觉/文本小修,统一派发与验证。
限制:仅限外观范围,涉及行为、数据或接口的改动不算 nit,需转 /to-tickets 或 /qa-escape;整页与设计源不一致应走 /pixel-audit;不得添加 AI 或工具署名;不确定归属时先询问,未确认 PROJECT-CODE 前不派发;共享字符串键、多语言键需用户确认,不自动翻译。具体安装命令与收费信息暂未提供。