read-continue-here
À propos
Cette compétence détecte et lit automatiquement un fichier `CONTINUE_HERE.md` au démarrage de la session pour reprendre le travail d'une session précédemment interrompue. Elle analyse la transmission structurée, confirme le plan de reprise avec l'utilisateur et nettoie après consommation. Utilisez-la lors de l'amorçage après une interruption ou pour configurer la détection automatique de continuation via les hooks SessionStart.
Installation rapide
Claude Code
Recommandénpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/read-continue-hereCopiez et collez cette commande dans Claude Code pour installer cette compétence
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— 項命,可選續導所居
Dépôt GitHub
Compétences associées
executing-plans
DesignUtilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.
requesting-code-review
DesignCette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.
connect-mcp-server
DesignCette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.
web-cli-teleport
DesignCette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.
