mcpField
H
handoffs

handoffs

github.com/jellydnAgent 工作流12551 次安装3 天前更新
代码仓库

关于 handoffs

handoffs 是用于生成会话交接计划的技能，帮助另一个 Agent 继续开发工作。它按结构记录用户意图、技术背景、文件、当前状态、阻碍事项和后续行动，并写入 Markdown 文件。

主要功能

  1. 01要求明确交接目的
  2. 02总结决策和当前工作状态
  3. 03记录相关文件、代码与阻碍
  4. 04确定直接相关的下一步
  5. 05写入并验证带日期的交接文件

适用场景

  1. 01将进行中的开发交给另一个 Agent
  2. 02会话结束前保留工作背景
  3. 03记录阻碍和用户要求的后续步骤

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jellydn/my-ai-tools --skill handoffs

安装后在 Claude Code 中输入/handoffs确认已加载。

详细介绍

会话交接计划

为继续在新会话中开展工作，创建一份详细的对话交接计划。

用户指定的目的：

$ARGUMENTS

你正在创建一份摘要，专门用于让另一位 Agent 接续工作。要做到这一点，必须有明确的目的。如果 <purpose>...</purpose> 标签中没有提供指定的目的，你必须立即停止，并询问用户目的是什么。

在询问目的之前不要继续，否则你将无法理解这些指示，也不要自行假设目的！

目标

创建一份迄今为止对话的详细摘要，尤其关注用户为后续步骤明确指定的目的。 这份交接计划应全面记录对继续开发工作至关重要的技术细节、代码模式和架构决策，以免丢失上下文。

流程

在提供最终交接计划之前，先向用户提供一份简洁、有据可依的摘要。不要透露私有思维链或 <analysis> 标签。请列出决策、当前状态、阻碍事项和确切的下一步，而不是按时间顺序复述对话或完整粘贴代码。

  1. 确认用户明确指定的目的和当前工作状态。
  2. 核实重要路径、分支和状态、最近的命令结果以及尚未解决的阻碍事项。
  3. 只记录与决策相关的文件名、符号、简短片段和链接。
  4. 明确标注不确定或可能已过时的信息。

计划应包含以下部分：

  1. 主要请求与意图：详细记录用户明确提出的所有请求和意图
  2. 关键技术概念：列出讨论过的所有重要技术概念、技术和框架。
  3. 文件与代码部分：列出检查、修改或创建的具体文件和代码部分。特别关注最近的消息，并在适用时提供完整代码片段，同时说明读取或编辑这些文件的重要性。
  4. 问题解决：记录已解决的问题和仍在进行的故障排查工作。
  5. 待办任务：概述用户明确要求开展的所有待办任务。
  6. 当前工作：详细描述交接请求之前正在进行的工作，特别关注用户和助手最近的消息。适用时请包含文件名和代码片段。
  7. 下一步：列出与最近工作相关的下一步。重要：确保此步骤直接符合用户的明确请求，并与交接请求之前正在进行的任务一致。如果上一项任务已经完成，则只有在用户明确要求的情况下才列出后续步骤。未经用户确认，不要开始无关任务。仅在存在可执行的下一步时包含此部分。

此外，还要为这份交接创建一个“slug”。之后我们会在几个地方使用这个名称来指代它。示例：

  • current-user-api-handler
  • implement-auth
  • fix-issue-42

同时提供此 slug 的“易读摘要”。示例：

  • 实现当前用户 API 处理器
  • 实现身份验证
  • 修复问题 #42

输出结构

交接文件应包含以下结构化摘要。不要包含私有思维链或按时间顺序复述对话。

# Session Handoff Plan

## 1. Primary Request and Intent

[Detailed description of all user requests and intents]

## 2. Key Technical Concepts

- [Concept 1]
- [Concept 2]
- [...]

## 3. Files and Code Sections

### [File Name 1]

- **Why important**: [Summary of why this file is important]
- **Changes made**: [Summary of the changes made to this file, if any]
- **Code snippet**:

\`\`\`language
[Important Code Snippet]
\`\`\`

### [File Name 2]

- **Code snippet**:

\`\`\`language
[Important Code Snippet]
\`\`\`

[...]

## 4. Problem Solving

[Description of solved problems and ongoing troubleshooting]

## 5. Pending Tasks

- [Task 1 that you have been explicitly asked to work on]
- [Task 2 that you have been explicitly asked to work on]
- [...]

## 6. Current Work

[Detailed description of what was being worked on immediately before this handoff, including file names and code snippets]

## 7. Next Step

[Next step to take, directly aligned with user's explicit handoff purpose. Only include if there is an actionable next step.]

最后一步

提供分析和总结后：

  1. 确保 .planning/handoffs/ 目录存在（如有需要则创建）
  2. 将交接摘要写入 Markdown 文件 .planning/handoffs/[timestamp]-[slug].md，其中 [timestamp] 为当前日期，格式为 YYYY-MM-DD，[slug] 为之前定义的内容
  3. 重新读取交接文件，并确认其中包含目的、当前状态、验证情况、阻碍因素和下一步行动。
  4. 告知用户该文件的位置，并说明他们可以使用 /pickup $1 继续操作，其中 $1 为文件名

评论

支持 Markdown