THE ORANGE BOOK · N° 01 · COMPLETE EDITION
How to
sharpen
your agent.
Claude Code 打磨手册 · 完整版
一个大学生的 agent 协作实践与沉淀 ——
mindset · memory · skill · handoff · flywheel.
← HOME
PART I · 上篇
The mindset
心法 · 技巧之上的认知框架
I
心法 · N° I

审美吞噬

Aesthetic Absorption

INSIGHT 来源于一位朋友展示的交互和审美都极为出色的网站。

AI 时代,你可以吞噬任何人的审美设计,化作你自己的审美。

看到那个网站的一瞬间,我脑子里冒出的念头就是:我能不能 1:1 复刻下来?于是我真的去试了——通过持续的多轮对话,最终做到了接近 90% 的还原度。

这件事给我的最大启发不是"AI 真厉害",而是:只要你想,你就能做到。过去你看到一个惊艳的设计只能收藏,现在你可以直接把它变成你自己的东西。审美品味本身就是一种 prompt engineering——你见过什么、理解什么、追求什么,决定了你能让 AI 产出什么。

你只需要敢想敢做。

Process · 过程记录
发现一个设计极为出色的网站,决定用 Claude Code 吞噬它的审美 通过多轮对话拆解设计系统:配色、字体、交互、动画逐一还原
Result · 审美输出 · 可交互
从"看到惊艳设计"到"吞噬为自己的审美"——整个过程通过 Claude Code 完成
II
心法 · N° II

外包思考,不能外包理解

Outsource Thinking, Not Understanding

INSIGHT 来源于 X 上一位博主的发言,再结合我这一个月的项目实践。

你可以让 AI 写代码、写网页、搞全栈,但你必须理解那些代码背后的含义。

你可以不用理解每一行代码具体在做什么,但你要理解这背后的逻辑是什么意思——否则就是在开黑盒。出了问题你不知道为什么,迭代的时候你不知道改哪里。

代码可以不学,但代码背后展示的逻辑,AI 替代不了你,你还是要学。这就是"外包思考"和"外包理解"的区别:思考是过程,可以交给工具;理解是结果,必须留在你自己脑子里。

@yacineMTB: you can outsource your thinking but you cannot outsource your understanding
灵感来源 · @yacineMTB on X · 235 万次浏览
III
心法 · N° III

做 AI 产品,最重要的是 Marketing

Marketing Over Everything

做 AI 产品,最重要的不是想法,也不是执行,而是 marketing。

你做出来的产品一定要有市场需求,否则不过就是你的自嗨。其实这种"自嗨"也是有好处的——在你刚开始接触 agent 的时候,你必须经历一个阶段:疯狂地把脑内的 idea 变现。这是必经之路,也是你和工具建立手感的过程。

但到后面,你会开始逐渐脱敏。这个时候你就要回归到市场——发掘需求,找到痛点,解决他人的痛点。从这个角度出发去做产品,去尝试让市场为你定价。

Marketing 流程图:从需求洞察到成交复购的完整闭环(找人群→找需求→锁定位→包装价值→建立信任→内容触达→引导成交→交付与复购)
Marketing 流程图 · 从需求洞察到成交复购的完整闭环
IV
心法 · N° IV

Agent 放大的是你,所以你更重要了

Agents Amplify You

AI agent 相比于 chatbot,更加放大了你的能力。所以作为人本身,也变得更加重要了。

你的思维和思考愈发重要。凭什么同样一个任务交给你和他,在同一份 AI 工具下,他比你做的更好?就是因为他拥有你没有的思维框架。一个顶尖运营操盘手和一个运营小白,思维差距不是一星半点。

我自己的体会是:AI 可以帮我快速做出一个 MBTI 留学活动策划的初版,但真正拉开差距的,是后续的项目调优和需求迭代。

很多改动我一开始根本想不到,因为我的脑子里还没有对应的概念和判断框架;而对方能提出这些优化,本质上是因为他脑子里已经有一套更成熟的项目思维。

所以,AI 能提高执行效率,但项目能不能做深、做准,最后还是取决于人的认知结构和思维密度。

所以你本人的能力提升也非常重要。如果让我分配精力,目前给到打磨 agent 和打磨你自己 5:5 开。

V
心法 · N° V

最高效的学习,永远来自亲身实践

Learn by Doing

INSIGHT 启发来源于蔡叔的《上行》里关于赚钱的认知。

别人的教学、想法、idea,你也就只是在脑内过了一下。只有亲身实践后,你才能对这个 idea 体感更深。

这里有一个非常具体的行动建议:如果你想要知识付费,但你并没有尝试过最顶尖的 Pro/Max 会员,我建议你去上一个。甚至我觉得,如果你现在有闲钱(不影响生活的钱),小额的投资,不如给自己开一个 Codex Pro 或者 Claude Max 会员,把模型思考开到 max,疯狂地创造一个月。

你有没有发现,最烦的其实是 5 小时限额?特别难受——当你构建一个东西上头的时候,突然来的限额会打断你的心流状态。而心流一旦断了,找回来的成本远比那点订阅费高得多。

以上 5 条想法,仅作分享,实操在否在于你自己。
如果说前一个月是使用 Claude Code 的行动守则,那么这 5 条想法就是指导我使用 Claude Code 的心法。
PART II · 下篇
The action
行动 · 具体怎么做
FIELD GUIDE N° 01 · MEMORY SYSTEM
2026 · 04 · 19

How to use your
memory

让 Claude 越用越懂你
memory 系统解决的是这件事——让 Claude 对你的理解可以跨对话累积,像一个真正越用越懂你的搭档。不用每次重新自我介绍,踩过的坑也不会再踩第二次。
为什么需要这套系统?

先讲痛点——如果你没遇到过下面这些,可能暂时不需要这套:

  • 每次新对话要重新自我介绍:Claude 不知道你是谁、用什么语言、喜欢什么风格
  • 上次踩过的坑还会再踩:调过的 bug、纠正过的做法、确认过的方案,下次开新对话全忘
  • 项目上下文跨对话丢失:每次开头都要"先读 HANDOFF.md",累积的经验没地方沉淀
  • Claude 的理解停留在这次会话:你花一小时解释的东西,下次会话全部重来
三个核心设计原则
PRINCIPLE · 01
单一主仓 + symlink
所有 cwd 下的 memory 目录都 symlink 到同一个主仓。换目录、换项目,记忆全局可用。
PRINCIPLE · 02
七类分层 + 准入门槛
不同类型的知识有不同的沉淀逻辑和淘汰规则,防止记忆无限膨胀。
PRINCIPLE · 03
外置 cc-personal 资产
规则、完整文档、归档都住在 ~/cc-personal/,不污染出厂目录,备份迁移都不影响。
七种记忆类型 · 对应人类直觉
类型人话理解
user我是谁(身份、技术栈、协作风格)
feedback我踩过什么坑(带"上次错了"叙事)
preference我喜欢怎么干(无错误叙事的纯偏好)
project我在做什么(活跃项目的上下文)
retro我做完了什么(项目完整复盘叙事)
reference我读过什么(外部知识的入口)
decision我为啥选 A 不选 B(架构权衡)
§ 1
一张图看清整套系统
Memory System Architecture Map v3.1
MEMORY SYSTEM MAP · v 3 · 1 · 从新对话启动到知识沉淀的完整路径
LINE · 01
黑色实线 = 自动加载(永久吃 token)
LINE · 02
灰色虚线 = 按需读取(Claude 判断后拉取)
LINE · 03
橙色虚线 = 写入 / 沉淀路径(含更新索引回环)
怎么自己装一套?

配套有一份可执行的安装手册 memory-system-setup-CONI.md

用法非常简单:

  1. 下载 memory-system-setup-CONI.md
  2. 打开 Claude Code,把这份文件发给它,说一句「按这份手册给我装 memory 系统」
  3. Claude 会按 12 步执行,每步之间停下来让你确认
  4. 全程约 5–10 分钟

手册里包含:宪法文件、MEMORY.md 索引、user-profile 骨架、CLAUDE.md 更新、cc-personal 目录、symlink 收敛脚本、健康检查脚本、budget 自动刷新脚本、settings.json hook 配置——全套复制可用。

hygiene 宪法 · 核心四条(必遵)
  1. 写新记忆前先 grep 现有文件,能更新旧的就不开新文件
  2. MEMORY.md 只放指针(一行 hook),不放内容
  3. 主仓只留"跨对话会用"的知识,外部参考归 ~/cc-personal/references/
  4. 永远不自动写入,用户确认后才沉淀
这四条是记忆系统不退化的关键。没这套宪法,再好的分类都会膨胀成垃圾堆。
和其他方案的对比
方案载体谁控制成本可迁移
本方案纯本地 md 文件你完全掌控0完全可迁移
mem0 / zep云端向量库依赖第三方订阅费绑定服务
Cursor / WindsurfIDE 自管IDE 决定内置不可移植

本地文件的优势:你能 catgrepgit diff,记忆系统对你透明,不是黑盒。

FAQ

Q: Claude 会不会偷偷乱写记忆?
不会。hygiene 宪法第 4 条 "suggest, never auto-save"——Claude 每次只会建议"要不要沉淀这条",你确认后才写文件。

Q: 换电脑怎么迁移?
备份两个目录就行:~/.claude/projects/<家目录转义名>/memory/~/cc-personal/。重装 Claude Code 不影响。

FIELD GUIDE N° 02 · SKILL SYSTEM
2026 · 04 · 19

The art of
skill crafting

沉淀工作流与工具
skill 不是 AI 的额外功能,是你把重复动作固化成可复用单元的手段。三条思路对应三种 skill 来源,一条反常识设计原则让你知道什么时候停手。
§ 2.1
skill 的创建 · 三种思路
PATH · 01
GitHub 现成项目打包
看到好用的 GitHub 工具(如抓视频的 yt-dlp),直接把项目地址给 agent,让它帮你打包成 skill。以后调用就能直接出结果,不用每次重配环境。
PATH · 02
工作流内化
跑完一轮完整工作流后,如果还会重复用,把它内化成 skill——以后调用自动走完所有步骤,省时间也省 token。
PATH · 03
skill-creator 从零
任何想法冒出来的时候,打开 skill-creator,跟它对话就能生成新 skill——从 capture intent 到 iterate 全流程托管。
§ 2.2
skill 的下载 · 两个安全守则
SAFETY · 01
先审计再下载
下载任何 skill 前,先让你的 agent 审计一下它的安全性——读源码、查权限、看有没有可疑调用。防人之心不可无。
SAFETY · 02
保持精简
非必要任务不要下载过多 skill。"麻雀虽小,五脏俱全"——每个 skill 的 description 都会占用 token 预算,留着不用的 skill 是在稀释 Claude 的判断力。
FIELD GUIDE N° 03 · CONSOLIDATION
2026 · 04 · 19

The flywheel of
越用越强

沉淀迭代系统
让 AI 在陪你工作的过程中持续学习你的审美、偏好、踩坑历史,而不是每次都从零开始。沉淀不是事后补作业,是工作流的一部分。
§ 3.1
素材沉淀 · 让 AI 更懂你的参考
YOU SAY
"这个设计我想沉淀,以后可以参考。风格是编辑杂志感。"
cc 提取配色 / 版式 / 字体 / 交互细节,判断风格类型,写一个独立 reference 文件,含来源 URL + 适用场景。
→ memory/design-ref-<风格>.md
YOU SAY
"这篇文章你读读,值得吸收的写进 principles / rules,其他一行索引防重复。"
cc 扫取 → 按 1–10 分评分 → ≥7 分提取归纳点 → 追加到 principles 或 rules → review-log 加一行索引。
→ cc-personal/references/ + article-review-log.md
§ 3.2
项目完结沉淀 · 三种触发场景
先讲时机问题:沉淀不一定要等"项目完结"。踩坑当场、meta 审视当场就该沉淀——冷了就忘细节,两周后只剩"好像之前遇到过什么问题"的模糊感。下面三种是典型的"项目级"完结场景。
SCENARIO · 01
一直搞不定,最后才搞定
一件事一直搞不定,最后才搞定——让 agent 深度复盘,把失败路径、关键突破点总结成 feedback 存进 memory。
→ memory/feedback-<主题>.md
SCENARIO · 02
比上次更顺利
同类项目比上次更顺,说明有值得固化的改进——把这次做法迭代进化,写成 skill 或 feedback。
→ skills/ 或 memory/feedback-*
SCENARIO · 03
项目彻底结束
三层沉淀同步推进:行为规则 → CLAUDE.md;用户理解 → user-profile / feedback;完整叙事 → retro-<项目>-<日期>.md
→ CLAUDE.md + memory/retro-*.md
§ 3.3
协作体验优化 · 7 条实用建议
TACTIC · 01
项目完毕主动复盘
每次项目结束跟 agent 复盘大小问题,可汲取的部分吸收到 memory——你会越用越强。
TACTIC · 02
handoff 先写,harness 后谈
建好项目文件夹,第一件事让 agent 写 HANDOFF.md。连开十几个对话都不会丢上下文。
TACTIC · 03
重复工作流转成 skill
同一流程走 2-3 次还在手动推进,就该做成 skill——省时间也省 token。
TACTIC · 04
耐心等待 agent 思考
2-3 分钟没回复正常,可能在思考。超过 5 分钟再追问。非必要不打断。
TACTIC · 05
聊天记录本地可恢复
被打断、找不到聊天框——新开对话框让 agent 读取本地聊天 json 就行。(费 token 但保命)
TACTIC · 06
cc 里用 codex 装插件
同时用 cc 和 codex 但更喜欢 cc 界面——在 cc 里装 codex 插件,协同执行任务。
TACTIC · 07 · GENERATOR-EVALUATOR

让同一个 agent 做两次:第一次当评审(挑毛病、打分、列优先级),第二次当执行(按评审结果改)。

比直接说"帮我把 X 改好"质量好一个数量级——agent 第一步建立"哪里有问题"的心智模型,第二步带着这个模型针对性改。

Round 1 → 「评价一下这份 X,指出最该改的 3 个点,按优先级排」
Round 2 → 「按你刚列的 3 个点改一下」

对付费手册、公众号文章、skill 文档、代码重构都管用。

§ 3.4
一个教训 · projects 目录要规范

每次对话都随意打开文件夹,整个 projects/ 目录会越来越乱。办事前先想好在哪个文件夹工作,别图省事用默认目录。

还有一点——中文文件夹名会被 Claude Code 识别成一串连字符(比如 MBTI测评应用----),定位完全没法看。

如果你希望 projects/ 一眼就能看清,养成给项目目录用英文 / 拼音命名的习惯——比如 mbti-app 而不是 MBTI测评应用
FIELD GUIDE N° 04 · PROJECT SYSTEM
2026 · 04 · 19

Two pillars of
project work

项目工作系统 · handoff + harness
项目工作系统是让你和 agent 在项目级别配合的基础设施——一旦跑通,你能同时开十几个对话框并行推进不同模块而不失控。只需要两根支柱。
§ 4.1
handoff 工作文档 · 项目连续性的第一保障

每次启动新项目,第一件事就是让 agent 写一份 HANDOFF.md——记录当前进度、关键决策、待办事项、已知坑点。

它的作用不是做给人看的,而是做给未来的 agent 看的:

  • 对话上下文被压缩时,它是唯一能跨 session 延续的记忆
  • 开新对话框时,让 agent 先读 HANDOFF 再动手,3 秒进入状态
  • 项目中途换设备、暂停几天回来接手,看 HANDOFF 就能继续
§ 4.2
Harness · 约束先行,防止 agent 跑偏

Harness 字面意思是"马具"——项目开始前先给 agent 套上"该做什么 / 不该做什么"的约束框架,它就不会在工作中跑偏。

我自己的 harness 一般包括三部分:

HARNESS · 01
项目级 CLAUDE.md
写清楚项目目标、技术栈、交付形态。每次 agent 都会读到,约束每一步决策。
HARNESS · 02
NEVER 列表
明确写"绝对不要做 X / 不要碰 Y"。比 positive 指令更有约束力——NEVER 不能被"创意性解读"。
HARNESS · 03
目录结构约定
新文件该放哪、怎么命名。没有这条,agent 会把文件四处散落。

为什么必须先做 harness:没有规矩的工作空间,agent 会用自己的惯性填空;等它按自己的方式铺开了你再纠正就晚了,每次对话都在重新教。规则要写在前面,不是纠偏的时候才补。

TWO PILLARS · CONFIGURED

handoff + harness 是项目工作系统的两根支柱:

handoff 管纵向连续性——跨 session、换设备、中途暂停回来都能接上

harness 管横向约束性——同时开十几个对话推进不同模块也不会各自跑偏

两件配齐,你就能同时推进多个复杂项目而不失控。

FIELD GUIDE N° 05 · FIELD TIPS
2026 · 04 · 19

Three
field tips

几条独立的实用 tips
前面各章节讲完了系统性的方法论,这里收录几条独立的实用 tips——和前面不重复,单独看每一条都能立刻用上。
TIP · 01
agent 帮你查论文改格式
如果你还在写论文,让 agent 直接去找文献、改格式、核对引用——节省大量机械劳动。
TIP · 02
截图画图优先命令行
让 cc 截图/画图时,优先用命令行工具(chrome --headlessplaywright 等),别走 MCP 截图——MCP 把图像 base64 塞进上下文,吃 token 严重(约 3–5K tk/张 vs CLI 的 ~50 tk,差距约 50 倍)。
TIP · 03
飞书用户装 lark-cli
用飞书办公的话,装 lark-cli 能让 agent 直接读写你的飞书文档、表格、日历、消息——写进飞书云文档、发消息汇报进度都可以。agent 延伸到日常协作平台,不再是孤立在终端里的工具。

Mnemonic · 速记口诀

写规矩 · 看 CLAUDE.md
装工具 · 看 settings.json
教技能 · 进 skills/
找记忆 · 翻 projects/.../memory/
做项目 · 先 HANDOFF.md 再谈 harness
其余都是 Claude 的家务,不必操心。
FIELD GUIDE N° 06 · SKILL SHARE
2026 · 05 · 17

Two skills
I built

两个我自己做的 Skill,分享给你
前面讲了 Skill 系统的原理和用法,这里直接分享两个我自己写的 Skill——一个把直播逐字稿变成沉浸式网页,一个是它的升级版,把任何内容都能转化为可视化网页。装上就能用。
安装方式

所有 Skill 都开源在 GitHub:

https://github.com/coni555/CONI-skill

安装只需要一句话——发送给你的任意 agent:

帮我安装这个 skill,skill 地址:
https://github.com/coni555/CONI-skill/tree/main/transcript-to-immersive-page
https://github.com/coni555/CONI-skill/tree/main/content-to-html
Skill ① 直播逐字稿 → 沉浸式网页

transcript-to-immersive-page

把一份直播或演讲的逐字稿,转化成一个有设计感的沉浸式长页面——侧边导航、章节切换、阅读进度,像一本在线书。

适合场景:直播复盘、演讲存档、播客笔记转可视化。

Skill ① 实例 · 直播逐字稿 → 沉浸式可交互网页
Skill ② 任何内容 → 可视化网页

content-to-html(基于 Skill ① 的升级版)

不限于逐字稿——任何内容(文章、笔记、教程、产品文档)都能转化为结构清晰、视觉精良的可视化网页。输入可以是文本、Markdown、甚至一个 URL。

适合场景:知识沉淀、内容产品化、个人作品集。

Skill ② 实例 · 任何内容 → 结构化可视化网页
因为这里采用的是方块式嵌入展示,实际阅读体验可能没有那么流畅,所以这部分主要是用来做效果展示。

如果你真的想感受这两个 Skill 的价值,建议一定要自己上手实践一下。只有亲自把内容丢进去生成、对比、微调,你才能真正看出它们在可视化呈现和内容吸收上的差别。

这两个 Skill 建议搭配使用。第一个 Skill 也可以把其他内容转化成可视化网页。因为有时候可能这个 skill 生成效果好,可能是那个 skill 生成效果好。

最重要的是,生成结果不需要一次到位。如果你觉得哪里不满意,可以直接继续和 AI 对话,让它帮你调整版式、风格、颜色、结构和细节,一步步改到你满意为止。

推荐搭配

如果你还没装 Anthropic 官方的 frontend-design skill,建议一起装上——它能让 Claude Code 在前端设计方面的输出质量明显提升:

https://github.com/anthropics/skills/tree/main/skills/frontend-design
A LETTER · 后记
Thank
you.

读到这里,说明你真的把这份手册翻完了 —— 一个写下它的大学生,先向你鞠一躬。

这本橙皮书里的每一条,都是我和 Claude 一起踩坑踩出来的。不是"AI 使用秘籍",只是一个大学生的工作法——你挑能用的拿去。

如果它让你少走了一小时弯路,那下次我再写一本,也就值了。

— CONI · 2026 · 05 · 17
© CONI · 2026
— END OF ORANGE BOOK · COMPLETE EDITION —
v 2.0