Claude 配置同步回仓库 Skill
使用场景
在以下场景中应优先使用本 Skill：
- 用户希望将本机 Claude 配置变更同步回 dotfiles/chezmoi 仓库；
- 用户修改了
~/.claude/settings.json或~/.claude/skills_manifest.txt，需要安全地写回仓库； - 用户询问「Claude 配置如何用 chezmoi 管理」「settings.json 能 add 吗」；
- 用户需要把新装的 skill 纳入清单并同步到仓库。
背景：路径对应关系
| 本机路径 | 仓库源文件 | 说明 |
|---|---|---|
~/.claude/settings.json | dotfiles/dot_claude/settings.json.tmpl | 模板生成，含 KeePassXC 占位符 |
~/.claude/skills_manifest.txt | dotfiles/dot_claude/skills_manifest.txt | 普通文件，apply 时复制 |
~/.claude/skills/ | 仅 dotfiles/dot_claude/skills/.gitkeep，实际 skill 由清单 + run_after 安装 | 不同步回仓库 |
重要：settings.json 由模板生成，本机文件里是真实 token/URL，不能直接把本机文件 add 进仓库，否则会泄露敏感信息。
1. 同步 settings.json 的变更（需手动合并）
不要执行 chezmoi add ~/.claude/settings.json，否则会把明文 token 写进仓库。
正确做法：
- 打开本机
~/.claude/settings.json，确认用户改动的部分（例如新增的env键、permissions.allow/deny、其它顶层键）。 - 在仓库中编辑
dotfiles/dot_claude/settings.json.tmpl，把结构/键/非敏感值按本机版本更新。 - 必须保留敏感字段的模板写法，不能改成真实值：
ANTHROPIC_AUTH_TOKEN→ 保持{{ (keepassxc "Claude Code").Password }}ANTHROPIC_BASE_URL→ 保持{{ (keepassxc "Claude Code").URL }}
- 若有新增的非敏感 env 变量，在模板里直接写死值；若是敏感信息，需在 KeePassXC 中新增条目并在模板里用
keepassxc引用（或先不纳入仓库）。 - 保存后在本机执行
chezmoi apply验证生成结果是否与预期一致。
2. 同步 skills_manifest.txt 的变更
若本机修改了 ~/.claude/skills_manifest.txt（或通过 add-skill 装了新 skill 并希望纳入清单）：
- 方式 A：直接编辑仓库中的
dotfiles/dot_claude/skills_manifest.txt，把本机清单里新增/修改的行抄过去（格式：每行owner/repo [--skill name]）。 - 方式 B：若本机清单已是唯一真相且无敏感内容，可在仓库根执行：
chezmoi add ~/.claude/skills_manifest.txt
会用本机文件覆盖源文件，然后 chezmoi apply 会再把它写回本机并触发 run_after 安装 skills。
3. 其它 Claude 相关文件
- skills 目录：仓库只维护清单和 run_after 脚本，不把
~/.claude/skills/下具体 skill 内容纳入仓库。本机新装的 skill 只需在skills_manifest.txt里补一行并同步（见上）。 - run_after 脚本：
dotfiles/.chezmoiscripts/run_after_10-install-claude-skills.sh一般不需因「本机配置改了」而改；只有要改安装逻辑时才改仓库里的脚本。
4. 流程小结
- settings.json：禁止
chezmoi add，必须手动合并到settings.json.tmpl并保留 keepassxc 占位符。 - skills_manifest.txt：可编辑源文件或使用
chezmoi add覆盖。
完成后执行一次 chezmoi apply 确认无 diff，再提交并推送仓库变更。