Experience Ledger — AI skill for Claude Code

experience-ledger · 经验账本

An experience ledger that runs inside your AI agent — journals your work daily, turning chats and projects into traceable records of what happened, why you thought so, and what changed. AI helps you remember your own path instead of pushing you forward. **A mirror that doesn't flatter you.**

一个 Agent Skill。装上之后，它会扫描你的工作空间与对话记录，帮你生成一本可回溯的**经验账本**：分项目时间轴、能力卡片、工时账、可视化 HTML 账本。


▲ 这是账本的真实渲染截图（手绘皮肤），内容为示例数据。展开项目卡即可看到「事实 → 思路 → 变化」三层时间轴。

它解决什么问题

AI 让任务推进变快，人容易把「AI 产出很多」误当成「我成长了很多」。会话结束即蒸发，决策链路沉在聊天记录里。经验账本是一面**不讨好自己的镜子**——它记录的不只是「做了什么」，更是「当时为什么这么想、后来为什么变」。

**账本分三层，缺一层就退化成流水日记：**

层	内容	作用
记忆层	分项目时间轴（事实 / 思路 / 变化）	回忆动作，检索决策链路
提炼层	能力卡片、思路主线、承诺-变化-原因-调整	把经历变成可复用规则
交付层（可选）	SOW、工时账、报价校准	让经验能对外定价

五套皮肤


▲ 五套皮肤同一份内容。内容结构与皮肤彻底分离——换肤只替换 CSS 变量，账本结构与数据一字不动。

皮肤	适用场景
手绘 handdrawn（默认）	暖米色纸面、手绘边框、蜡笔点时间轴。适合个人长期使用与视频号展示
极简 minimal	白底细线、系统字体。适合打印与职场阅读
商务 business	深蓝主色、栅格感。适合对外汇报与客户演示
多巴胺 dopamine	彩虹条 + 圆角胶囊。年轻态，适合传播
科技 tech	深色底等宽字体。开发者审美

安装

**方式一：直接告诉你的 agent**

帮我装一下 experience-ledger 这个 skill

**方式二：手动**

把整个文件夹放进 agent 的skills 目录：

• WorkBuddy / Claude Code：~/.claude/skills/experience-ledger/（WorkBuddy 亦可用其内置 skill 搜索安装） -项目级：<项目>/.claude/skills/experience-ledger/

**方式三：命令行（支持 Agent Skills 标准的 agent 通用）**

npx skills add <你的GitHub 账号>/experience-ledger

首次使用

装上后对 agent 说「建个经验账本」，它会走一次约5 分钟的**安装向导**：

1. 问你账本叫什么、怎么称呼你
2. 问你事情分成哪几类（类目归你，agent 无权增删改）
3. 问你扫描哪些路径（隐私边界，只读你允许的目录）
4. 问你出账频率与时间（agent 有定时能力时会建成自动化任务）
5. 让你选账本皮肤（六选一）
6. 问你是否需要交付层（SOW / 能力卡片 / 工时账）

向导结束后会做**冷启动回填**：扫描历史文件与对话，把账本先填满再交给你——这样你第一天打开就有内容看，而不是一个空壳。

账本结构（九个板块，固定顺序）

模板取自真实使用中的账本（而非通用骨架），类名与结构一一对应，**出账只改数据，不改板块、不改类名、不改顺序**：

#	板块	内容要点
1	头部 + 统计条	四个数字：登记项目／待补录／待你拍板／风险预警
2	周记录卡	每周一张，当周置于最上方且展开，历史收起；每日出账往当周卡追加