用途:本技能面向 Cursor/VSCode 用户设置文件的修改,适用于更改编辑器设置、偏好、配置、主题、键位或任意 settings.json 中的值。
主要能力:读取现有 settings.json,理解当前配置;在保留其他已有设置的前提下,添加或修改用户请求的项;写入前注意 JSON 语法;支持带注释的 JSON(// 与 /* */);处理后提示是否需要重载窗口或重启。文档还给出常见请求与设置的对应关系,如字号(editor.fontSize)、制表符宽度(editor.tabSize)、保存时格式化(editor.formatOnSave)、自动换行(editor.wordWrap)、主题(workbench.colorTheme)、小地图(editor.minimap.enabled)、自动保存(files.autoSave)、行号(editor.lineNumbers)、括号着色(editor.bracketPairColorization.enabled)、光标样式(editor.cursorStyle)、平滑滚动(editor.smoothScrolling)等。
使用方式:设置文件位置为 macOS 的 ~/Library/Application Support/Cursor/User/settings.json,Linux 的 ~/.config/Cursor/User/settings.json,Windows 的 %APPDATA%\Cursor\User\settings.json。流程为:先读取现有设置文件;识别要修改的设置项;解析现有 JSON(注意注释);添加或更新目标设置;保留其他所有设置;以 2 空格缩进写回;告知用户修改结果及是否需要重载。文档给出修改字号、开启保存时格式化、切换主题的示例。
适用场景:调整编辑器外观与行为、配置常用编码偏好、按用户自然语言请求映射到具体设置项。
限制与注意事项:本技能覆盖用户设置(全局生效),工作区设置(.vscode/settings.json)仅作用于当前项目;写入时应尽量保留注释;重大修改可提醒用户通过编辑器撤销或回退。关于提交归属:CLI 代理需修改 ~/.cursor/cli-config.json,IDE 代理则在 Cursor Settings > Agent > Attribution 界面控制,不在 settings.json 中。