AgentSkillsCN

shelve

以结构化的交接状态,做好阶段性工作交接

SKILL.md
--- frontmatter
name: shelve
description: Checkpoint work with structured handoff state
allowed-tools: Read, Write, Bash

Checkpoint current work with a structured handoff state.

Instructions

  1. Assess current work state:
    • What task or plan is currently in progress?
    • What files have been modified? (git diff --name-only)
    • What's the current git branch?
  2. Record the current Claude Code session ID for potential --resume on pickup.
  3. Create a structured handoff state with these sections:
    • Completed Steps -- what's done
    • Current Step -- what was in progress
    • Files Modified -- list of changed files
    • Key Decisions -- design choices made during this session
    • Known Issues -- problems the next agent should know about
    • Next Actions -- where to pick up
    • Session ID -- current session ID (for --resume)
  4. If working on a task file (in docs/spec/.llm/tasks/):
    • Write the handoff state to the task's ## Handoff State section
    • Commit WIP changes on the task branch
    • Move the task back to docs/spec/.llm/tasks/backlog/
  5. If working on a plan file (in docs/spec/.llm/plans/):
    • Update the plan's Progress Log with the handoff state
    • Commit WIP changes
  6. Update docs/spec/.llm/PROGRESS.md with any learnings from this session.
  7. Confirm the shelve to the user with a summary of what was saved.

$ARGUMENTS