sync-agent-setups

同步 Agent 配置

Claude Code 是唯一事实来源。此工作流会列出检测到的所有非 Claude Agent，但只会写入用户在本次调用期间确认的目标。它绝不会自动启动。

1. 清点来源和目标

在当前机器上查找 Claude 当前启用的用户级配置，而不是假定固定路径。只列出用户编写的行为配置：

• 全局规则；
• 技能；
• 自定义斜杠工作流；
• 钩子；以及
• 非机密行为设置。

排除凭据、对话历史、缓存、遥测、生成的运行时状态和平台管理的内容。以只读方式检测每个已安装的非 Claude Agent 及其支持的配置界面。记录不可用或含糊的界面，而不是猜测。

解析每个 Claude 可见来源所经过的符号链接，并计算其校验和。读取目标的当前路径、文件类型、链接目标和校验和；不要沿下游差异反向追溯到 Claude。

门槛。 每个来源和检测到的目标都有稳定路径、所有权分类，以及明确的纳入范围或排除原因。

2. 生成试运行清单

根据 ${CLAUDE_SKILL_DIR}/references/manifest.md 对每个纳入范围的配对进行分类。现在加载该文件。其中包含分类表、暂存适配规则、备份路径解析方式和清单模板。只有在每个项目都恰好带有一个状态，且每份适配预览都展示最终字节及其语义差异后，才能继续。

3. 确认写入集

请用户从预览中选择或确认目标 Agent。检测不代表获得写入授权。确认仅涵盖当前清单中显示的指定目标、ready 项目 ID、备份路径、精确复制的链接目标、暂存适配路径、校验和、预期模式、语义差异和拟执行操作。

确认后重新清点，重新解析备份路径，并重新计算每份暂存适配的哈希值。任何来源校验和、目标状态、分类、路径、所选目标、已解析备份路径、暂存字节、暂存校验和或预期模式发生变化，都会使相应项目失效并返回预览。将已确认的 ready 项目改为 pending；在台账中保留所有 blocked、preserved-unsupported 和 preserved-orphaned 行。

门槛。 每个 pending 项目都属于明确确认的目标，并且仍与其预览一致；所有非就绪项目都仍在变更批次之外，且其状态和原因保持不变。

4. 预检并备份

在首次备份或写入目标之前，立即仅针对所选的 pending 项目调用 preflight-mutations。提供这些项目的目标 Agent、来源和目标路径、当前校验和及链接目标、暂存适配路径、校验和、预期模式、语义差异、确认来源、共享符号链接风险、已解析的带时间戳备份路径、失效条件、逐项恢复方案以及写入后的回读验证。将完整台账作为上下文参考，但不要将 blocked、preserved-unsupported 或 preserved-orphaned 项目放入变更卡片的目标或批次项目中。只有在这个独立就绪的变更批次返回 ready 且防护条件未变时，才能继续。

在更改目标前，先在记录的已解析物理路径创建经确认的带时间戳备份。为每个受影响的路径保留：

• 其原始路径，以及它原本不存在、是文件、目录还是符号链接；
• 符号链接文本，不解引用；
• 存在时的已解析路径和校验和；以及
• 足以恢复先前目标状态的内容和权限。

编写备份清单，将每个项目 ID 映射到其恢复操作。在首次更改目标前，验证备份清单和校验和。

门槛。 每个待处理目标路径都有经验证的恢复记录，包括保留的链接元数据和已解析内容证据。

5. 应用已确认的项目

根据 ${CLAUDE_SKILL_DIR}/references/apply-verify.md 应用每个项目，并验证每个目标。现在加载该文件。它规定了写入保护、各类项目的应用规则、恢复规范和每个目标的验证方式。只有在每个尝试处理的项目都有回读状态，且所有未更改内容都与预检时逐字节、逐链接一致后，才能退出。

完成。 每个检测到的目标和源文件都已妥善处理，只有已确认的目标发生了更改，每个更改过的路径都可恢复，并且每个目标的对等性声明都以其最弱的验收面为上限。