用途：为任务执行期间的一次性代码和验证脚本提供约定，适用于冒烟测试、快速探测和临时产物。
主要能力：临时代码与产物存放在工作目录或指定输出目录下的 .scratch/，永不提交。冒烟测试用于快速验证功能是否正常，建议在实现变更后大量编写，类型包括逻辑验证（如用 vitest 断言陈旧性守卫拒绝过期响应）、API/端点探测（如 curl 脚本访问本地开发服务器）、集成检查（如创建资源再读回）、回归探测（如最小复现已修复的 bug）。当冒烟测试捕获到真实问题时，应将其提升为已提交的单元测试。
使用方式：临时代码写入 .scratch/，不要提交；不要存放密钥或原始令牌（.env 值、JWT、API 密钥、cookie）；查看项目说明文件（CLAUDE.md 或 AGENTS.md）获取认证令牌脚本和 API 基础 URL；文件命名要描述性，如 {feature}-{what}.test.ts 或 {endpoint}.sh；逻辑冒烟测试使用项目现有测试运行器（vitest、jest 等）。笔记以 markdown 形式随工作记录，发现、决策和进度会持久保存在磁盘上，跨上下文清除仍保留。可使用同目录脚本：scripts/scratch.sh write --tag research -p "Found that X uses Y pattern"；echo "curl returned 200" | scripts/scratch.sh write --tag probe；scripts/scratch.sh write my-test.sh -p "#!/bin/bash\necho test"；scripts/scratch.sh list；scripts/scratch.sh read @latest；scripts/scratch.sh list --all。通过 run-agent 运行时，会话默认为运行 ID；独立运行时传入 --session 或按日期自动分桶。
适用场景：编写冒烟测试、快速探测、任务执行期间的临时产物。
限制：临时代码不得提交；不得存放密钥或原始令牌；具体认证脚本和 API 基础 URL 需查阅项目说明文件；其余细节暂未提供。