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 |
scripts/read_task_forest_exports.py
View on GitHub#!/usr/bin/env python3
"""Read task-forest exports without modifying them."""
from __future__ import annotations
import argparse
import json
import os
from pathlib import Path
from typing import Any
EXPORTS = {
"graph": Path(".agent-workbench/task-forest/exports/task-forest.graph.json"),
"todos": Path(".agent-workbench/task-forest/exports/task-forest.todos.json"),
"timeline": Path(".agent-workbench/task-forest/exports/task-forest.timeline.json"),
}
def read_json(path: Path) -> Any:
try:
return json.loads(path.read_text(encoding="utf-8", errors="replace"))
except (OSError, json.JSONDecodeError):
return None
def short(value: Any, limit: int = 220) -> str:
if value is None:
return ""
text = value if isinstance(value, str) else json.dumps(value, ensure_ascii=False, sort_keys=True)
text = " ".join(text.split())
return text if len(text) <= limit else text[: max(0, limit - 1)] + "…"
def collect_records(obj: Any, keys: tuple[str, ...], limit: int) -> list[dict[str, str]]:
records: list[dict[str, str]] = []
def visit(value: Any) -> None:
if len(records) >= limit:
return
if isinstance(value, dict):
if any(k in value for k in keys):
record: dict[str, str] = {}
for key in ("id", "kind", "title", "status", "priority", "summary", "requirement", "acceptance", "description"):
if key in value and value[key] not in (None, ""):
record[key] = short(value[key])
if record:
records.append(record)
for child in value.values():
visit(child)
elif isinstance(value, list):
for child in value:
visit(child)
visit(obj)
return records
def summarize(workspace: Path) -> dict[str, Any]:
out: dict[str, Any] = {"workspace": str(workspace), "found": False, "files": {}, "summary": {}}
for name, rel in EXPORTS.items():
path = workspace / rel
meta: dict[str, Any] = {"path": str(path), "exists": path.exists()}
if path.exists():
stat = path.stat()
data = read_json(path)
meta.update({"mtime": stat.st_mtime, "size": stat.st_size, "parse_ok": data is not None})
out["found"] = True
if name == "graph" and data is not None:
out["summary"]["graph_records"] = collect_records(data, ("title", "kind", "status"), 24)
elif name == "todos" and data is not None:
out["summary"]["todo_records"] = collect_records(data, ("title", "status", "priority"), 24)
elif name == "timeline" and data is not None:
out["summary"]["timeline_records"] = collect_records(data, ("event", "title", "summary", "status"), 16)
out["files"][name] = meta
return out
def main() -> int:
parser = argparse.ArgumentParser(description="Read task-forest export summaries without modifying them.")
parser.add_argument("--workspace", default=os.getcwd())
parser.add_argument("--json", action="store_true")
args = parser.parse_args()
result = summarize(Path(args.workspace).expanduser().resolve())
if args.json:
print(json.dumps(result, ensure_ascii=False, indent=2))
else:
print(f"workspace={result['workspace']}")
print(f"task_forest_found={result['found']}")
for name, meta in result["files"].items():
print(f"{name}: exists={meta['exists']} path={meta['path']}")
for key, records in result["summary"].items():
print(f"\n{key}:")
for record in records:
title = record.get("title") or record.get("summary") or json.dumps(record, ensure_ascii=False)
print(f"- {record.get('id', '-')}: {record.get('kind', record.get('status', '-'))}: {title}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
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 |