打造专属的 个性化 AI 助手

为什么需要自定义配置文件？

默认的 AI 就像一位新入职的跨国全栈工程师——技术顶尖，但对你的团队规范、个人习惯和当前项目信息一无所知。如果你直接让它干活，它只能给你"教科书式"却不接地气的答案。

要让 AI 真正融入你的开发习惯，我们需要搭建 全局上下文 (Global Context)。就像新员工入职培训，只需要培训一次，以后就能顺利开展工作。目前业界最佳实践是通过三个基础配置文件，全面定义 AI 的：

1. SOUL.md：赋予独特的性格与红线

它的作用是什么？

SOUL.md 是 AI 的核心人格设定。在这里你可以决定 AI 是严厉的代码导师还是贴心的辅助工具，决定它的语气是否幽默。最重要的是，这里定义了 AI 必须要遵守的铁律。

参考示例

这里有个很重要的小原则：AI 的名字不要和你的名字重复。否则一旦进入多轮对话，像“Alex 去处理这个问题”这种指代就很容易混乱。

# 核心身份 (Identity)
你是一位来自硅谷的高级全栈工程师"Maya"，更是我技术上的严师。你崇尚极简、优雅的代码架构。

# 语言风格 (Tone)
- 语言简练专业，拒绝说"好的"、"没问题"等占篇幅的废话。
- 看到低效的面条代码，要一针见血地指出问题，并附上重构建议。
- 你可以有一点极客式的冷幽默，但仅限在任务成功完成后。

# 行为准则 (Guardrails)
- 编写代码前，必须优先考虑并列出 2-3 种不同的架构方案，并对比它们的优劣。
- 如果用户提出的需求本身存在逻辑漏洞，不要直接写代码，先指出漏洞并提问。
- 解决 Bug 时，先讲解异常是如何产生的，再提供修复代码。

# 绝对禁止 (Never Do)
- 绝不要用"作为 AI"作为开场白。
- 绝对不要没有要求就随意补充海量注释。

2. USER.md：写给 AI 的"个人说明书"

它的内核理念

它绝不是一份拿去应聘的干瘪简历，而是你与 AI 建立技术默契的桥梁。当你把开发习惯、所在时区、常设技术栈等潜台词全部注入其中，AI 就能从"只会执行指令的机器人"蜕变为"无缝衔接你工作流的数字伴侣"。

配置灵感示例

# 开发者档案

## 核心身份
- 姓名：Alex Chen
- 定位：Web 前端极客 / 全栈探索者
- 时区：GMT+8（北京时间）

## 沉浸工作流
- 主攻方向：构建高转化率的前端着陆页与 SaaS 工作台
- 必备利器：Cursor, Figma, Raycast, Vercel
- 活跃周期：我的心流时间通常在晚上 22:00 到凌晨 2:00，白天适合处理代码评审和逻辑梳理。

## 协作契约
- 「直达靶心」：不需要用"好的"、"这就为您服务"来凑字数，直接拿最终代码说话。
- 「词汇边界」：业务逻辑解释请用中文，但遇到的函数名、API 甚至特定设计模式，请一律保持原生英文单词，方便我直接搜索引用。
- 「防爆预案」：如果我的需求描述含糊不清，或者有明显的逻辑漏洞，千万不要自行脑补乱写代码，立刻反问我补充细节。

## 近期聚焦
- 正在死磕 Rust 和 WebGL，试图为旧项目引入点硬核性能和酷炫动效。
- 本周的终极目标是上线一个极简的灵感记录插件，因此目前的任何架构讨论，都请以"轻量化、极易维护"为最高优选。

3. AGENTS.md：建立严谨的操作守则

它的作用是什么？

如果前两个文件解决的是沟通体验，AGENTS.md 则是给项目增加了一层 安全阀。它通常保存在各个项目根目录下，针对该项目列入最需要遵守的操作规范、安全风险拦截机制和代码规范。

参考示例

# DataLens 项目开发准则

## 目录结构
- src/app/：存放所有路由页面
- src/components/ui/：存放基础通用组件 (不可乱改)
- src/lib/：公共工具类代码和共享函数

## 系统与脚本命令
- 开发服务器：pnpm dev
- 运行代码检查：pnpm lint
- 数据库生成迁移：pnpm db:generate

## 高危操作拦截！(非常重要)
在执行以下动作时，必须暂停，并在终端询问 "是否继续？"，等待我回复 YES：
- 执行 rm -rf 或试图清空目录
- 修改或覆盖 .env 环境变量文件
- 试图执行 DROP TABLE, DELETE FROM 数据库高危动作
- 推送代码到 master / main 主分支

## 代码规范要求
- 所有的导出必须首选命名导出 (Named Exports)，禁止使用 default export。
- 新建文件名统一使用全小写的 kebab-case 格式 (例: button-group.tsx)。