workflow

workflow 是一个 MIT 许可的模板，用于让 Claude Code 在跨会话、跨机器和长期项目中保持状态准确。它不会单独相信交接笔记：/session-start 与 /handoff 两个 Skill 都会运行同一份 ground-truth.sh，核对本地 Git、远端、开放 PR、CI 和已支持的后台任务。笔记仍有价值，但被明确视作可以验证的“声明”。

工作方式

仓库把短期协调与长期项目记忆分开。notes/handoff.md 在每次会话结束时重写，归档保留旧交接；BACKLOG.md 只保存未完成工作；questions.md 记录必须由负责人决定的问题；notes/lessons.md 则保留后续会话应避免重复的错误。配置文件用于声明哪些仓库和分支的远端状态最重要。

• 真实状态启动：/session-start 先将上次笔记与 Git、远端、PR 状态、CI 和适用任务比对，再提出当天工作。
• 真实状态交接：/handoff 用同一检查更新交接和跟踪文件。
• 单仓库与工作区：可用于一个仓库，也可用于管理多个仓库的纯文档工作区。
• 安全接入：bin/adopt.sh 只复制缺失的模板文件，遇到已有文件会报告跳过，不覆盖项目内容。
• 跨平台 shell 流程：官方文档覆盖 macOS、Linux，以及 Windows 的 Git Bash 或 WSL。

实用配置流程

克隆仓库后，对项目根目录运行 workflow/bin/adopt.sh。在 .claude/ground-truth.conf 填入仓库列表，反复运行检查器直到其报告真实状态完整，再补充项目规则、待办和负责人决策。运行一次 /handoff 生成第一份已核对的状态；下次开工先运行 /session-start，在分配实现任务前处理差异。

适用场景

它特别适合在 CI 变化、后台任务失败、分支未推送，或多个智能体处理相邻工作后仍要恢复项目的团队和独立开发者。它的差异不在于更长的提示词，而在于把笔记与可观察的仓库状态核对。可与 Planning with Files 和 Subagent-Driven Development 对照使用。

限制与替代方案

脚本只知道你配置的范围，也只能读取已接入的系统。GitHub CLI 与 systemd 是可选项，因此不可读取的检查应保持“未知”，而不能视为通过。模板以 Claude Code Skill 为中心，其他智能体运行时需要适配。若需要不同的执行方式，可比较 Executing Plans Skill。

快速开始

阅读官方 README，复制前先检查模板内容，并按自己的源码管理和访问规则保存生成的项目专属笔记。