Project Butler · AI 资产管家
丢给 Agent 安装

让每次与 AI 协作的经验，
都变成你 AI 时代的固定资产。

Project Butler 是一份给编码 Agent（Claude Code / Codex / ZCode / Cline…）的用户级 Skill：它把你和 AI 协作产生的项目、经验、习惯、踩坑，持续沉淀为记在你名下的 Markdown 资产——工具会过时，平台会换，你的资产一直在增值。

确权资产记你名下，不锁任何平台
增值AI 越用越懂你，经验产生复利
可继承换工具、换电脑、跨会话带得走
防流失踩过的坑、配过的环境不再重来
一键安装 先看工作流

解决什么问题

每个用过 AI 写代码的人都被这三件事坑过。

换个会话，AI 失忆

环境怎么配的、上次卡在哪、密码放哪——每次都要重新交代一遍。

→ 交接文档 + 资产索引，新会话无缝继承全部家底
文件散落一地

脚本在桌面、数据在下载、项目在临时目录，三个月后自己都找不到。

→ 有归属才叫资产：新项目强制建文件夹，过程文件进 _work/
踩过的坑反复踩

同一个报错，这个会话解决了，下个会话再折腾一小时。

→ 踩坑经验库：一次解决，永久入库，AI 遇错先查它

工作流：9 条规则管住 Agent

装好后它自动生效，不需要你记得嘱咐。

  1. 开场先读资产库索引 — 一份 ≤200 行的总入口，按需深入习惯/踩坑/知识/密钥位置
  2. 新项目先建文件夹 — 写代码前先确认项目归属地（临时 demo 除外）
  3. 每个项目一份交接文档 — AI-项目了解.md：用户要求 → AI 方案 → 最终效果
  4. 需求笼统先确认再动手 — 一次问全，不挤牙膏；小事不反复确认
  5. 依赖不污染系统 — Windows 集中装 D 盘，macOS 走 ~/dev + venv/nvm；国内镜像源内置
  6. 密钥只记位置 — 内容永不复制进文档或聊天
  7. 资产双轨写入 — AI 主动沉淀有价值经验；你说"记住 XX"定向写入，写了会告诉你
  8. 收尾强制回写 — 项目文档 + 交接日志 + 资产库，一次收尾三处落地
  9. 防膨胀纪律 — 索引 ≤200 行、单文件 ≤300 行、过时条目删而不堆

为什么是"文件即记忆"

AI 记忆方案很多，但资产的前提是记在你自己名下——黑盒数据库里那叫数据，你盘里的 Markdown 才叫资产。

能力mem0 等数据库方案Project Butler
记忆存放向量库/图数据库，黑盒纯 Markdown 文件，肉眼可读
人工编辑要写代码或专用界面Obsidian / 任意编辑器直接改
部署负担Docker / Postgres / Neo4j零依赖，装个 md 文件就行
费用嵌入模型常调云 API¥0；可选配本地语义检索
跨 AI 工具绑定单一框架任何能读文件的 Agent 都能用
数据主权库格式私有，迁移难你的盘、你的文件、随时带走
💡
进阶玩法：资产库本身是标准 Markdown + wikilink，想要语义检索时，装一个 basic-memory MCP（本地免费）即可让 AI 对全库做中文语义搜索——不影响本 skill 的工作流。

安装

三种方式任选：丢给 Agent 最省事；一键命令最快；手动复制最透明。

把下面这段话完整复制，粘贴给任意编码 Agent（Claude Code / Codex / ZCode / Cline 的新会话），它会自动完成下载、安装和初始化：

请帮我安装 Project Butler 技能（个人 AI 资产管家）：

1. 从 https://butler.aijunjz.com/SKILL.md 下载技能文件（curl 或 Invoke-WebRequest 均可）
2. 保存为你用户级技能目录下的 project-butler/SKILL.md：
   - Claude Code：~/.claude/skills/project-butler/SKILL.md（Windows 是 %USERPROFILE%\.claude\skills\project-butler\SKILL.md）
   - 其他 Agent：用你自己的用户级技能目录，保持 project-butler/SKILL.md 相对结构
3. 保存后完整读一遍这个文件
4. 按文件第 8 节"首次启用"流程执行：向我确认库根路径、软件安装根、是否启用分区纪律这三个参数，然后帮我创建资产库骨架
5. 最后告诉我：装到了哪、资产库建在哪、下次会话怎么让它生效

Windows 和 macOS 都适用——提示词里已包含两个平台的路径规则，Agent 会自己判断。

macOS / Linux（bash）：装到 Claude Code 技能目录

mkdir -p ~/.claude/skills/project-butler && curl -fsSL https://butler.aijunjz.com/SKILL.md -o ~/.claude/skills/project-butler/SKILL.md && echo "✅ 已安装到 ~/.claude/skills/project-butler/SKILL.md"

Windows（PowerShell）：

New-Item -ItemType Directory -Force "$HOME\.claude\skills\project-butler" | Out-Null; Invoke-WebRequest "https://butler.aijunjz.com/SKILL.md" -OutFile "$HOME\.claude\skills\project-butler\SKILL.md"; Write-Host "OK 已安装到 $HOME\.claude\skills\project-butler\SKILL.md"

用其他 Agent？把命令里的 ~/.claude/skills 换成对应技能目录即可（见下方路径表）。

直接查看 / 下载原文，自己放到技能目录：

浏览器打开 SKILL.md 下载文件

目标位置：技能目录/project-butler/SKILL.md。保存后让任意 Agent 读一遍并执行其第 8 节初始化。

Agent / 工具用户级技能目录
Claude Code~/.claude/skills/　(Windows: %USERPROFILE%\.claude\skills\)
ZCode~/.agents/skills/ 或用户级 skills 配置目录
Codex CLI~/.codex/skills/（或按 AGENTS.md 引用）
Cline / Roo Code项目内 .clinerules/ 或全局规则文件引用
其他 Agent任何会自动加载的指令文件（AGENTS.md / 系统提示词）include 即可

装完后：资产库初始化

首次启用，Agent 会问你三个问题，然后自动建好整套骨架。

① 库根路径

所有资产和项目的家。建议直接用 Obsidian 仓库：Windows 例 D:\SecondBrain，macOS 例 ~/SecondBrain。

② 软件安装根

运行时/依赖集中地。Windows 例 D:\dev，macOS 例 ~/dev（Homebrew 除外）。

📂
建好的结构：_AI资产库/（索引 + 习惯 + 踩坑 + 领域知识 + 密钥位置）、_AI管家主记录.md、_归档/交接日志/——用 Obsidian「打开文件夹作为仓库」即可获得可互链的知识库。

FAQ

必须用 Obsidian 吗？
不必须。资产库是纯 Markdown，VS Code、Typora 甚至记事本都能编辑。Obsidian 的价值是 wikilink 图谱和全文搜索，推荐但不强制。
和 mem0 这类记忆库冲突吗？
不冲突，定位不同：它们管"机器自动记忆"，本 skill 管"人机共同维护的资产"。你甚至可以两者同时用。
多台电脑怎么同步？
库根放进 iCloud / OneDrive / 坚果云 / git 仓库均可——它就是普通文件夹。
我的密钥会被传到网上吗？
不会。skill 只在你的本机生效，规则本身强制"密钥只记位置不记内容"，资产库也没有任何上传逻辑。
已经是重度 AI 用户，还有用吗？
最有用的恰恰是收尾回写和防膨胀两条纪律——多数人的 CLAUDE.md 死于只写不整理。