GUSH 版本交接与跨端管理

解决跨会话上下文丢失

在 Codex 等编程 Agent 参与的长期项目中，上下文切换往往是最大的隐性成本。当你在不同设备上接力开发，或者新启动一个 Agent 会话时，如果仅依赖终端里的历史记录，很容易遗漏关键的决策、命令验证结果或未解决的风险。手动复制粘贴这些状态不仅低效，还会导致项目维护规则散落各处。

工作原理：结构化的 Git 里程碑

GUSH（Git Update In Agent）的核心思路是将 Git 检查点与标准化的文档结合起来，把持久的项目上下文固化进仓库。它的工作流如下：

• 环境检查与初始化：首先在项目根目录运行检查。如果未检测到 Git 仓库，它会先审查目录并补全 .gitignore（排除缓存、构建产物等），然后执行初始化，确保主分支为 main。
• 分离稳定规则与交接状态：

维护 AGENTS.md：仅用于存放稳定的项目规则，包括构建命令、目录结构边界和部署约束，不写入临时进度。
维护 docs/HANDOFF.md：作为每次会话的交接文件。它会按时间戳追加检查点，记录当前状态、已确认的决策、未决问题以及推荐下一步，并附带改动文件和验证结果。

• 提交与版本管理：在提交前会审查 diff，确保只暂存与里程碑相关的变更。如果已有 GitHub Remote，在 main 分支上会新建 checkpoint/YYYY-MM-DD-summary 分支而不是覆盖主干。

适用边界与注意点

• 该技能假设运行环境是受 Agent（如 Codex）管理的项目。
• 它严格区分了临时进度和持久规则，确保 AGENTS.md 不会被流水账污染。
• 如果没有配置 GitHub CLI 或未授权，技能会在本地提交后停止，并提示用户后续的认证步骤。