用途:当智能体需要生成进度跟踪、报告或临时数据文件时,使用系统临时目录而非仓库根目录,避免污染项目。
目录结构:所有临时文件使用基础路径 /tmp/claude/{sanitized-cwd}/,其中 {sanitized-cwd} 是当前工作目录路径,先去掉开头的斜杠,再把 / 替换为 -。例如在 /Users/bobby/workspace/pivot/llamafarm 下工作,对应 /tmp/claude/Users-bobby-workspace-pivot-llamafarm/。
创建步骤:
- 创建目录: SANITIZED_PATH=$(echo "$PWD" | sed 's|^/||' | tr '/' '-') REPORT_DIR="/tmp/claude/${SANITIZED_PATH}/reviews" mkdir -p "$REPORT_DIR"
- 生成唯一文件名,格式为 {descriptor}-{YYYYMMDD-HHMMSS}.{ext}: TIMESTAMP=$(date +%Y%m%d-%H%M%S) FILENAME="code-review-${TIMESTAMP}.md" FILEPATH="${REPORT_DIR}/${FILENAME}"
- 使用 Write 工具写入完整临时路径。
- 始终告知用户文件创建位置,例如:Report saved to: /tmp/claude/Users-bobby-workspace-pivot-llamafarm/reviews/code-review-20260108-143052.md
适用场景:代码审查报告、分析输出、进度跟踪文件、测试结果摘要,以及任何未指定具体位置的生成文档。
不适用场景:用户明确指定文件路径;创建需要提交的文件(如 README、配置文件);编辑已有文件。
清理说明:/tmp/ 中的文件在系统重启时会被清除。若用户需要保留文件,建议复制到永久位置。