章节主旨
本章是第 3 章「优化工作区组织」的进阶实战版:Nick 展示自己实际用的工作区层级——顶层 business 工作区套 client 子工作区,统一四个核心文件夹,一切文件收进可折叠的 active/ 而绝不污染 root,并把系统提示跨平台同步、按生活领域再拆出 personal 工作区。
核心论点
- 工作区先分「业务/客户」两层,每层只留四个必需件——
.claude/、active/、.env、CLAUDE.md,其余全是平台特化可删。(→ 详解1) - client skills 不必进本地上下文也能调用——在 CLAUDE.md 写一行指路,agent 就能跨工作区拉取非本地 skill。(→ 详解2)
- root 必须干净,所有产物进
active/——由 skill spec 自己声明落盘位置,省掉 agentic lookup 的 token,也让未来模型更好读懂层级。(→ 详解3) active/会持续堆积,需定期让 agent 清扫归类——工作区越干净,里面产出的活也越干净。(→ 详解4)- 把 CLAUDE.md 复制成 AGENTS.md / GEMINI.md 并保持同步——某平台宕机时可无缝切到别的编码工具。(→ 详解5)
- personal 工作区同构但按「生活领域」而非客户拆分——再用编辑器配色区分业务/个人,降低误用上下文的风险。(→ 详解6)
知识点详解
1. 两层工作区与四个核心文件夹 2:24:45
Nick 的顶层是一个 business 工作区(电脑上就是 business/ 这么一个文件夹),他日常所有活都在里面干。别人若照搬,不必要他那堆平台特化文件夹(virtualenv 之类)。
真正必需的只有四件:.claude/(放 skills、agents 等 Claude 特化文件)、一个 active/(或叫 temp,装其余一切生成文件)、.env(API key、凭证)、以及本地 CLAUDE.md(即项目级 系统提示)。
这里区分两层 CLAUDE.md:全局那份放在 ~/.claude/(home 目录下的隐藏 .claude),本地这份放在工作区里、描述本项目/本人上下文。
business 之下再挂 client 子工作区:每个客户一个文件夹,自带该客户的 .env(客户 API key)、.claude/skills/(项目专属 skill)、CLAUDE.md(写清这个客户是谁、团队成员是谁)。有几个客户就有几个 project 文件夹。
2. 跨工作区调用 client skills 2:28:38
这套结构最关键的一点:人在 business 工作区里,也能调用挂在 client 文件夹下的 Skill,不必真把它们载入当前上下文。/context 里只会看到本地那批,但非本地的照样能触发。
做法是在 CLAUDE.md 里写一行说明:有些 skill 不住在本地 .claude/skills/,而是 client 专属;要用就去对应 client 文件夹里把它取出来。
好处是既保留了「客户资料/技能物理隔离」,又不牺牲随手调用的便利——比如给某数字营销客户写的「连他们的服务打印报表」的 skill,就归在那个 client 文件夹,但需要时仍能从主工作区喊出来。
3. 不污染 root,一切进 active 2:29:21
铁律:别往 root 直接丢东西,永远存进 active/ 或某个子目录。root 一旦被散文件塞满,不仅人看着炸裂(那个面板一直开着、无限往下滚),对 agent 也是一团乱。
落盘位置不靠人记,而由 Skill spec 自己声明。比如 model-chat 这个 skill 就在自己文档里写死「把结果 dump 到 active/model-chat/ 并按某规则命名」,于是对话线程自动挂到固定位置。
这样还省 token:agent 不必再做 agentic search / lookup 去找该放哪——而每次 agentic 查找都在烧 token。随手写脚本、临时文件、data 文件都绝不进 root。
更临时的东西(一次性、进程期内用完就扔的),Nick 放进隐藏的 active/.tmp/,连 active/ 都不弄脏。担心「层层嵌套会丢东西」?不会——如今你用「问 agent 帮我找 XYZ」换掉了「人肉滚 root」,只要明确规定「一律进 active」,agent 会相当一致可靠地帮你归置。
4. 定期清扫 active 2:32:49
因为不往 root 丢,active/ 就会持续堆料(视频链接、research 产物、截图……)。所以要周期性地让 agent 清扫。
指令大意:「清理 active/,子文件夹里的不动;凡是松散躺在根层的 txt / py / jpeg 之类,你自己判断——纯临时文件直接删,其余归进合理的子文件夹。」两秒内它就整完,active/ 立刻清爽。
Nick 演示时还让 agent「枚举 active 里所有 web design 项目、找出同类、统一收进 web-design/ 文件夹」,一次归置十来个。他的观点是:工作区越干净,在里面产出的活也越干净,且未来任何新模型都能顺着清晰层级做决策。
5. 跨平台同步系统提示 2:31:47
呼应「不要只绑死 Claude Code」的思路:把 CLAUDE.md 原样复制成 AGENTS.md 和 GEMINI.md,在每个工作区都放齐这三份。
再在 CLAUDE.md 里加一行「始终让 CLAUDE.md 与 AGENTS / GEMINI 身份保持同步」,agent 就会自动维护三份一致。这样无论想临时用 Cursor、Anti-gravity 还是直接 Claude Code,系统提示随时就位、不会缺失。
价值在容灾:某平台宕机(Nick 提到约一个半月前有过一次),可以立刻把上下文切到另一个编码平台继续干,而不必重写身份设定。
6. personal 工作区:按领域拆分 + 配色区分 2:35:36
Claude 早已不只是业务搭档,也帮 Nick 打理个人事务(健康、入籍文件、身份证件、学钢琴之类,非私密八卦)。所以他另开一个 personal 工作区,结构与 business 完全同构。
区别在拆分维度:business 按 client 拆,personal 没有客户,改按「生活领域/项目」拆——他现有 citizenship(正在办某欧洲国家入籍以拿欧盟身份)、health(装可视化基因数据的 skill)等子项,各自也可挂对应 skill。
配色区分(2:37:14):他用编辑器的 .vscode/settings 把 personal 工作区的标题栏描边改成绿色。不是大功能,但一眼就知道「我在个人工作区、可谈个人信息」,省得重新灌一堆上下文。
其他组织方案(2:37:58):不必照抄这套。也可以顶层放公司名、下设 projects/,再按 website-design / CRO / lead-gen 枚举项目;或把 CRM 做成 Claude Code 里的一个 json、用 cron 每日同步日历事件;或把一切托管 GitHub、夜里 clone/push 上云。实在不知怎么搭,直接让 Claude 帮你设计命名方案即可。
术语
- workspace(工作区,一个承载某类事务全部文件的顶层文件夹)
- root(工作区根目录,散文件堆积会拖垮人与 agent)
- active folder(集中收纳一切生成/临时文件的可折叠目录,替代直接丢 root)
- system prompt(系统提示,此处指 CLAUDE.md / AGENTS.md / GEMINI.md 里的项目级上下文)
- client folder / project folder(客户或项目子工作区,自带 .env、skill、CLAUDE.md)
- agentic lookup(让 agent 主动搜索定位文件的行为,耗 token,应靠固定落盘规则避免)
自检问题
- Nick 认为一个工作区真正必需的四个文件/夹是哪些?
答案:
.claude/(skills、agents)、active/(其余一切生成/临时文件)、.env(密钥凭证)、CLAUDE.md(本地系统提示);其余平台特化文件夹可删。见详解1 2:24:45 - 人在 business 工作区,如何用到挂在某 client 文件夹下、并未载入当前上下文的 skill?
答案:在 CLAUDE.md 写一行指路,声明部分 skill 属 client 专属、不在本地
.claude/skills/,要用就去对应 client 文件夹取出;/context虽只显示本地那批,非本地的仍可调用。见详解2 2:28:38 - 「一切进 active、不污染 root」除了视觉清爽,对 agent 有什么实际收益?
答案:落盘位置由 skill spec 自己声明(如 model-chat 写死存
active/model-chat/),agent 无需做 agentic lookup 去找该放哪,省 token;层级清晰也让未来模型更易按结构决策。见详解3 2:29:21 - 为什么要把 CLAUDE.md 复制成 AGENTS.md / GEMINI.md 并保持同步? 答案:容灾与可迁移——三份系统提示齐备且自动同步后,某平台宕机可无缝切到 Cursor / Anti-gravity / Gemini 等继续工作,不必重写身份上下文。见详解5 2:31:47
- personal 工作区与 business 工作区在「子层拆分维度」上有何不同? 答案:business 按 client(客户)拆子工作区;personal 没有客户,改按生活领域/项目拆(如 citizenship、health),各自可挂对应 skill;并用编辑器配色(标题栏描边)区分两类工作区。见详解6 2:35:36