Skill: hollis9087/long-task-handoff (version 0.3.3)

--- name: long-task-handoff description: Ultra-light automatic handoff manager for long-running agent sessions. Use this skill when context is compacted/summarized/resumed, low-context or context-folding hooks fire, the user says continue/继续/接着做 after a restart, a task has substantial workspace state, or the agent is about to recommend a new session. Keep the user experience nearly invisible: call the bundled Python manager to create/update/recover/validate handoffs, update ACTIVE.md automatically, suggest restart only after repeated compactions, and read ACTIVE.md in fresh sessions before asking the user to restate context. metadata: agents: [codex, openclaw, hermes-agent, claude-compatible] requires: write_access: workspace-or-temp bins: [python] os: [windows, macos, linux] --- # Long Task Handoff Keep this skill lightweight. Do not manually reproduce the full handoff template in context. Use the bundled Python manager and keep user-facing messages short. Detailed protocol is deferred to `references/protocol.md`. Do not load it during normal operation. Load it only if the manager is unavailable, the skill is being audited or modified, or a manual fallback is required. ## Use The Manager Prefer: ```bash python scripts/handoff_manager.py update --workspace . --task "Task name" --event context_compaction --compaction-count N ``` Installed script paths: - Codex: `.codex/skills/long-task-handoff/scripts/handoff_manager.py` - Hermes: `/root/.hermes/skills/software-development/long-task-handoff/scripts/handoff_manager.py` Useful commands: ```bash python scripts/handoff_manager.py create --workspace . --task "Task name" python scripts/handoff_manager.py update --workspace . --task "Task name" --event context_compaction --compaction-count N python scripts/handoff_manager.py recover --workspace . python scripts/handoff_manager.py suggest --compaction-count N --json python scripts/handoff_manager.py validate handoffs/session-handoff-*.md ``` Pass rich task facts with `--input-json` when available. Otherwise pass only concise CLI facts such as `--completed`, `--test-result`, `--key-file`, `--unfinished`, `--next-action`, `--risk`, and `--do-not-do`. ## Automatic Behavior - First compaction: update handoff quietly. - Second compaction: update handoff and verify `handoffs/ACTIVE.md`. - Third compaction: update handoff and briefly say restart is advisable. - Fourth compaction or state loss: update handoff and strongly recommend restart. - Fresh session with "continue", "keep going", "继续", or "接着做": run `recover` before asking the user for context. The user should not need to know the handoff path. A new session prompt like "continue this task" should be enough when `ACTIVE.md` exists. ## Boundaries The handoff is a restart packet, not a project wiki. Include only current restart-critical state: goal, branch/commit/worktree, delta, tests, key files, unfinished items, next actions, risks, and do-not-do items. Do not include secrets, `.env` contents, private keys, long chat logs, stale plans, unverified guesses as facts, or descriptions that conflict with the current workspace. Put durable project knowledge in repo docs and reference it by path. ## If Script Fails Do not silently continue. Report the concrete failure, keep the message short, and avoid asking the user to restate context unless `recover` cannot find or read a handoff.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)