AI 工作台

我在 Mac 上给 AI 建了个“工位”,从此它认识我了

大家好,我是文鉴。

很多人把“一人 + AI”公司当作独立生存的新路径。比如我——一级注册结构工程师,在工程与地产管理行业干了二十多年后,认真转型全职独立开发。

如何做到一个人把产品和业务跑起来?第一步是跟你的合伙人与执行搭档——也就是 AI——建立稳定的上下文机制。

YC 提出过两个很关键的概念:

  • Queryable Company:业务的一切必须可被查询
  • Legible to AI:工作现场的一切必须对 AI 可读

换成直白的话:如果一件事没有被记录成 AI 能直接读取的结构化文本,那对下一次会话里的 AI 来说,这件事就等于没发生过。

大多数人用 AI 的方式是:打开聊天框 → 粘贴一段背景 → 问一句 → 关掉窗口。这是把 AI 当临时搜索引擎。而我现在在本机打开终端工具时,它一启动就知道我是谁、正在推进哪几个项目、遵守什么代码规范、昨天停在哪一步。

下面把我从零搭建本机 AI 工作台的做法完整拆解出来,不讲虚概念,只讲实际落地的结构。


没有工作台之前的三个典型痛点

日常开发中我同时使用 Claude Code、Codex 等多个工具,最初最让人抓狂的是三件事:

  1. 工具接力时上下文断裂:一个工具额度用完切到另一个工具,前面的架构背景、踩过的坑全得重新交代一遍。
  2. 重复解释基础边界:“回复用中文、先给结论、不要过度设计、去哪里找环境变量名”——每次开新会话都要重讲。
  3. 经验与决策散落在聊天框里:上个月查清的部署坑或接口限制,隔两周在几十个历史会话里根本翻不到。

归根结底只有一个原因:AI 每次都在重新认识你。 解法也很直接:在本机工作目录里建立统一的文本事实源。


核心枢纽:一份“员工手册”,多端软链接共读

不同终端 AI 工具默认自动读取的指令文件名不同:

  • Claude Code 默认读取 CLAUDE.md
  • Codex 默认读取 AGENTS.md
  • Gemini 工具链默认读取 GEMINI.md

我的做法是只维护一份主指令文件,其余两个文件名通过软链接指向同一份源文件:

ln -s AGENTS.md CLAUDE.md
ln -s AGENTS.md GEMINI.md

改一处,所有 AI 工具同步生效。手册里只放高密度的导航与铁律:我是谁、目录边界在哪、去哪个文件查状态、哪些高风险动作必须人工批准。


支撑日常运转的五个核心组件

1. 个人画像与沟通约束

单独整理一份个人与经营背景说明:非科班出身但做过二十年工程项目管理、熟悉的技术栈、偏好的沟通风格(先结论后分析、有问题直说、代码保持单一职责与最小实现)。AI 读完后不再输出客套话,也不会给出脱离一人公司维护能力的复杂架构。

2. 三层凭证隔离机制

既要让 AI 顺畅编写调用外部平台的代码,又绝不能让真实密钥暴露在对话上下文或 Git 仓库里。我把凭证拆成三层:

  • 第一层(真实密钥):存放在仓库外的本机受保护环境文件(权限 600),永远不进入文档、不进入 AI 上下文、不进入 Git。
  • 第二层(变量名索引):只记录环境变量名称与用途,不记录任何真实值。
  • 第三层(能力路由):记录图像、语音、存储、部署各环节选定哪个平台及已验证边界。

AI 写代码时只引用环境变量名,真实密钥只在受控运行时加载。

3. 本地 Markdown 知识库

使用本地文件夹配合 Obsidian 维护长期知识库:一手思考原稿、外部精选资料索引、经过自己项目验证后的可复用专题分开存放。AI 负责按规则检索和归档,人负责用可视化界面审阅和做判断。

4. 技术状态与每日记录分离

为了防止 AI 跨天“失忆”,把记录拆成两类互不混用的文件:

  • STATUS.md 与 CHANGELOG.md:只写当前经过验证的技术事实和历史技术变更,不写情绪或计划。
  • daily/YYYY-MM-DD.md:每天收工花几分钟记清楚今天完成了什么、卡在哪里、下一步做什么。

第二天打开终端,AI 先读 STATUS.md 掌握现场,再继续推进,不需要从头寒暄。

5. 独立项目边界

每个具体的网站或工具都有自己独立的 Git 仓库、独立的指令文件和独立的 STATUS.md。根工作区只保留全局索引与经营视角,不把业务源码混存成一锅粥。


今天就能动手的最小起步方案

不需要第一天就把所有目录建齐,按下面四步半小时就能跑起来:

  1. 建一个统一的本地工作目录,存放跨项目的记录与规范。
  2. 写一份不超过 50 行的初始 AGENTS.md:写清你的背景、沟通要求、常用技术栈和禁止事项。
  3. 建立 CLAUDE.md 与 GEMINI.md 软链接,统一多工具入口。
  4. 养成每天收工更新状态文件的习惯。

记住那条最朴素的原则:把你的工作现场变成 AI 可读的纯文本,是一人 AI 公司真正的地基。