session-handoff SKILL.md skillA
session-handoff from hanzhangzzz/agent-skills-zh is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add hanzhangzzz/agent-skills-zh/session-handoff@git:20261029.701fb99Pins git:20261029.701fb99 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- hanzhangzzz/agent-skills-zh
- Path
session-handoff/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261029.701fb99, committed Oct 29, 2026
- Size
- 6,821 bytes
- Repository stars
- 1
- License
- MIT
跨 session 续接任务，Claude Code 与 Codex 通用。save：把目标、状态、用户裁决原话、下一步、关键路径、验证情况写成交接文件，按仓库身份（规范化的 git origin）存放，目录改名后仍找得到，同一任务覆盖更新；resume：列出当前仓库与全局最近的交接文件，读选中那份、复述后接着干；find：在 Claude Code 与 Codex 的会话记录里按关键词、旧目录名或仓库 origin 找回 session，给出恢复命令。用户说 save、存一下、交接、续接、接着上次、上次做到哪、找回 session、上个 session 在干啥、resume 不回来、我之前说过 时使用。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# session-handoff 会话会断（上下文用完、换工具、换目录），任务不能断。交接文件存在 `~/.claude/handoffs/<仓库键>/<任务名>.md`，Claude Code 和 Codex 读写同一处。 - **仓库键**：有 git origin 就用规范化后的 origin（如 `gitlab.example.com/group/repo`，协议、用户名、端口、`.git` 都去掉），所以目录改名、换 worktree 都还是同一个键；没有 origin 用 `local/<主检出目录名>`。 - 脚本只给路径、只读会话记录；交接文件的内容由你来写。 脚本：`scripts/handoff.py`（本 SKILL.md 所在目录下，只用 Python 3 标准库）。下文的 `HANDOFF` 指 `python3 <本 skill 目录>/scripts/handoff.py`。 | 用户说 | 做什么 | |---|---| | save、存一下、交接 | [save](#save) | | 接着上次、续接、上次做到哪 | [resume](#resume) | | 找回 session、上个 session 在干啥、resume 不回来、我之前说过（但没有交接文件） | [find](#find) | ## save 1. 在任务目录里运行 `HANDOFF path [--task <任务名>]`。在任务分支上可省略 `--task`，脚本取分支名（去掉 `task/` 等前缀）；在 main/master 上必须给任务名，用短而稳定的名字，下次续写用同一个。 2. 输出「已存在：是」时，先读旧文件再在它上面更新：保留全部旧裁决，状态、下一步、路径改成最新。同一任务只有一份文件，不另建。 3. 用下面的模板写入。只写这六节；不贴对话流水和大段日志；已在 PR、文档、提交里的内容给路径或链接。 ```markdown # <任务名> ## 目标 <一句话> ## 状态 完成度 <X%>（口径：<按什么算>）。<停在哪一步，卡在什么> ## 用户裁决 - <YYYY-MM-DD>「<用户原话>」——<约束了什么> ## 下一步 1. <可直接执行的步骤：命令、文件、要改的点> ## 关键路径 - 仓库：<origin> · worktree：<路径> · 分支：<名> - PR/MR：<链接> - 产物：<路径> ## 验证 - 已验证：<命令 → 结果> - 未验证：<项 → 怎么验> ``` 4. 回报文件路径，并告诉用户下次怎么续：在新 session（Claude Code 或 Codex 都行）里说「接着上次」。 ### 用户裁决当场落盘 …
Read the whole file at its exact version.
How to install
mdr add hanzhangzzz/agent-skills-zh/session-handoff@sha256:14e542f4c5e7a61bThe line at the top of this page pins the label git:20261029.701fb99, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_ehyn7tdgc2r5hxhk)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 29, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (6821 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
hanzhangzzz/agent-skills-zh · 1 stars · license MIT · pushed 2026-10-29 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ehyn7tdgc2r5hxhk GET https://markdownregistry.com/api/v1/resolve?ref=hanzhangzzz/agent-skills-zh/session-handoff GET https://markdownregistry.com/api/v1/blob/14e542f4c5e7a61b10f7221938ee0cb3ab33758a3bd1112e175a22d99062e794
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from hanzhangzzz/agent-skills-zh
Every file in hanzhangzzz/agent-skills-zh