git-temp：为 AI 代理提供不被 Git 追踪的本地草稿区

Show HN 上出现了一款名为 git-temp 的轻量命令行工具，目标是让 AI 代理在 Git 仓库内拥有一块「本地草稿区」：既能被编辑器和 AI 工具检索、被 @ 引用，又不会污染 git status，也不会被误提交进仓库。它通过 .git/info/exclude（而非共享的 .gitignore）来实现本地忽略，从而保留对 AI 索引的可见性。

核心思路

传统做法是把临时文件写进 .gitignore，但这会让编辑器、AI 代理和 LSP 等工具在索引、补全、@ 引用时直接跳过这些文件。git-temp 把忽略规则放进仓库本地的 .git/info/exclude，这样文件只在当前机器上对 Git 不可见，对本地工具链则完全可见。它还会清理嵌套在 temp/ 下的、含 * 或 /* 的阻断式 .gitignore，避免对子目录形成覆盖。

命令与目录结构

工具通过 npx 直接运行，常用命令包括：

npx git-temp：初始化，在当前仓库下创建 temp/ 目录及子结构。
npx git-temp notes：创建独立的 notes/ 目录。
npx git-temp status：查看被忽略的草稿内容，含文件数、目录数、体积与修改时间。
npx git-temp clean -f：清空并重建草稿目录。
npx git-temp integrate：向现有代理指令文件中追加草稿使用说明。

默认目录结构按用途做了分层：

temp/scripts/：一次性脚本。
temp/dumps/：JSON、CSV、日志与载荷数据。
temp/drafts/：笔记与草稿规格。
temp/scratch/：实验性内容。
temp/README.md：面向人与 AI 代理的说明文件。

与主流 AI 代理指令文件集成

integrate 子命令会识别并更新以下几类常见的 AI 代理配置文件，向其中追加一段「AI 草稿区使用指引」，而不会覆盖原有内容：

AGENTS.md
CLAUDE.md
.cursorrules
.windsurfrules
.github/copilot-instructions.md

这样在 Cursor、Windsurf、GitHub Copilot 等代理场景下，草稿目录会被工具「看见」并参与上下文引用，但不会被 Git 状态或提交记录打扰。

适用场景与限制

工具本身定位为「零依赖、npx 直跑」的脚本，对运行环境的要求仅为 Node.js 18+ 与 Git，且必须运行在已有 Git 仓库内。它更适合需要让 AI 代理在代码库中临时读写文件、又希望保持仓库整洁的个人开发者与小型团队；对于多人协作或对仓库历史有严格审计要求的场景，仍需要配合项目级 .gitignore 与分支策略使用。