← 返回 Skills 市场

Long Task Handoff

Name: Long Task Handoff
Author: hollis9087

作者 hollis9087 · GitHub ↗ · v0.3.3 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install long-task-handoff

功能描述

Automatically create a compact, standardized handoff file for long tasks to enable seamless session restarts or agent transfers without losing context or pro...

使用说明 (SKILL.md)

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:

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:

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.

安全使用建议

Install this if you want automatic restart handoffs for long coding sessions. Review or delete `handoffs/ACTIVE.md` and old handoff files when switching tasks or sharing a workspace, and do not pass secrets into handoff payloads.

能力标签

cryptorequires-walletrequires-sensitive-credentials

能力评估

✓ Purpose & Capability

The capability matches the stated purpose: create, update, validate, and recover concise long-task handoff files. The bundled scripts write `handoffs/session-handoff-*.md` and `handoffs/ACTIVE.md`, inspect limited git state, and validate that handoffs avoid secrets.

ℹ Instruction Scope

The activation language is broad around compaction, resume, and continuation phrases, but the artifacts frame this as after restart or context-loss scenarios and require finding a handoff before recovery. Users should know the skill may act automatically in long-running sessions.

✓ Install Mechanism

The artifact contains Markdown, JSON evals, and dependency-free Python scripts. Metadata and static scan report no package dependencies or suspicious static findings; VirusTotal telemetry is absent.

✓ Credentials

Workspace write access and Python are proportionate for a local handoff manager. The script confines normal writes to a `handoffs` directory under the chosen workspace and does not perform network calls.

ℹ Persistence & Privilege

The skill intentionally persists restart state in workspace files and updates `ACTIVE.md`. This persistence is disclosed and purpose-aligned, but users should avoid installing it in workspaces where handoff notes should not be retained.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install long-task-handoff
安装完成后，直接呼叫该 Skill 的名称或使用 /long-task-handoff 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.3.3

Preserve full capability with progressive disclosure: keep SKILL.md lightweight while moving detailed protocol guidance to references/protocol.md for on-demand loading.

v0.3.2

Make skill body ultra-light for low context overhead; keep deterministic behavior in bundled Python manager.

v0.3.1

Clean packaging after CLI-first refactor: exclude local install metadata while preserving handoff_manager.py and slim SKILL.md.

v0.3.0

CLI-first refactor: add handoff_manager.py for create/update/find/recover/suggest/validate, slim SKILL.md to trigger protocol, and keep check_handoff.py as compatibility validator.

v0.2.1

Add compaction update discipline: active handoff is a current snapshot plus concise delta, stale content is removed, and Supersedes/Authoritative metadata prevents conflicting handoffs.

v0.2.0

Add low-friction automation contract: auto-update handoff on compaction, recommend restart after repeated compactions, and recover from vague continuation requests by reading ACTIVE.md.

v0.1.1

Metadata republish: corrected tag parsing after initial upload; no skill content changes.

v0.1.0

Initial release: proactive long-task handoff generation with validator, ACTIVE pointer, and cross-agent restart instructions.

元数据

Slug long-task-handoff

版本 0.3.3

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 8

常见问题