gsd:resume-work

Agent Skills › davepoon/buildwithclaude › gsd:resume-work

gsd:resume-work

GitHub

从上一会话恢复项目上下文，通过读取状态文件和交接记录还原进度、决策及下一步行动。提供具体操作选项引导用户继续工作，并在完成后自动清理交接文件以维持环境整洁。

plugins/gsd/skills/resume-work/SKILL.md davepoon/buildwithclaude

Trigger Scenarios

用户希望从中断处恢复工作需要查看当前项目状态和下一步行动建议

Install

npx skills add davepoon/buildwithclaude --skill gsd:resume-work -g -y

More Options

Non-standard path

npx skills add https://github.com/davepoon/buildwithclaude/tree/main/plugins/gsd/skills/resume-work -g -y

Use without installing

npx skills use davepoon/buildwithclaude@gsd:resume-work

指定 Agent (Claude Code)

npx skills add davepoon/buildwithclaude --skill gsd:resume-work -a claude-code -g -y

安装 repo 全部 skill

npx skills add davepoon/buildwithclaude --all -g -y

预览 repo 内 skill

npx skills add davepoon/buildwithclaude --list

SKILL.md

Frontmatter

{
    "name": "gsd:resume-work",
    "description": "Resume work from previous session with full context restoration",
    "allowed-tools": [
        "Read",
        "Bash",
        "Write",
        "AskUserQuestion",
        "SlashCommand"
    ]
}

Restore complete project context from a previous session — handling both manual pause (from `/gsd:pause-work`) and auto-compact (from the PreCompact hook) handoffs identically.

Detect handoff state. Check for .planning/HANDOFF.json via Read tool. If missing, the session has no handoff — announce "No handoff found" and proceed to normal /gsd:progress routing.
Load STATE.md. Read .planning/STATE.md to restore the big-picture project position. If missing, reconstruct from .planning/ROADMAP.md and the latest phase directory's SUMMARY.md files; if reconstruction fails, surface the error and stop.
Read the handoff. Parse .planning/HANDOFF.json. Extract phase, plan, task, status, source, uncommitted_files, decisions, context_notes, next_action. Per HANDOFF schema, all fields are always present (empty arrays / null for unset).
Present project status. Emit a compact status block covering:
- Milestone + percent complete (from STATE.md frontmatter progress.percent).
- Current phase name and number.
- Plan / task position from the handoff.
- Handoff source (manual-pause vs auto-compact) and timestamp.
- Top 3 decisions and any blockers from the handoff.
- Uncommitted files summary.
- The next_action string verbatim — it's the resumption hint.
Route to the next action. Offer 1-3 concrete options based on handoff state. Common patterns:
- If task was mid-execute: offer /gsd:execute-phase with the current phase.
- If phase is at plan boundary: offer /gsd:plan-phase or /gsd:execute-phase for the next phase.
- If there are uncommitted files that look in-progress: call attention to them before offering continuation.
Clean up the handoff (LIFE-01). After routing — once steps 1-5 have completed without error — remove the handoff file:
```
node "${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/cache/gsd-plugin/current}/bin/gsd-tools.cjs" checkpoint --clear
```
If the command is unavailable for any reason, fall back to direct removal:
```
rm -f .planning/HANDOFF.json
```
Do not abort the resume if cleanup fails — it's hygiene, not correctness. The next session's SessionStart will overwrite a stale handoff anyway (per D-05 from Phase 4: latest snapshot wins).

- Step 6 runs **last**, after all context is loaded and the user has been shown status. A failed/aborted resume (steps 1-5 error out) leaves HANDOFF.json on disk for recovery (per D-08). - If `HANDOFF.json` is absent in step 1, skip everything — don't attempt to clean up what isn't there. `checkpoint --clear` is idempotent but unnecessary work. - The skill is the single owner of HANDOFF.json deletion. The SessionStart hook must NOT delete — it only detects (per D-10).

Version History

502fc01 Current 2026-07-05 15:14

Metadata

Files: 0
Version: 502fc01
Hash: 2e79a19e
Indexed: 2026-07-05 15:14

gsd:resume-work

gsd:resume-work

Trigger Scenarios

Install

SKILL.md

Version History

Same Skill Collection