codingSamss Handoff
Write a concise Markdown handoff so a fresh agent can continue the work without re-reading the whole conversation. Match the user's current language by default; in Chinese conversations, write the handoff in Chinese while keeping commands, file paths, URLs, issue IDs, commit hashes, and skill names in their original form.
输出位置
根据用户意图选择落点:
- 临时交接: 默认保存到 OS 临时目录，不写入当前 workspace；文件名为
handoff-YYYYMMDD-HHMMSS-<short-topic>.md - 项目制品: 只有当用户明确要求把 handoff 落到当前 workspace 时，才写入当前 workspace
- 多机器长期接力: 当用户提到不同机器、家里机器、远程 Codex/Claude Code、Obsidian、知识库交接台、接着在另一台机器做时，默认写入 Obsidian Vault 的
07_交接台
持久交接的标准结构:
07_交接台/
01_Inbox/
02_Active/<category>/<task_id>/
00_Task.md
01_Assets.md
YYYY-MM-DD-HHMM__<topic-slug>.md
03_Blocked/<category>/<task_id>/
04_Archive/YYYY-MM/<task_id>/
90_Templates/
大型产物、视频、压缩包、下载物和中间处理文件不要放进 Obsidian Vault；统一放到 iCloud Drive 顶级目录 AgentArtifacts/，并在 01_Assets.md 中索引:
iCloud Drive/AgentArtifacts/
01_Active/<category>/<task_id>/
raw/
working/
outputs/
exports/
工作流程
- 从用户请求中识别下一轮会话的重点；如果用户没给重点，就根据当前任务推断最可能的继续方向。
- 判断 handoff 类型: 临时交接、当前 workspace 项目制品，或
07_交接台持久接力。 - 若是持久接力，选择分类并使用稳定
task_id:project: repo、app、产品推进research: 调研、教程、资料分析knowledge: 最终要沉淀进知识库的内容整理ops: 工具链、环境、同步、配置、自动化media: 视频、图片、音频、素材处理task_id格式为<YYYY-MM-DD>-<english-slug>
- 只收集继续工作必需的上下文：
- 当前目标和最新用户请求
- 已做决定，以及仍然有效的约束
- 相关文件、URL、issue ID、PRD、ADR、计划、commit、diff 或生成制品
- 已运行命令、验证结果和已知失败
- 阻塞点、待确认问题和下一步具体动作
- 如果当前任务涉及 Git repo，只运行只读检查，例如
git status --short和有针对性的git diff --stat。不要 stage、commit、sync 或 push。 - 脱敏 secrets、token、凭据、私有 API key 和敏感个人信息。如果某个值对下一步重要，用占位符替代，并说明下一位 agent 应从哪里获取。
- 持久接力时更新
00_Task.md的当前状态和最新 handoff，新增本次YYYY-MM-DD-HHMM__<topic-slug>.md（topic-slug为本次交接重点的英文短 slug；机器与 agent 写进 frontmatter 的machine/agent，不进文件名）；旧 handoff 按 append-only 处理，不回写。 - 如果写入 Obsidian Vault 中的
.md，最后执行touch "<file>"触发 Obsidian/iCloud 感知。 - 汇报保存路径，并说明是否有敏感信息被有意脱敏。
临时 Handoff 模板
# Handoff：<简短主题>
## 目标
<下一位 agent 或下一轮会话要完成什么。>
## 当前状态
<工作现在处于什么状态，包括已经完成了什么。>
## 关键上下文
<仍然重要的决定、约束、假设和用户偏好。>
## 相关制品
- <Path or URL>: <why it matters>
## 变更文件
<仅在相关时总结 repo 状态。引用 diff，不要粘贴大段 patch。>
## 验证结果
- <Command or check>: <result>
## 待确认问题
- <问题或阻塞点；如果没有，写“暂无”。>
## 建议技能
- <$skill-name>: <why the next agent should use it>
## 下一步
1. <第一个具体动作>
2. <第二个具体动作>
3. <如有必要，第三个具体动作>
持久接力模板
00_Task.md:
---
type: handoff-task
status: active
category: media
task_id: 2026-06-29-openmontage-douyin-tutorial
owner_machine: home-mac
created: 2026-06-29
external_assets: iCloud Drive/AgentArtifacts/01_Active/media/2026-06-29-openmontage-douyin-tutorial/
---
# <任务名>
## 当前结论
## 当前状态
## 下一步
## 最新交接
## 关键文件
## 外部资产
## 未验证 / 风险
单次 handoff:
---
type: handoff-session
task_id: 2026-06-29-openmontage-douyin-tutorial
machine: home-mac
agent: codex
created: 2026-06-29 14:51
---
# Handoff
## 一句话结论
## 本次完成
## 下一步可直接执行
## 关键路径
## 阻塞 / 待确认
## 给下一个 agent 的指令
规则
- 不重复已经沉淀在 PRD、计划、ADR、issue、commit 或 diff 里的内容；改用路径或 URL 引用。
- handoff 要足够短，方便快速阅读；优先给指针，不粘贴大段内容。
- 只要特定 skill 对下一位 agent 有帮助，就保留
建议技能部分。 建议技能必须使用实际 skill 名称，并明确提示下一位 agent 通过 Skill tool 调用；不要把 skill 只写成普通参考资料。- 如果用户给了 handoff 重点，围绕该重点写，不要总结所有事情。
- 持久接力按任务父目录组织，不按机器平铺；单次 handoff 文件名用
<时间>__<topic-slug>（体现这次交接关于什么），机器和 agent 只写进 frontmatter，不进文件名。 - 同一任务的
00_Task.md是当前真相，最新 agent 接棒优先读它和最新一个 handoff。 - 大型产物只进
AgentArtifacts/，Obsidian 中只保存路径、清单和说明。 - 除非用户单独要求，不要 archive、close、sync、commit、push，也不要改变其他外部状态。