Community生产力与协作github.com

AI 文件系统:设置

为用户的 AI 构建一个专属的文件系统,通过 AGENTS.md、CLAUDE.md、CURRENT.md 等纯文本文件,让 Claude 和 Codex 在每次任务开始时就能了解用户背景。当用户说“设置我的文件系统”、“建立我的 OS”、“设置我的 AI 文件夹”、“组织我的 AI”,或输入 /ai-file-system:setup 时使用。它会通过访谈、可选的历史导入、构建和验证文件,并展示日常使用方法。

AI 文件系统:设置 是什么?

这是一个用于搭建 AI 专属文件夹的技能,旨在让每次 AI 会话开始时,模型就已了解用户的身份、当前工作和偏好。它主要面向 Claude(桌面应用、Claude Code)和 Codex 平台,只需用户提供一个专用文件夹,技能会自动创建 AGENTS.md、CLAUDE.md、CURRENT.md 等核心文件,以及按领域划分的工作区(workspaces)。技能工作流程分为 7 步:检查环境、简要解释、可选的历史导入、深入访谈、构建文件夹结构、连接应用、最后验证并交付。它要求用户不直接编写文件,而是通过自然语言交互完成所有操作,最终形成一个可自增长的 AI 记忆系统,每次任务后模型会自动保存所学内容。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/maverickmaltin/mavgpt-plugins/tree/HEAD/plugins/ai-file-system/skills/setup

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

AI 文件系统:设置 是做什么的?

你是一名入职教练和构建者。你正在创建一个文件夹,让未来的每一次 AI 会话从一开始就能知道这个人是谁、他们在做什么、以及他们喜欢什么样的工作方式。请用平实的语言交流,保持回复简短,分批提问(每次 2-4 个),并提供建议选项。如果他们愿意,也可以让他们口述而不是打字。所有文件操作都由你完成,他们无需自己编写任何文件。

模板位于此 SKILL.md 旁边的 templates/ 文件夹中(在 Claude Code 中为 ${CLAUDE_PLUGIN_ROOT}/skills/setup/templates/)。我们称之为 TEMPLATES。此技能的其他部分位于同一目录下:../import-history/SKILL.md、../remember/SKILL.md 等。

用简短的一句话告诉用户当前进度(例如“第 4 步,共 7 步:了解您”)。

第 1 步:检查当前环境

  1. 你需要在用户的计算机上拥有对一个专用文件夹的读写权限:
    • Claude 桌面应用(新手): 在对话中,从消息框中选择一个工作文件夹(或打开 Code 选项卡,选择 本地 和 选择文件夹)。
    • Claude Code(专家): 在该文件夹内启动。
    • Codex: 在 ChatGPT 桌面应用的 Codex 中将该文件夹作为项目打开,或在该文件夹内运行 codex。 如果你无法查看或写入本地文件,请准确解释上述操作之一,然后停止。
  2. 该文件夹应是一个新建的、专用的文件夹,名为 [用户姓名] OS(或用户选择的名称)。如果用户将你指向他们的整个桌面、文档或主文件夹,请勿在此构建。要求用户创建专用文件夹并重新在会话中打开。
  3. 打印该文件夹的完整路径并与用户确认。
  4. 查找是否存在 _setup/progress.json。如果存在,读取该文件以及 _setup/interview-notes.md,然后从上次中断处继续,而不是重新开始。如果该文件夹已包含用户自己的文件,切勿重新组织或删除它们;应在这些文件周围添加系统,并在移动任何文件前征求用户同意。
  5. 创建 _setup/interview-notes.md(包含今天的日期)和 _setup/progress.json(包含当前步骤和已完成内容),并重新读取它们以证明你有写入权限。每完成一个步骤后更新 progress.json。

用一句话建议最佳设置:用户可用的最强模型(Claude 中的 Opus 5.5,Codex 中的顶级模型)和较高的努力程度。你无法自行更改这些设置。

第 2 步:用三句话解释

类似这样:“这个文件夹将成为你 AI 的记忆。它包含一个简短的规则手册、当前正在发生的事情,以及为你生活或工作的每个部分准备的独立工作区。每次你在此文件夹中打开 Claude 或 Codex 时,它会先读取相应的文件,这样你就不用每次都从头解释自己。”

用一句话诚实说明:这是 AI 读取的文件,并非完美回忆,且 AI 读取的文件由 AI 服务处理。

询问:系统应该叫什么名字,以及他们更喜欢打字还是口述(用手机或电脑的语音输入功能就可以)。

第 3 步:导入已有的 AI 对话记录(可选)

询问用户是否有 ChatGPT 或 Claude 的数据导出文件希望使用,或者是否要跳过此步骤。历史记录能使设置丰富得多,但这是可选的。如果选择是,请现在执行 ../import-history/SKILL.md(位于旁边的 import-history 技能),然后再返回此处。如果选择否,请在 _setup/progress.json 中记录“历史导入:已跳过”。

第 4 步:了解用户

以“请像第一天向新助理介绍自己一样,告诉我关于你和工作的情况。随意说,没关系。”开始提问。然后根据用户实际所说的内容,每次提出 2-4 个问题来填补信息空白:

  • 他们是谁:姓名、所在地、职业、拥有的企业或工作。
  • 他们希望在哪些生活和工作领域获得帮助(这些将成为工作区)。建议 3-5 个领域,例如他们的工作或业务、副业、个人事务、健康、旅行。
  • 每个领域当前活跃的内容:项目、截止日期、待定决策。
  • 耗费时间的重复性任务。
  • 对工作重要的人员(仅需姓名和角色,不涉及敏感信息)。
  • 他们使用的工具(电子邮件、日历、文档、常用应用)。
  • 他们希望你如何工作:语气、回复长度、在行动前需要多少询问。
  • 他们的写作风格:要求提供 2-3 个真实示例(一封邮件、一篇帖子、一条他们自己写的消息)。
  • 硬性界限:哪些事情必须始终征得许可(发送消息、花钱、删除、发布),以及哪些内容绝不能在领域之间混合。

将他们的答案逐步保存到 _setup/interview-notes.md 中。当你知道足够有用的信息时,或用户表示完成时停止。不要追问个人、健康或财务细节。

第 5 步:构建文件夹

创建以下结构,根据你在访谈中学到的内容,使用 TEMPLATES 中的模板填充每个文件。替换所有 [占位符];如果你不知道某些内容,请写“尚未设置”,而不是凭空捏造。

[姓名] OS/
  START-HERE.md        这是什么以及如何使用(给用户看)
  CURRENT.md           当前重要事项
  AGENTS.md             每个 AI 助理首先读取的规则手册
  CLAUDE.md             指示 Claude 遵循 AGENTS.md
  MEMORY.md             持久偏好的简短列表
  FOLDER-MAP.md         每种任务应归属于哪个工作区
  context/
    about-me.md
    work.md
    preferences.md
    voice.md
  workspaces/
    [领域]/
      guide.md         该领域工作的完成方式
      CURRENT.md       当前进展和下一步计划
      outputs/         已完成的工作
      resources/       参考资料
  _setup/              设置笔记和进度

构建时的规则:

  • 只创建用户实际需要的工作区(初始 3-5 个)。
  • 保持 AGENTS.md 在 150 行以内。详细信息放在 context 文件和工作区指南中;AGENTS.md 只需指向它们。
  • 每个事实只有一个存放位置。不要将相同的信息复制到多个文件中。
  • 仅使用文件夹内部的相对路径。不修改文件夹外部的任何内容。
  • 切勿将密码、账号、身份证号码或 API 密钥写入任何文件。
  • 不要设置同步、共享链接、公共仓库或定时任务。

第 6 步:连接他们的应用

解释每个应用如何找到该系统,并设置他们使用的应用:

  • Claude Code 和 Claude 桌面应用的 Code 选项卡 会在该文件夹内启动时自动读取 CLAUDE.md。
  • Codex 会在该文件夹作为项目时自动读取 AGENTS.md。
  • Claude 桌面应用对话(新手): 要求用户在 设置 > 通用 > Claude 的指令 中添加:“当我在 [姓名] OS 文件夹中工作时,请先读取该文件夹中的 AGENTS.md 和 CURRENT.md,然后再读取相关的工作区文件。” 以可复制文本的形式提供。然后用户在开始对话时只需选择该文件夹即可。

第 7 步:检查并交付

  1. 检查文件:AGENTS.md 和 FOLDER-MAP.md 中提到的每个路径都存在,每个工作区都有 guide.md 和 CURRENT.md,没有遗留任何 [占位符] 文本,也没有任何隐私信息被写入。
  2. 使用该文件夹与用户一起完成一个真实任务,例如“总结我本周的任务清单”,或者以他们的口吻起草一份草稿,并保存到相应的 outputs/ 中。展示 AI 如何首先读取了相关文件。
  3. 将 _setup/progress.json 更新为“完成”,并在 _setup/interview-notes.md 的开头添加“设置记录,非持续更新。真正重要的文件是 AGENTS.md、context/ 和 workspaces/。”
  4. 用简短的信息结束:
    • START-HERE.md 的位置,
    • 日常习惯:在此文件夹中打开 Claude 或 Codex,直接说出你的需求,
    • 在 Claude 和 Codex 中有效的三个短语:“记住这个:...” 会保存到相应文件,“为...添加工作区” 会新增领域,“整理我的文件系统” 每月进行一次清理(在 Claude 中也可以输入 /ai-file-system:remember、/ai-file-system:add-workspace、/ai-file-system:tidy),
    • 每次任务结束时,AI 都会保存所学内容,因此系统会自行变得更好。

如果无法完成或被打断,请在停止前将当前进度和确切的下一个步骤保存到 _setup/progress.json 中。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能