shunk031-manage-public-private-dotfiles

说明

阅读此 SKILL.md 后，请说：🏠 I read shunk031-manage-public-private-dotfiles.

管理公开和私有 Dotfiles

将公开和私有的 chezmoi 源视为相关但独立的管理域。在提出或进行更改之前，先明确它们当前的所有权边界。

技能内容不再属于这两个管理域。它位于 shunk031/skills 和 shunk031/skills-private 中，dotfiles 仓库仅保留用于安装技能的订阅允许列表。任何新增、编辑或移除技能的操作，请使用 shunk031-manage-public-private-skills 技能；配置相关操作则使用本技能。

工作流

1. 调查之前，先阅读适用的说明。

   • 阅读 ~/.agents/AGENTS.md，然后在可读取时阅读 ~/.agents/AGENTS-private.md。
   • 将 ~/.agents/AGENTS-private.md 视为稳定的用户级路径。其规范内容位于 ~/.local/share/chezmoi-private/home/dot_config/codex/AGENTS-private.md，而其符号链接配置由公开 dotfiles 源管理。
   • 将私有内容保留在 home/dot_config/codex/AGENTS-private.md 中，仅为配置符号链接而更改公开仓库。不要重复内容。
   • 阅读两个 dotfiles 仓库中的根目录 AGENTS.md。在其中进行更改时，遵循各仓库的规则。

2. 在选择编辑目标之前，检查两个仓库。

   • 公开源：~/.local/share/chezmoi，使用 ~/.config/chezmoi/chezmoi.yaml。
   • 私有源：~/.local/share/chezmoi-private，使用 ~/.config/chezmoi-private/chezmoi.yaml。
   • 在两个仓库中检查 git status --short --branch，并保留所有现有更改。
   • 在两个源中搜索相关的应用路径、命令、设置、标识符和文档。如果源映射不明确，请使用对应的源和配置运行 chezmoi source-path。
   • 如果无法仅凭当前文件确定所有权、意图或之前的迁移情况，请检查两个仓库中的相关历史记录。

3. 根据证据确定当前的事实来源。

   • 可移植、可共享的配置和共享 Agent 指引，优先放在公开仓库。
   • 凭据、内部基础设施、私有配置文件、身份验证辅助工具、内部端点和私有启动器，优先放在私有仓库。
   • 这些是默认原则，不能替代对当前仓库说明和实现的检查。
   • 不要仅为使某项设置能在两种环境中使用，就将其复制到两个仓库。应保留适配器和符号链接，使其指向唯一的规范来源。

4. 仅进行必要的源文件更改。

   • 修改 chezmoi 源状态，而非主目录下已应用的文件。
   • 如果任务属于单个管理域，只更改权威仓库。
   • 如果两个仓库都需要协调更改，应分别维护其工作区、提交和拉取请求，并说明两者之间的依赖关系。
   • 如果仓库说明有要求，请为每个受影响的仓库创建干净的任务工作区。切勿将无关的本地更改混入任务。

5. 分别验证并报告各受影响的管理域。

   • 运行各受影响仓库要求的检查，并说明每项更改归属哪个仓库。
   • 不要在命令输出、聊天中引用的差异内容或摘要中暴露凭据和秘密值。
   • 常规实现工作可以按共享工作流提交更改、推送任务分支，并创建或更新拉取请求。合并、chezmoi apply、运行时更改、删除和清理仍需用户明确授权。
   • 用户授权执行 chezmoi apply 时，请以 GITHUB_TOKEN="$(gh auth token)" chezmoi apply 运行：公开源的外部模板会查询 GitHub Releases API，而匿名请求可能因 API 速率限制而失败。

预期结果

报告用于选择每个事实来源的证据、每个仓库中更改的文件、执行的验证，以及公开更改与私有更改之间所需的顺序。如果调查发现只需修改一个仓库，请明确说明。