whaojie797-design/agent-handoff-kit

README 摘要

agent-handoff-kit EN: A portable, file-based handoff protocol that makes long Agent tasks survive context compression, model switching, crashes, and multi-agent takeovers — without losing progress or lying about what was actually verified. 中文： 一个可移植、基于文件的工作交接协议，让长任务在上下文压缩、切换模型、崩溃或多人接手后不丢进度，也绝不把"计划"伪装成"已完成的事实"。 Value proposition / 价值主张 - EN: Not a todo list — a handoff-quality contract that separates Verified · Completed · Pending · Assumption . - 中文： 不是待办清单，而是一份"可移交、可恢复、可验证"的 Agent 工作状态协议，明确区分"已验证 / 已完成 / 待完成 / 假设"。 Why / 为什么需要它 Long Agent tasks die in four ways. This kit kills all four. Failure How this kit prevents it Context window compressed → plan forgotten State lives in 4 files, not in context. Switched from Claude to Codex → no shared memory Files are vendor-neutral; any agent reads them. Crash mid-task → "did it finish?" unknown EVIDENCE LOG.md records what actually ran + output. New person/agent takes over → re-derives everything HANDOFF.md enables resume in 重要 / Important: Each host has its own skills directory. Installing in Claude Code does not make it available in Cursor. Install in every host you use. Every host reads the same SKILL.md and references/ , so behavior i…

分类