Back to Skills

read-continue-here

pjt222
Updated 6 days ago
20 views
17
2
17
View on GitHub
Designaiautomation

About

This skill automatically detects and reads a `CONTINUE_HERE.md` file at session start to resume work from a previous interrupted session. It parses the structured handoff, confirms the resumption plan with the user, and cleans up after consumption. Use it when bootstrapping after an interruption or to set up automatic continuation detection via SessionStart hooks.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/read-continue-here

Copy and paste this command in Claude Code to install this skill

Documentation

讀續

讀續檔、承前任也。

  • 啟新會、根存 CONTINUE_HERE.md→用
  • SessionStart 鉤注入續脈→用
  • 啟身、察前會跡→用
  • 設自動續察(一次基設)→用

  • :項目錄(默當前)
  • :基設乎(鉤+CLAUDE.md)
  • :用畢刪乎(默是)

一:察讀

查根 CONTINUE_HERE.md

ls -la CONTINUE_HERE.md 2>/dev/null

無→雅退。

存→讀容。析五段:Objective、Completed、In Progress、Next Steps、Context。取首行時、枝。

得:檔讀、段析、前會態明。

敗:存而殘(缺段、空)→視為部分號,取所存、告用何缺。

二:察鮮

時與今較:

# File modification time
stat -c '%Y' CONTINUE_HERE.md 2>/dev/null || stat -f '%m' CONTINUE_HERE.md
# Current time
date +%s

分鮮:

  • (< 24 時、同枝):可直行
  • (> 24 時或異枝):先告用
  • (後存新提交):他人於交後動

察枝合:

git branch --show-current
git log --oneline --since="$(stat -c '%Y' CONTINUE_HERE.md | xargs -I{} date -d @{} --iso-8601=seconds)" 2>/dev/null

得:鮮分(鮮、舊、越)有據。

敗:非庫→略枝、提交察。獨憑檔頭時。

三:摘確續

簡示續態於用:

  • 「前會旨:[Objective]」
  • 「已畢:[摘]」
  • 「進行:[摘]」
  • 「擬下:[Next Steps 第一]」

舊或越→示據、問續否抑新起。

Next Steps 標 **[USER]**→明揭,需用決方行。

得:用確續計(或調)。代有明命。

敗:用云「新起」「忽彼檔」→應、不顧續脈。問刪檔以免後混。

四:行交

由 Next Steps 一始(或用所指):

  • 引 In Progress 解半態
  • 用 Context 避重蹈敗法
  • 視 Completed 已畢——非用問勿復驗

得:代行正務、有續檔導引。

敗:Next Steps 含糊、In Progress 不明→問用,勿猜。

五:清

交用畢、工已起→刪 CONTINUE_HERE.md:

rm CONTINUE_HERE.md

舊續檔致後會混。

得:檔除、根淨。

敗:用欲留(如會中參)→留之,告會末必刪以免次會復用。

六:設 SessionStart 鉤(可)

未設→立自讀於會啟。

建鉤本:

mkdir -p ~/.claude/hooks/continue-here

cat > ~/.claude/hooks/continue-here/read-continuation.sh << 'SCRIPT'
#!/bin/bash
# SessionStart hook: inject CONTINUE_HERE.md into session context
# OS-aware: works on native Linux, WSL, macOS, and Windows (Git Bash/MSYS)
set -uo pipefail

# --- Platform detection ---
detect_platform() {
  case "$(uname -s)" in
    Darwin) echo "mac" ;;
    Linux)
      if grep -qi microsoft /proc/version 2>/dev/null; then
        echo "wsl"
      else
        echo "linux"
      fi ;;
    MINGW*|MSYS*|CYGWIN*) echo "windows" ;;
    *) echo "unknown" ;;
  esac
}
PLATFORM=${PLATFORM:-$(detect_platform)}

CONTINUE_FILE="$PWD/CONTINUE_HERE.md"

if [ ! -f "$CONTINUE_FILE" ]; then
  exit 0
fi

# Strip CRLF (files on NTFS often have Windows line endings)
CONTENT=$(sed 's/\r$//' "$CONTINUE_FILE")

# JSON-escape: prefer jq, fall back to portable awk
if command -v jq >/dev/null 2>&1; then
  ESCAPED=$(printf '%s' "$CONTENT" | jq -Rsa .)
else
  ESCAPED=$(printf '%s' "$CONTENT" | awk '
    BEGIN { ORS=""; print "\"" }
    {
      gsub(/\\/, "\\\\")
      gsub(/"/, "\\\"")
      gsub(/\t/, "\\t")
      if (NR > 1) print "\\n"
      print
    }
    END { print "\"" }
  ')
fi

cat << EOF
{"hookSpecificOutput":{"sessionStartContext":{"additionalContext":$ESCAPED}}}
EOF
SCRIPT

chmod +x ~/.claude/hooks/continue-here/read-continuation.sh

~/.claude/settings.json SessionStart 鉤陣:

{
  "type": "command",
  "command": "~/.claude/hooks/continue-here/read-continuation.sh",
  "timeout": 5
}

得:鉤本存、可執、注於 settings.json。次會啟、若 CONTINUE_HERE.md 存→容入會脈。

敗:察 settings.json 編後仍合 JSON。手測鉤:cd /your/project && ~/.claude/hooks/continue-here/read-continuation.sh。本退用 awk 若無 jq,故 jq 宜而非必。

七:增 CLAUDE.md 命(可)

於項 CLAUDE.md 增簡命使 Claude 解檔旨:

## Session Continuity

If `CONTINUE_HERE.md` exists in the project root, read it at session start. It contains a structured handoff from a prior session: objective, completed work, in-progress state, next steps, and context. Act on it — acknowledge the continuation, summarize prior state, and propose resuming from the Next Steps section. If the file is older than 24 hours, flag this to the user before proceeding. After the handoff is consumed, the file can be deleted.

得:CLAUDE.md 含命。後會雖無鉤亦讀行 CONTINUE_HERE.md。

敗:CLAUDE.md 不存→建之,唯此段。檔過長→置近頂以免截斷。

  • CONTINUE_HERE.md 已察(或缺已雅理)
  • 鮮已察(時、枝、後提交)
  • 續計示用、用已確
  • 工自正 Next Steps 始
  • 用畢檔已清
  • (可)SessionStart 鉤本存可執
  • (可)CLAUDE.md 含續命

  • 未確而行:必示續計於用。雖鮮,意或變
  • 盲信舊檔:> 24 時或異枝→建議非命。必察鮮
  • 忽 Context:最值常為敗法。略則重蹈死路
  • 忘清:用畢留 CONTINUE_HERE.md→次會混、復行之
  • 疑 Completed:非用問勿復畢工。信前會察

  • write-continue-here — 補:會末書續檔
  • bootstrap-agent-identity — 全身重構,含續察為一啟發
  • manage-memory — 跨會持知(補此瞬交)
  • write-claude-md — 項命,可選續導所居

GitHub Repository

pjt222/agent-almanac
Path: i18n/wenyan-ultra/skills/read-continue-here
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

executing-plans

Design

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

View skill

requesting-code-review

Design

This skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.

View skill

connect-mcp-server

Design

This skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.

View skill

web-cli-teleport

Design

This skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.

View skill