告别聊天框：AI编程规则理应入库，.ai目录实践指南

借助AI写代码，为Claude Code、Cursor设定的规范与背景信息，究竟该存于何处？若零散地留在对话窗口或是不断膨胀的CLAUDE.md中，早晚得遗失。本文将阐明：它们应被纳入代码库，专属一个.ai/文件夹。

🗂️ 极速概览（三言两语抓核心，实操见下文）

背景信息切勿散落对话框，关掉即消、换人即断、标准日日变

迁移至仓库，设立.ai/目录，随代码一同提交、迭代与审查

此乃行业共识，AGENTS.md已纳入Linux基金会，绝非凭空捏造

全篇约 1800 字 · 4 分钟阅毕 · 读完盼告之你的背景信息栖身何处

借助AI编程这一载，诸位多半都配置过规范文档：CLAUDE.md、.cursorrules，名称无须纠结。

然而真正投喂给AI的那些「背景信息」，实则散落四方：半数存于对话记录，窗口一关便灰飞烟灭；半数挤在持续膨胀的CLAUDE.md内，臃肿至己亦懒于翻阅；残余仅存于你脑海，换人接手、换台设备便彻底断层。

导致的局面：每启新会话，皆需重述项目背景；同一事项，今朝此番说辞、明朝彼般口径，标准日日漂移。

根治唯有一策： 将背景信息自对话与脑海中抽离， 置入仓库、随代码同步提交。 落实于结构，即赋予仓库一个.ai/目录。

此非笔者凭空臆想

于你萌生「莫非又是谁杜撰的偏门招数」之前——将背景信息纳入仓库，早已成业界共识。

Claude Code的CLAUDE.md、Cursor的.cursor/rules、Gemini的GEMINI.md，实质皆在践行同宗之事。更甚者，AGENTS.md乃OpenAI、Cursor、Google等诸家大厂共铸之开放准则，已被逾六万开源项目启用，更获Linux基金会托管。

航向已然笃定：AI的背景信息，理当与代码同居。.ai/目录恰是沿此脉络再跨一阶——由「单一文档」，迈入「分类明晰的目录」。

.ai/内究竟涉猎何物

以笔者维护之真实后端项目为例（技术栈与语言无碍），.ai/之下大体如是划分：

rules/予AI的铁律（何事不可触）

tasks/需求转译之任务清单

domains/各业务域之领域常识

flows/核心链路如何运转

prompts/定型之指令模板

+ 总纲规则串联此套目录之用法

AI作业即循此道：接获需求 → 转译为tasks任务单 → 修改代码 → 同步domains/flows文档。需求汇入、代码输出，知识库伴之共长。

为何须是「目录」，单文件岂非足矣

硬塞巨型CLAUDE.md可行否？试过者皆晓，单文件顷刻爆满：容不下（数千行己亦难读，AI亦遭信息稀释）、责混杂（动一处牵全局）、索检艰（全量加载徒耗token且难握枢机）。

拆解为目录便具双重裨益：各块各司其职、能独立演进；按需载入、用何块读何块。方堪承载长效协作。

一条可径直照搬之指令

现成背景信息凌乱不堪、无从而起？将下述段落发送予AI，令其助你搭建.ai/初始骨架：

我借AI辅助研发，然投喂AI之背景信息极散： 部分存于对话记录、部分落于冗长之CLAUDE.md、尚有些许仅存脑内。 吾欲将其收敛于.ai/目录、归入版本管控。 莫动业务代码，先替吾办两事： ① 检视项目与现成规范文件，将散落背景信息依类归集 （铁律 / 任务 / 领域常识 / 链路 / 指令模板）； ② 予吾.ai/目录之初始骨架：应建何种子目录、 各纳何物、先从何者启，并将现有CLAUDE.md拆解归位。 仅输出骨架方案 + 归位提议，暂勿撰写实质内容。

其所供乃起步骨架，绝非终局——.ai/乃随项目共生而成，绝非一蹴而就之设计。

AI协作之背景信息，乃与代码等量齐观之资产。 既是资产，理当入版本管控， 而非苟活于随时可关之对话窗口内。

为你的仓库辟设.ai/目录，即系郑重其事之首步。至若内里究竟该撰何物、最忌存放何物、何以防其腐化，每项皆堪单开一文，容后徐徐道来。

💬 如今你予AI之背景信息，栖身何处？

散落对话记录、抑或已入仓库？评论区一叙——最详实者，吾将编入后续篇章。

👍 赞 · 👀 看 · 🔁 转 · ⭐ 注

转予那个CLAUDE.md已书数百行之友 · 同系：CLAUDE.md究竟该撰何物

#AI编程#ClaudeCode#Cursor#AGENTS.md #上下文工程#上下文#.ai