我为什么单独建了一个 Entry Point 仓库
用一间虚构剧场的票房和节目单,试试怎么让 AI 跨仓库查资料、回到该改的地方动手。
~/posts/entry-point-for-ai$cat post.md
假设有间小剧场叫「纸月」。它有两个仓库:一个排节目单,一个出票。剧场和下面的项目名、目录都是虚构的。
节目单上写着「七点入场,七点半开演」,票面上却只印了个「七点半」。现在要补上入场时间。给 AI 派这个活,一句话就够:「看节目单怎么写的,把入场时间也印到票上。」
麻烦在「看节目单」这四个字。你知道节目单是隔壁那个仓库,AI 从票房目录打开,只能看到票房这一边。可以每次都把两条路径贴进对话,也可以找个小仓库把这件事记下来。我把这样的小仓库叫作 Entry Point。
先认得「票房」这两个字
在入口仓库建一份 docs/projects.md,把活跃项目列出来。下面两行就够纸月用:
| 项目 ID | 平时的叫法 | 项目档案 |
|---|---|---|
paper-programme |
节目单 | docs/projects/paper-programme.md |
paper-box-office |
票房、出票 | docs/projects/paper-box-office.md |
入口里的表格可以直接链接到 docs/projects/<id>.md。比如票房的档案叫 docs/projects/paper-box-office.md,里面记两件下次还用得着的事:票面模板由票房维护,从仓库根目录的 printing/README.md 开始读。至于时间字段叫什么,得去看模板。把字段名也抄进入口,以后改个名字就得记得改两份。
这样读一遍刚才那句话,分工就清楚了。AI 去节目单查「入场」和「开演」各取哪个字段,再去票房改模板。要是只说「把纸月的时间改一下」,它就该问问要改票还是改节目单。两边动手容易,印错一批票也容易。
项目名跟目录名可以各叫各的
假设这两个仓库在一台演示机器上叫 playbill 和 tickets。在入口仓库根目录放一份 entry-point.local.toml:
[projects]
paper-programme = "/example/paper-moon/playbill"
paper-box-office = "/example/paper-moon/tickets"
换成你的项目时,进各自的 checkout 跑一次 git rev-parse --show-toplevel,用输出的绝对路径替掉示例值。票房档案里已经写了 printing/,TOML 填到 tickets 就够。以后如果把两边合进一个 monorepo,两个 ID 可以指向同一个 Git 根目录,各自的子目录仍然记在档案里。
/entry-point.local.toml 放进根目录的 .gitignore。随仓库分享一份 entry-point.local.example.toml,留着 [projects] 和一行注释。别人把票房克隆到哪块盘,是他自己那份本机配置的事。
让 AI 搭第一份
打开你打算拿来做入口的 Git 仓库。下面这段换上你自己的项目就能用。
帮我把当前仓库设成 Entry Point。先接一个项目:
<项目名>,我一般叫它 <简称>,仓库是 <URL>,
这台机器上放在 <路径,未知可留空>。这次只写入口仓库。
沿用已有文件。把项目加到 docs/projects.md 的 Active projects 表里,
给它取个小写、用连字符分词的 ID。docs/projects/<id>.md 里写用途、
别名、仓库 URL、产品所在的子目录和应该先读的文档。路径去仓库里核实。
本机 Git 根目录填进 entry-point.local.toml 的 [projects] 表。
保留已有条目,把本机文件加入 .gitignore,另外留一份只有示例的
entry-point.local.example.toml。没给路径就告诉我哪项空着。
给入口写一份简短的 AGENTS.md。以后我点哪个项目就读哪份档案,
进项目先读它自己的 AGENTS.md、README.md 和所改目录里的指令。
简称撞了就问我。只有我说「所有活跃项目」才遍历整张表。
我问状态和 diff 时就用只读命令。fetch、暂存、提交、推送和部署等我明确开口。
另开一个会话,先给它个只读的小活:「想改票面,要先看哪份说明?」在纸月这个例子里,它应该走到票房 checkout 下的 printing/README.md。换成你自己的项目,就看它能不能打开那份文件,从里面找出一个你认得的模板。只报出表格里的名字,还看不出路径有没有填错。
最后回到入口仓库,查一下本机配置有没有混进 Git:
git check-ignore -- entry-point.local.toml
git ls-files -- entry-point.local.toml
第一条应该打印文件名,第二条应该没有输出。下回剧场又想改票面,就可以直接从「票房」说起。