smart-zed-config

中文 · English

一个给 Claude Code / Codex 等 agent 使用的 skill —— 用自然语言修改 Zed 编辑器配置。不用再翻文档查字段名、手写 JSON，说一句话就行。

/zed-config 帮我打开自动保存
/zed-config -g 帮我开启保存时自动格式化
/zed-config 把 Claude Agent 新线程绑定到 ctrl+shift+c
/zed-config 给当前项目新增一个 Python 调试配置
/zed-config 推荐一些好用的全局设置
/zed-config 看看这个项目需要什么配置

---

1. 能做什么

/zed-config 把自然语言需求正确路由到对应的 Zed 配置文件，并做最小修改——保留你原有的 JSONC 注释和其他字段。

你说的	落到哪	举例
"自动保存"、"字号"、"主题"、"LSP"	settings.json	打开自动保存 → "autosave": "on_focus_change"
"调 Python 当前文件"、"launch"、"attach"	debug.json	追加一条 Debugpy launch 配置
"绑定 / 解绑 / 修改快捷键"	keymap.json	插入 "ctrl-shift-c": "agent::NewThread"
"运行 / 构建 / 测试 命令"	tasks.json	追加一条 cargo build 任务

核心特性：

• 两种作用域：全局（用户级，如 ~/.config/zed/settings.json）或项目级（.zed/settings.json 等）。-g 跳过询问直接按全局处理；未指定 -g 且该配置同时支持两种作用域时，agent 必须先弹出聊天式二选一提示。
• 白名单优先，联网兜底：本地索引了 194 个 settings 字段、518 个 keymap action、4 个 DAP adapter、7 个任务模板。只有当需求不明确时才会查 Zed 官方文档。
• JSONC 安全修改：字符串级最小替换，不全量回写。注释、末尾逗号、原有格式都会保留。
• 两档推荐：
  • 全局推荐——面向新手开箱：自动保存、保存时格式化、相对行号等低风险项，列出来等你确认才写。
  • 项目推荐——扫 package.json / tsconfig.json / pyproject.toml / Cargo.toml / go.mod 识别栈，匹配规则后建议写入 .zed/。
• 零运行时依赖：Claude 用 Read / Edit / Grep / Glob / WebFetch 就够了。不需要装 Python、Node、jq。

---

2. 安装

第 1 步：把仓库放到本地

任选一种：

git clone https://github.com/Zyl0812/smart-zed-config-skill

或直接下载 ZIP 解压。

第 2 步：放进宿主的 skills 目录

常见位置：

• Codex：~/.codex/skills/zed-config
• Claude Code：~/.claude/skills/zed-config

也就是说，最终目录结构应当像这样：

~/.codex/skills/zed-config/
  SKILL.md
  references/

或：

~/.claude/skills/zed-config/
  SKILL.md
  references/

第 3 步：重载 agent

• 有“重载 skills / reload”能力的宿主，执行一次重载
• 没有的话，直接重启客户端

第 4 步：验证是否生效

装好后直接试一句：

用 zed-config 这个 skill 帮我打开自动保存

如果你的宿主支持把 skill 名当成伪命令，也可以试：

/zed-config 帮我打开自动保存

注意：

• 本仓库不需要额外安装 Python、Node、jq
• /zed-config 这种斜杠写法是否可直接识别，取决于宿主；不是所有 agent 客户端都会把它当成真正的 slash command
• 即使宿主不支持 slash command，只要能匹配 SKILL.md 里的描述，自然语言调用也可以工作

---

3. 使用示例

装完之后，以下方式都能触发：

# 自然语言（匹配 SKILL.md 的 description）
> 帮我把 Zed 的自动保存打开

# 伪命令风格（文档写法）
> /zed-config 打开自动保存

# 显式调用
> 用 zed-config 这个 skill 把 ctrl+shift+c 绑定到新建 Agent 线程

示例一：改单个字段

> /zed-config 帮我打开自动保存

请选择修改位置：
  1. 全局配置
  2. 当前项目

请只回复 1 或 2。

> 1

✓ 已修改 ~/.config/zed/settings.json
  - autosave: "off" → "on_focus_change"
无需重启。

示例二：项目级智能推荐

> /zed-config 看看这个项目需要什么配置

检测到：TypeScript + Tailwind CSS + Prettier

建议写入 .zed/settings.json：
  • TS/TSX/JS 的 formatter 指向 prettier，保存时格式化
  • HTML/TSX 的 language_servers 追加 tailwindcss-language-server

是否全部应用？[y/n]

示例三：新手全局推荐包

> /zed-config -g 推荐一些好用的全局设置

为您推荐 7 个低风险配置：
  • 失去焦点时自动保存
  • 保存时自动格式化
  • 相对行号
  • 开启代码连字
  • 退出前确认
  • 换行参考线 100
  • 保存时去行尾空白 + 补末尾换行

全部应用 / 挑几个 / 取消？

---

安全保障

skill 会拒绝做这些事：

• 编造白名单与官方文档都没有的 Zed 字段
• 把快捷键请求写进 settings.json，或把任务写进 debug.json（路由错误）
• 在作用域还没确认时继续往下写文件
• 校验失败还保留损坏的 JSON——会立即回滚
• 未经你确认就批量写入推荐项

---

许可

见仓库根目录。