上下文控制

用提示文件、持久指令与提示词模板，把项目约定、个人偏好与输出规范沉淀成可复用的上下文。

为什么要控制上下文

模型只能「看见」当前上下文里的内容。把稳定的信息（项目约定、代码规范、输出格式）沉淀成自动生效的指令，比每次对话重新解释更可靠——这就是上下文控制：不改变模型，改变模型每次看到的东西。

提示文件：项目级约定

在项目根目录创建提示文件（规范名 .cyhints，兼容旧名 .goosehints 与 AGENTS.md），写下这个项目的约定：技术栈、目录结构、代码风格、禁用事项。每次在该项目中开启会话，这些内容会自动注入——无需重复说明。

全局层面也有同样的机制：在设置的配置目录里放一份提示文件，对你的所有项目生效（例如「回复使用中文」「代码注释用中文」）。

持久指令：个人偏好

除提示文件外，你还可以在设置中维护对 Agent 的持久指令——跨会话生效的个人偏好（回复风格、详略程度、常用工具约定）。改动即保存，下一次会话生效。

提示词模板

「设置 → 提示词」里可以查看各场景使用的系统提示词模板（带中文对照），了解 Agent 在不同任务下的行为约定；进阶用户也可以在本地覆盖模板做深度定制（覆盖属于高级操作，更新产品后请自行核对）。

与技能的分工

• 提示文件 / 持久指令：告诉 Agent「这里的规矩」——被动、自动生效；
• 技能：告诉 Agent「这类事怎么做」——按需调用的领域知识（见技能）；
• 工作流：把多步操作固化成一键任务（见工作流）。

三者组合使用：项目约定交给提示文件，领域知识交给技能，重复操作交给工作流。

本页基于上游开源文档（Apache-2.0）改写，已修改；来源与变更见 /legal/provenance。