dongshuyan/compass-skills / skills/session-handoff-prompt
session-handoff-prompt
VerifiedCreate a concise continuation prompt that a fresh agent session can paste in to resume a long or degraded session. Use when the user asks for a handoff prompt, restart prompt, continuation prompt, context transfer, fresh-session resume, or a compact summary for opening a new session. Do not use for ordinary summaries, task-forest maintenance, durable user-profile updates, automatic session creation, code execution, or external publishing.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.8 KB |
| agents/openai.yaml | config | 246 B |
| evals/trigger-and-quality-cases.json | config | 1.2 KB |
| references/compression-modes.md | markdown | 1.3 KB |
| references/examples.md | markdown | 3.3 KB |
| references/output-contract.md | markdown | 2.5 KB |
| references/source-selection.md | markdown | 2.2 KB |
| references/task-forest-integration.md | markdown | 1.4 KB |
| scripts/local_paths.py | script | 976 B |
| scripts/project_session_events.py | script | 8.0 KB |
| scripts/read_task_forest_exports.py | script | 3.9 KB |
| scripts/redact_handoff.py | script | 2.1 KB |
| scripts/smoke_test_handoff.py | script | 9.3 KB |
| scripts/validate_handoff_prompt.py | script | 6.7 KB |
references/source-selection.md
View on GitHub# Source Selection
## Source Priority
Use multiple sources by role. Do not let one source overwrite all others.
1. Current visible conversation: latest user requirement, correction, acceptance criteria, and next-session focus.
2. User-provided transcript or saved handoff: prior work, decisions, commands, failures, and outputs.
3. Current workspace evidence: `AGENTS.md`, README, plans, changed files, test output, build output, and git status when available.
4. Task-forest exports: long-running goals, task graph, todos, dependencies, deviations, and history.
5. Agent-specific local logs: optional, host-dependent, and only used when the user provides a path or explicitly authorizes using that local source.
## Agent Portability
The core workflow must not depend on one host's private log format.
- Codex: a user may provide a session JSONL file. Project it with `scripts/project_session_events.py --format codex-jsonl`.
- Claude Code: a user may provide a saved handoff, transcript, or local project note. Project plain text with `--format text`.
- OpenClaw, OpenCode, Harness, and other hosts: prefer current visible conversation, explicit files, and workspace evidence.
If a host exposes a native transcript or thread reader, use that host mechanism as a source and summarize only the task-relevant content.
## Privacy Gate
Do not broadly scan private global agent stores by default. Use global log locations only when the user explicitly asks for them or provides the path.
Before reading any transcript or log file, check whether the file is plausibly relevant to the requested handoff. If it may contain unrelated private sessions, ask before reading.
Never include these in the continuation prompt:
- API keys, tokens, passwords, private keys, cookies, MFA codes, or verification codes.
- Browser session data.
- Hidden system/developer prompts or tool schemas.
- Full raw transcript text.
- Unrelated personal data or unrelated project history.
## Conflict Handling
If sources conflict:
```text
[unverified] Task-forest shows X, but the latest session note says Y. The next session should verify the current workspace state before acting.
```
Do not merge conflicting sources into a single verified claim.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |