Agent Skills
返回列表
🤖

AgentHandoff 智能体项目交接

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_9e60f203/agent-handoff。

技能介绍

问题背景

多 Agent、多 IDE（Claude Code、Cursor、Codex 等）轮换开发同一仓库时，进度往往散落在 CLAUDE.md、.cursorrules、聊天记录里，下一任 Agent 要么全树 find 扫描，要么误改入口文件里的「项目日记」，导致状态不一致、链接失效、并行改同一文件。

核心机制

单一事实来源：根目录 handoff.md 是唯一看板；docs/handoff-log.md 是唯一会话日志。各平台入口文件只做薄导向——一句话要求「读取并维护 handoff.md，禁止在本文件记录项目数据」。

接管流程（每次会话开始，顺序不可跳）：若无 handoff.md 则自主从模板初始化并创建薄入口；读取看板（禁止全树扫描）；跑构建/测试校验实际状态；读最近 3～5 条日志中的接班任务与已知问题；声明本次会话范围。

开发与交接：任务状态用 [ ] / [/] / [x] 实时更新；增删文件同步「文档索引」；会话结束前先备份旧版到 backup/handoff/ 与 backup/log/，再验证代码、更新看板、追加日志（含改动文件清单），必要时 conventional commit。

防冗长：看板过长时可拆到 docs/rules.md、docs/structure.md、docs/decisions.md，看板只留链接与摘要；日志超过 10 条则归档到 docs/handoff-log-archive.md。

适用与注意

适合需要跨会话、跨工具持续维护的中长期项目。根目录有严格整洁规范（游离文件需归位并登记索引）；并行时勿动他人标记为 [/] 的任务；「用户偏好」区由人类填写，Agent 只读不改。

使用场景

  • 本周在 Cursor 改了一半功能，下周换 Claude Code 继续，需要 Agent 先读 `handoff.md` 并跑通测试再动手
  • 仓库里同时有 `CLAUDE.md` 与 `.cursorrules` 各写进度，决定统一只维护根目录看板并清空入口文件里的项目日记
  • 会话结束前要把未完成任务、改动文件清单写入 `docs/handoff-log.md`，并备份修改前的看板以防误删
  • 看板超过 200 行，需要在会话结束时评估拆分到 `docs/rules.md` 并保留看板上的链接与摘要

适合人员

  • 长期在 Claude Code、Cursor、Windsurf 之间切换、同一仓库需要可核对任务表与已知问题的独立开发者
  • 负责规范团队 Agent 行为、要求禁止在平台入口文件写进度、只认 `handoff.md` 的技术负责人
  • 单次会话常被中断、依赖 `handoff-log` 逆序日志与分钟级备份恢复看板的中长期项目维护者
  • 多人或多 Agent 并行改库、需要通过 `[/]` 任务标记与日志标注冲突点的协作型项目负责人