Skip to Content
知识库第 1 期:7x24 小助理Day 6:让 Agent 更容易找到你的信息

Day 6:让 Agent 更容易找到你的信息

到了这一步,你大概率已经发现一件事:

有时候 Agent 很准,有时候它又会很飘。

这不一定是模型忽然变笨了。

很多时候,更真实的原因是:它没有在你的工作区里找到正确的信息,或者虽然找到了,但没能顺利理解和使用。

今天要完成 3 件事:

  1. 理解 Agent 是怎么查找你的私人信息的
  2. 理解哪些结构会让它更容易导航
  3. 对自己的工作区做一次最小改造

今天做完后,你应该体会到一件事:

Agent 不是神奇地懂我,它是在我的文件、目录和说明文档里找路。

Agent 到底在找什么

当 Agent 进入你的工作区时,它并不是像人一样“看见”一个漂亮界面。

它更像是在读下面这些东西:

  • CLAUDE.md
  • 目录名称
  • 文件名称
  • 文件内容
  • frontmatter 里的结构化字段

也就是说,它不是靠灵感在猜,而是靠这些信息来判断:

  • 这是什么地方
  • 哪些文件最重要
  • 哪些材料属于同一个项目
  • 哪些内容更像原材料,哪些更像结果

CLAUDE.md 是工作说明书

你可以把 CLAUDE.md 理解成:

这是你写给 Agent 的工作说明书。

它至少应该帮助 Agent 快速知道:

  • 你是谁
  • 你做什么业务
  • 这个工作区大致是怎么分的
  • 你希望它优先怎么帮你

如果 CLAUDE.md 过于空泛,Agent 就容易每次都从头猜。
如果它写得太大太全,Agent 也容易抓不到重点。

所以 Day 6 不追求“写一份完美说明书”,而是追求:

让 Agent 少猜一点,多理解一点。

目录、文件名、frontmatter 为什么重要

Agent 能不能顺利找到东西,很大程度取决于这三层:

1. 目录结构

目录结构像地图。

如果你的资料全都堆在一起,Agent 就很难知道:

  • 哪些是客户资料
  • 哪些是原材料
  • 哪些是过去的交付
  • 哪些是系统说明

2. 文件命名

文件名像路标。

一个好的文件名,至少应该让 Agent 不打开文件,也能先猜到它是什么。

例如:

  • 2026-05-20_客户访谈_陈总.md
  • 小红书对标摘录_宠物赛道_2026-05.md
  • 交付方案_v2_母婴客户.md

3. Frontmatter

frontmatter 像结构化标签。

它不是第一期必须学得很深的东西,但你可以先知道:当一类文件越来越多时,frontmatter 能帮 Agent 更稳定地识别它们。

比如:

--- type: meeting-note client: 陈总 date: 2026-05-20 ---

这类结构化信息,通常比埋在正文里更容易被 Agent 利用。

今天不追求大改,只做最小改造

Day 6 不建议你一下子重构整个工作区。

今天只建议做这种最小动作:

  1. 补一段更清楚的 CLAUDE.md
  2. 选一个目录,让它的职责更明确
  3. 改 3 个关键文件名,让它们更像路标
  4. 给一类常用文件补一个最小 frontmatter 模板

重点不是“整理得很漂亮”,而是:

让 Agent 下次进来时,更容易找到路。

今天完成什么

完成这三件事就够了:

  1. 打开 CLAUDE.md,补充你的业务和希望 Agent 优先帮助的方向
  2. 选一个最常用目录,确认它到底放什么
  3. 选 3 个关键文件,把文件名改得更容易让 Agent 理解

你也可以直接对 Agent 说:

请从 Agent 导航的角度,看看我现在的工作区最容易让你迷路的地方在哪里。不要大改,只给我最值得先动的 3 个优化建议。

Day 6 成功标准

Day 6 的成功标准不是“你已经学会信息架构设计”。

而是:

  • 你开始知道 Agent 是怎么查找你的私人信息的
  • 你开始理解 CLAUDE.md、目录、文件名和 frontmatter 为什么重要
  • 你已经做了第一轮最小改造,让 Agent 更容易找到信息

下一步就该进入更关键的一层:当 Agent 不听话时,你怎么判断问题到底出在哪里。

Last updated on