菜单
Use when a session is winding down and work will continue in a new session or another agent, when context is about to be compacted or lost, or when the user asks for a handoff, brief, summary, or "notes for the next session." Produces a durable, redacted, reference-not-copy handoff document the next session can pick up from.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Use when the user asks "is there a skill for X", "find a skill", "install a skill", "add a skill", asks whether a capability exists as an installable skill, or wants to extend the agent with functionality that might already be published. Searches with `clio skills search`, browses the ecosystem read-only, and installs only through `clio skills install`. Not for authoring a new skill; use skill-craft.
Use when writing or modifying Clio Coder's own source under src/, or verifying a change end-to-end against the real test harness. Covers the three real layers (contracts / smoke / boundaries), choosing which to run for a given change, the mock-provider and ACP-over-stdio harness, and the hot-reload dev loop for picking up latest code. Activate on any src/ edit, before declaring a change verified, or when asked whether Clio still works.
Use when a coding session begins, when resuming work after a break, or when you land in an unfamiliar or in-progress repository and need to orient before acting. Loads the last handoff, git state, the project constitution, and active-work signals so a fresh agent reconstructs intent instead of guessing. Triggers on "prime", "catch me up", "where were we", "get up to speed", or the first substantive request in a new session.
Use before running any tool or script that needs an API key, token, or other credential, when a command fails with an auth error, when the user must supply a new secret, or when a secret may have leaked into output. Covers facility surfaces such as kerberos tickets, globus and scheduler tokens, ssh agents, and netrc. Triggers on "API key", "credential", "token", "auth error", "permission denied", "add a secret", "leaked". Not for provider target configuration; use clio auth and target settings.
Use when a design decision has real tradeoffs and needs several expert perspectives that challenge each other before code is written, such as architecture choices, API shapes, storage formats, parallelization strategies, or dependency decisions. Quick mode runs a single round for a fast perspective check. Triggers on "council", "debate this", "multiple perspectives", "weigh the options", "what would experts say". Not for a one-question-at-a-time interrogation of a plan; use grill-me. Not for splitting implementation work across workers; use dispatch directly.
Use when running a performance study, numerical comparison, parameter sweep, kernel or solver benchmark, or any change justified by "faster" or "more accurate", and success criteria should be locked before results exist. Pre-registers thresholds, tolerances, environment pins, and verdict conditions into the repository validation contract before any measurement. Triggers on "benchmark", "compare implementations", "optimize", "tolerance", "reproduce results", "parameter sweep". Not for diagnosing a stalled bug; use scientific-debugging.
| name | context-handoff |
| description | Use when a session is winding down and work will continue in a new session or another agent, when context is about to be compacted or lost, or when the user asks for a handoff, brief, summary, or "notes for the next session." Produces a durable, redacted, reference-not-copy handoff document the next session can pick up from. |
| version | 0.2.1 |
| license | Apache-2.0 |
| allowed-tools | ["read","grep","find","ls","git","context","write","bash","ask_user"] |
| registry-id | iowarp/clio-coder |
| source-url | https://github.com/iowarp/clio-coder/tree/main/skills/context-handoff |
| audit | pass |
Write a durable brief so a fresh session continues the work without re-reading
the whole transcript. This is the write-side bookend of context-prime, which
reads what this produces.
Distinct from two things it is often confused with:
/compact summarizes within the current session; it is ephemeral and lost
when the process exits. A handoff is a file that outlives the session./resume restores a session's transcript. A handoff carries intent:
decisions, rationale, and blockers that a transcript alone makes expensive to
recover.Focus. If the user passed arguments, treat them as the next session's focus and slug. Otherwise summarize all active threads.
Gather state. Capture git state and recent commits with
context(scope="workspace") and git (op=status) when available, else
git status -sb and git log --oneline -10. Note uncommitted changes.
Get the real date. Run date +%F. Never fabricate the date.
Draft using the template below. Pull from the conversation: goals, decisions + rationale, work completed, work in progress (with the exact pick-up point), blockers, errors and what was tried.
Reference, don't duplicate. Point at PRDs, ADRs, plans, issues, and diffs
by path or URL (docs/adr/001.md, a PR link). Do not paste their contents.
Redact. Remove API keys, tokens, secrets, passwords, and PII unless it is
genuinely part of the project. Replace with [REDACTED] and note what was
removed.
Suggest skills from the context(scope="skills") listing (do not scan
the filesystem): name two to five the next session should invoke, one line
each, tied to the next focus or the work in progress. Always include
context-prime as the first step.
Write to .clio/handoffs/handoff-YYYY-MM-DD[-slug].md. .clio/ is
intentionally ignored by default unless the user force-adds something. Use
scripts/new-handoff.sh [slug] (relative to this skill's base_dir) to
resolve the date, ensure the directory exists, and print the target path.
Confirm. Tell the user the full path, a one-line summary, any blocker
needing attention, and that the next session should run context-prime.
# Handoff [YYYY-MM-DD]: [focus]
## Context
- **Project**: [name / repo] · branch `[branch]`
- **Session focus**: [what this session worked on]
- **Next session focus**: [user hint, or "TBD"]
## Goals
- [Overall objective]
## Work completed
- [Done]: [path or commit]
## Work in progress
- [WIP]: pick up at [file:line or task]
## Decisions & rationale
- [Decision]: because [reason]
## Blockers & open questions
- [Needs human input]
## Errors & gotchas
- [Notable failure and what was tried]
## Suggested skills
- context-prime: orient before acting
- [skill]: [why]
## References
- [path or URL]: [one line]
scripts/new-handoff.sh [slug] prints the resolved target path and creates
.clio/handoffs/ if needed. Write the document to the path it prints.