‹ 首页

session-end

@the-agency-ai · 收录于 昨天 · 上游提交 2 个月前

Clean session teardown — commit all work, write a resumption-framed handoff, stop monitors, report readiness. Leaves a clean working tree. No asking.

场景开发收尾工作交接

适合你，如果你需要在每次开发结束时自动提交代码并准备交接

/ 下载安装
https://github.com/the-agency-ai/the-agency/tree/main/.claude/skills/session-end ↗
/ 通过 npx 安装 校验哈希
npx oh-my-skill add the-agency-ai/the-agency/session-end
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- the-agency-ai/the-agency/session-end
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify the-agency-ai/the-agency/session-end
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
36GitHub stars
~1.1K上下文体积 · 单文件
索引托管

怎么用

商店整理自技能原文 · 版本 dd2430b · 表述以原文为准
它做什么

结束当前工作会话，自动提交未完成的工作，生成一份供下次会话恢复的交接文档，并停止相关监控进程。

什么时候触发

当你想结束工作会话、切换到不同任务或仓库，且不打算继续当前会话时触发。不要用于中途刷新。

装好后可以这样说
结束会话并生成恢复交接文档。
标记为“结束一天工作”原因。
标记为“切换上下文”原因。
技能原文 SKILL.md作者撰写 · MIT · dd2430b

<!-- Flag #62/#63: allowed-tools removed. Inherits Bash(*) from .claude/settings.json. Restricting to specific subcommand patterns at the skill level silently blocks agents on permission prompts the agent cannot see — see dispatch #171 for the devex incident that surfaced this trap. -->

Session End

Why this exists

The next session starts from the handoff. A session that ends with a dirty tree, unsent dispatches, or a stale handoff leaves the next agent reverse-engineering what was in flight. This skill forces the three end-of-session preconditions and shells to agency/tools/session-pause --framing resumption for the mechanics — commit, archive, stop monitors, emit new handoff path.

PAUSE-for-end surface. Paired with /session-resume on the other side.

Required reading
  • agency/REFERENCE/REFERENCE-HANDOFF-SPEC.md — handoff frontmatter, mode: resumption enum value.
  • agency/REFERENCE/REFERENCE-SKILL-CONVENTIONS.md — primitive-composition pattern.
Usage
/session-end
/session-end "end-of-day"
/session-end "switching-context"

[trigger-reason] (optional): short tag for telemetry + handoff frontmatter. Defaults to session-end.

Preconditions
  1. You're ending the session (or switching context). For mid-sprint refresh, use /compact-prepare.
  2. Uncommitted work is ready to commit as-is. The skill does not stash.

Idempotent: safe to run multiple times. Archives + re-writes each run.

Flow / Steps
Step 1: Run session-pause primitive
./agency/tools/session-pause --framing resumption --trigger "${REASON:-session-end}"

--framing resumption tells the tool: stop monitors (registry-driven SIGTERM), fire SessionEnd hooks naturally on process exit, archive prior handoff, emit new path. If framework code is dirty, the tool force-commits the handoff alone first (handoff_commit_sha set), then aborts on the framework-code gate. Handoff is always persisted.

Parse the emitted key=value output. Key fields: handoff_path, archived_previous_handoff, commit_sha, handoff_commit_sha, status.

On status=aborted, surface error_reason. If handoff_commit_sha is non-none the handoff is safe — run /quality-gate + /iteration-complete on the framework code and re-run /session-end.

Step 2: Author resumption-framed handoff

Write the handoff file at handoff_path. Frontmatter:

  • type: session
  • agent: <org>/<principal>/<agent>
  • date: <UTC>
  • trigger: session-end
  • branch: <current>
  • mode: resumption — REQUIRED. Tells /session-resume this is a fresh-session pickup.
  • next-action: — the concrete first step of the next session. Not a backlog.

Body: phase/iteration status, what was done, what's next, decisions/context the next session needs, open blockers. Frame for resumption — a future session will read this after a break.

Step 3: Verify handoff + report
./agency/tools/handoff read

Report: branch, last commit, handoff_path, "Handoff: written ✓", then:

Safe to /compact and/or /exit.
Failure modes
  • session-pause aborts on framework-code dirt: tool already force-committed the handoff. Run /quality-gate + /iteration-complete, then re-run /session-end.
  • Lock contention (exit 2): another PAUSE/PICKUP is running. Wait, retry.
  • Handoff write permission error (Step 2): session should not end without a handoff. Fix filesystem permission, retry.
What this does NOT do
  • Does not invoke /exit or /compact. It prepares; the user exits.
  • Does not stash. Resolve WIP first.
  • Does not run the quality gate. Framework code should have gone through QG at iteration boundaries.
  • Does not push. Push is /sync or /release.
Status

active (v2 refactored in session-lifecycle-refactor Phase 3 Iteration 3.3 — body collapsed from ~145 lines to ~60, now shells to session-pause). Paired with /session-resume, /compact-prepare.

Related
  • /session-resume — fresh-session PICKUP (opposite bookend).
  • /compact-prepare — mid-session PAUSE (continuation framing).
  • /compact-resume — post-compact PICKUP.
  • agency/tools/session-pause — primitive this skill shells to.
  • agency/tools/handoff — handoff read/write tool.

OFFENDERS WILL BE FED TO THE — CUTE — ATTACK KITTENS!

按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。
…