跳到主要内容

AI 编程工具的个人配置管理

常用 AI 配置,
换项目接着用

不必为每个项目手动复制技能和指令。将它们整理成配置包后,就能在不同项目中复用。Skul 支持 12 种编程工具,按各工具要求放置文件,让个人配置不出现在 git status 的变更列表中。

skul
$ skul add sjquant/ghosts writing
Applied writing for claude-code, codex, cursor

$ ls .claude/skills
ghosts:cold-reader ghosts:eli5 ghosts:humanize-korean ghosts:make-skill ghosts:rewrite

$ git status
nothing to commit, working tree clean

适配工具的目录结构

同一份配置包,写入各工具需要的位置。

Claude Code、Codex 等工具支持的条目类型和文件路径各不相同,Skul 会将配置包中受支持的内容写入对应位置。可以按项目添加,也可以用 --global 应用到用户主目录下。

Claude Code.claude/
Codex.agents/, .codex/
收集技能与指令的配置包skills/agents/AGENTS.mdmcp.json
Cursor.cursor/
OpenCode.opencode/

也支持 GitHub Copilot, Kiro, Antigravity, Grok Build, Qwen Code, Cline, Kimi Code CLI, ZCode。

在团队仓库中使用个人指令

沿用团队指令,
补充个人指令

在团队已经提交的 AGENTS.md 上,本地追加自己的指令。编程工具会同时读取两部分内容,而个人追加的内容不会显示为 Git 变更。拉取上游变更时使用 skul sync,不要直接编辑 Skul 管理的文件。

已提交的指令文件如何处理 →
团队共享的指令已经提交到仓库的文件
自己追加的指令来自个人配置包,只在本地应用
编程工具读取的内容团队指令和个人指令一起使用

不纳入 Git 的方式

个人配置留在本地,
不必跟着代码提交。

个人配置会登记到 .git/info/exclude,不会改动团队共享的 .gitignore。移除配置包时,Skul 会清理自己管理的配置,并恢复之前保留的原文件。

了解文件管理与移除方式 →
编程工具使用的文件
my-project/
  .agents/skills/
  .claude/skills/
  .cursor/skills/
  src/
  README.md
Git 跟踪的文件
my-project/
  src/
  README.md

从公开示例了解使用方法

需要 Node.js 20 或更高版本,以及 Git。

skul
$ npm install --global @solaqua/skul
$ skul add sjquant/ghosts writing

上面的命令会应用公开示例配置包 writing。要使用自己的设置,可以指定按相同结构创建的配置包仓库。