先用 Markdown 想清楚,再出 HTML
Agent 的基本功是项目文件夹、Markdown 文档和交接文件;讨论用 Markdown,要看效果时才生成 HTML。
读书笔记原文:《了解 AI Agent 的常用操作》↗Oil 欧呦 · Oil Book
为什么读
这是一篇讲 Agent 日常操作的入门课,覆盖了权限、上下文、交接这些每天都会碰到、但很少有人系统讲的小事。刚开始用 Claude Code 的人,读一遍能少走不少弯路。
我记下的要点
- 一个任务一个空文件夹。 项目就是本地文件夹,规范、架构、流程都存成文件,新对话也能接着干。不要拿桌面当项目目录,Agent 容易改到无关文件。
- Markdown 给人和 AI 交流,HTML 给眼睛看。 Word 是打包格式,Agent 读之前要转换,既丢格式又费上下文。HTML 的 token 大约是同等 Markdown 的 2–4 倍,标签错一个整页可能出不来。所以先用 Markdown 讨论,要看视觉效果再出 HTML。
- 开工前调三个设置: 权限给完全访问,推理强度调到 High 或 Max,运行时防止电脑休眠。作者的理由是,频繁停下来要批准会打断 Agent 的节奏。
- 先让 AI 反问你。 复杂功能用 Plan 模式,并让它在动手前先提问,问清楚再做。小改动用默认模式就行。
- 上下文满了要交接。 大约 90% 会自动压缩,细节可能丢。三种交接方式里,最通用的是让 Agent 写一份
handoff.md,记下做完了什么、改了哪些文件、下一步是什么,再开新对话读它。 - 生成透明图用绿幕法。 很多模型出不了透明 PNG,可以让它生成纯绿背景,再写脚本抠掉。
我的想法
「先 Markdown 后 HTML」这条,和我今天建站的顺序几乎一样:先写 site-plan.md,再让 AI 出三版风格稿,选定后写 DESIGN.md,最后才动手做页面。当时只是觉得顺手,现在知道背后还有 token 成本和容错的考虑。
权限给到完全访问这一点我有点犹豫。作者说 Agent 遇到删重要文件这类操作还是会停下来问,但我更想先配合 Git 存好检查点,再放手。文章也提到很多 Agent 没有撤销功能,要靠 Git 回退。
/btw 问旁支问题、不进主对话历史,这个小功能我之前没注意过。
我打算试试
- 下次长任务做到一半,让 Claude 写一份 handoff.md,再开新对话接着做,对比效果
- 试一次绿幕抠图,给网站做一张透明背景的小图