上下文文件与 Skills

全局上下文文件

Crush 自动包含两个用于跨项目指令的文件，相当于对系统提示的个人补充：~/.config/crush/CRUSH.md（Crush 专属规则，那些会让其他智能体工具困惑的内容；只用 Crush 就只需编辑这个）和 ~/.config/AGENTS.md（通用指令，其他编码工具也会读；避免提及 Crush 特有的功能。多个工具共用指令时才需要）。用 option global-context-path 自定义路径（可重复添加；指向文件加载单个 Markdown，指向文件夹则递归加载其中所有 Markdown）。

初始化项目

初始化项目时，Crush 分析代码库并创建一个上下文文件，帮助之后的会话更有效；默认命名 AGENTS.md，可用 option initialize-as 改名或换位置（如 CRUSH.md、docs/LLMs.md），内容是它发现的构建命令、代码模式和约定。

Agent Skills

Crush 支持 Agent Skills 开放标准：技能是包含 SKILL.md 的文件夹，Crush 按需发现并激活。全局查找路径：$CRUSH_SKILLS_DIR、~/.config/agents/skills/、~/.config/crush/skills/、~/.agents/skills/、~/.claude/skills/（Windows 另有 %LOCALAPPDATA% 下的 agents 与 crush skills 目录），以及 options.skills_paths 配置的额外路径。项目内相对路径：.agents/skills、.crush/skills、.claude/skills、.cursor/skills。也可以用 option skill-path "$HOME/squid-skills" "./other-skills" 指定。可以从 anthropics/skills 取示例技能。

用户可调用技能：在技能的 YAML frontmatter 加 user-invocable: true，它会出现在命令面板（ctrl+p）里，全局目录的显示为 user:技能名，项目目录的为 project:技能名；调用时技能指令被载入会话上下文。再加 disable-model-invocation: true 可以阻止模型自动触发，只允许用户手动调用（这类技能不出现在模型的可用技能列表里）。要完全禁用某技能（包括内置和磁盘发现的）：option disable-skill crush-config。Crush 自带用于配置自身的内置技能，通常直接告诉它想配置什么即可。