AgentSkillsCN

handover

会话交接——提交变更，输出框架反思，清除停止闸门。

SKILL.md
--- frontmatter
name: handover
category: instruction
description: Session handover - commit changes, output Framework Reflection, clear stop gate
allowed-tools: Bash, Read
version: 1.0.0
permalink: skills-handover

/handover Command Skill

Required session-end handover procedure. Invoked when stop hook blocks session.

Purpose

The handover skill ensures clean session closure by:

  1. •Verifying uncommitted changes are handled
  2. •Outputting structured Framework Reflection
  3. •Clearing the stop gate to allow session to end

Usage

code
/handover

This skill is mandatory before session end. The stop hook blocks until /handover is invoked.

Execution

Step 1: Check for Uncommitted Changes

bash
git status --porcelain

If there are uncommitted changes:

  • •Staged changes: Commit them now with descriptive message
  • •Unstaged changes: Stage relevant files and commit, or explicitly note why changes are not being committed

CRITICAL: Do not proceed to Step 2 with uncommitted work unless you explicitly document why (e.g., "Changes intentionally not committed because...")

Step 2: Output Framework Reflection

Output the following structure exactly (the stop hook validates this format):

markdown
## Framework Reflection

**Outcome**: success|partial|failure
**Accomplishments**: [What was completed this session]
**Friction points**: [Issues encountered, or "none"]

Field definitions:

  • •Outcome:
    • •success - All planned work completed
    • •partial - Some work completed, some deferred
    • •failure - Unable to complete primary objective
  • •Accomplishments: Brief bullet points of what was done
  • •Friction points: Framework issues, tool problems, blockers, or "none"

Step 3: Confirm Handover Complete

After outputting the reflection, state:

code
Handover complete. Session may now end.

This confirms to the user and the stop hook that the handover procedure completed.

Why This Skill Exists

Previously, the stop hook required inline Framework Reflection in any assistant message. This caused issues:

  • •Agents would forget the exact format
  • •The error message was verbose and noisy
  • •No structured procedure ensured commits happened before reflection

The handover skill:

  • •Encapsulates all session-end requirements in one place
  • •Ensures commits happen before reflection
  • •Provides clear, auditable session closure
  • •Allows the stop hook to be minimal ("invoke /handover")

Integration

  • •Stop hook: Blocks session end until this skill is invoked
  • •PostToolUse hook: Detects skill invocation and clears the stop gate
  • •Session state: Sets handover_skill_invoked flag when complete

Example

code
/handover

> git status --porcelain shows no changes

## Framework Reflection
**Outcome**: success
**Accomplishments**: Implemented user authentication, added tests, updated documentation
**Friction points**: none

Handover complete. Session may now end.