handoff-template

# 交接模板 创建交接文档时使用此模板结构。智能脚手架脚本将预填元数据部分；请根据会话上下文完成剩余部分。 ## 目录 - [会话元数据](#session-metadata) - [当前状态总结](#current-state-summary) - [代码库理解](#codebase-understanding) - [架构概览](#architecture-overview) - [关键文件](#critical-files) - [发现的关键模式](#key-patterns-discovered) - [已完成工作](#work-completed) - [已完成任务](#tasks-finished) - [已修改文件](#files-modified) - [已做决策](#decisions-made) - [待办工作](#pending-work) - [立即下一步](#immediate-next-steps) - [阻塞项/开放问题](#blockersopen-questions) - [延期项](#deferred-items) - [恢复智能体的上下文](#context-for-resuming-agent) - [重要上下文](#important-context) - [所做假设](#assumptions-made) - [潜在陷阱](#potential-gotchas) - [环境状态](#environment-state) - [相关资源](#related-resources) - [模板使用说明](#template-usage-notes) --- # 交接：[TASK_TITLE] ## 会话元数据 - 创建时间：[TIMESTAMP] - 项目：[PROJECT_PATH] - 分支：[GIT_BRANCH] - 会话时长：[APPROX_DURATION] ## 当前状态总结 [一段话：正在进行的工作、当前状态以及中断点] ## 代码库理解 ### 架构概览 [本会话中发现的关键架构见解 - 系统结构、主要组件、数据流] ### 关键文件 | 文件 | 用途 | 相关性 | |------|---------|-----------| | path/to/file | 此文件的功能 | 为什么对本任务重要 | ### 发现的关键模式 [在此代码库中发现的重要模式、约定或惯用法，后续智能体应遵循] ## 已完成工作 ### 已完成任务 - [x] 任务 1 - 所做工作的简要描述 - [x] 任务 2 - 简要描述 ### 已修改文件 | 文件 | 变更 | 原理 | |------|---------|-----------| | path/to/file | 变更描述 | 为什么进行此变更 | ### 已做决策 | 决策 | 考虑的选项 | 原理 | |----------|-------------------|-----------| | 选择 X 而非 Y | X, Y, Z | 为什么选择 X | ## 待办工作 ### 立即下一步 1. [最关键的下一步行动 - 首先要做什么] 2. [第二优先级] 3. [第三优先级] ### 阻塞项/开放问题 - [ ] 阻塞项