工作手册

工作手册是一份纯文本，用来告诉助手你的偏好、规矩和项目背景。界面里的文件名是 AGENTS.md。助手每次开始工作时都会读入，不必在每条消息里重复交代。

功能目录

全局工作手册适合放各项目通用的习惯，例如用哪种语言回复、注释怎么写。

项目工作手册只作用于当前工作区，适合放这个项目的背景、目录和命名约定。

两份都有时，都会读入：先全局，后项目。缺文件或只有空白，这一级不会注入。

你每发出一条需要助手处理的消息，它都会重新读这两份文件。对话中途改了手册，下一轮就会按新内容来。不必为此新开对话。

只读工作区根目录的项目手册。子文件夹里的同名文件不会注入。

打开或新建：

有文件后会出现在文件树里，用 Markdown 编辑器打开即可改。文件树右键的「新建文件」里没有这一项。

不要了：同一图标里选「删除项目工作手册」。删除不可撤销。

助手可以直接改项目工作手册。你也可以自己打开来写。

全局手册在工作区外面。选定一个文件夹后，文件保存在其中的 CoDoWork 子目录。选择对话框会建议使用家目录。

文件列表左下角的工作手册图标：「查看全局工作手册目录」已设置时打开 CoDoWork 文件夹；还没设置时会先请你选文件夹（默认家目录，通常直接确认）。「重设」会打开选目录面板：没设置时默认家目录，已设置时停在当前目录，直接确认不会换掉。
「设置 → 偏好设置」里有「全局资源目录」，标题是「全局工作手册和 Skills 资源目录」，可「查看」「设置」或「重新设置」。规则与文件树相同：查看已设置时打开 CoDoWork 文件夹，不会打开应用内回退目录。这个目录同时存放自定义 Skills。

已设置全局目录后，对话里说「以后都要……」时，助手可以直接写入全局手册。改完后发下一条消息就会生效。

还没设置全局目录时，没有全局手册可注入。自定义 Skills 在未指定全局目录前，会先用应用内的回退文件夹；这和全局 AGENTS.md 不是同一件事。要指定全局目录，用左侧栏 AGENTS 菜单，或「设置 → 偏好设置 → 全局资源目录」。

一条一条写清楚「总是怎样」「不要怎样」「这个项目用什么」。用标题把相关规则归在一起。

适合写：回复语言、文风、注释习惯、文件放哪、项目技术背景、动手前要不要先确认。

不适合写：一套多步骤的操作流程——那种请做成自定义 Skill。只对这一次有效的吩咐，直接在对话里说即可。

手册越长，越占对话空间。重要的规则放前面。