使用技巧

让 Agent 更稳更快的实用习惯——从自然语言下指令到管理扩展、保护敏感文件与保持更新。

像同事一样下指令

不需要特殊语法或关键词，用日常语言描述任务即可：「帮我把 src 下所有组件改成函数式」「查一下这个报错的原因」。描述越具体（目标、涉及文件、期望结果），结果越准。

控制会话长度

模型的上下文窗口有限，超长对话会稀释注意力。一个任务一个会话；任务完成就开新会话；长对话遇到压缩提示时果断压缩（见会话管理）。

只开需要的扩展

开启过多扩展会增加模型的工具选择负担、挤占上下文。在「设置 → 扩展」中只保留当前任务需要的扩展——工具越少，选择越准（见扩展（MCP））。

把偏好沉淀下来

• 项目约定写进提示文件（.cyhints），个人偏好写进设置的持久指令——每次会话自动生效（见上下文控制）；
• 领域知识写成技能，需要时按需调用（见技能）。

保护敏感文件

对不想被改动的文件与目录，善用权限三态（允许 / 询问 / 拒绝）：涉及敏感操作时 Agent 会先请求授权，你也可以在权限设置中收紧默认行为（见权限与安全）。

勤提交，常回滚

让 Agent 改代码前先提交一次——出现意外改动时可以随时回滚。配合顶部的差异提示查看本轮改动（见会话管理）。

复杂任务先规划

面对多步骤大任务，先让 Agent 给出计划（拆解步骤、列出影响面），确认后再执行——比直接开跑返工更少。

让工作流可重复执行

把常用流程固化成工作流时，让脚本先检查当前状态再行动（幂等），避免重复执行产生副作用；每个关键步骤加日志，出问题好定位（见工作流）。

保持更新

应用内自动更新经签名校验，及时更新可以获得最新修复与改进（见安装与更新）。

大胆试错

提示词与工具组合很少一次到位——迭代是正常工作流的一部分。不满意就补充约束再跑一次。

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