MCP HubMCP Hub
Retour aux compétences

read-continue-here

pjt222
Mis à jour Yesterday
4 vues
17
2
17
Voir sur GitHub
Designaiautomation

À propos

Cette compétence détecte et traite automatiquement un fichier `CONTINUE_HERE.md` au démarrage de la session pour reprendre le travail d'une session précédente interrompue. Elle analyse la transmission structurée, confirme le plan de reprise avec l'utilisateur, et nettoie le fichier après utilisation. Utilisez-la pour redémarrer après une interruption ou pour configurer la détection automatique de continuation via les hooks SessionStart.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/read-continue-here

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

讀續

讀承接之文,續前會所未竟者。

用時

  • 新會初啟,項目根有 CONTINUE_HERE.md 乃用
  • SessionStart 鈎注承接脈絡之後乃用
  • 啟身識而察前會之遺乃用
  • 為項目立自動察續(一次之基建)乃用

  • 必要:項目之所(默為當前工作之所)
  • 可選:是否設基建(SessionStart 鈎與 CLAUDE.md 之諭)
  • 可選:用畢是否刪之(默:然)

第一步:察而讀承接之文

於項目之根察 CONTINUE_HERE.md

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

若闕,安然而退——無可續者也。

若存,讀其內。析五段:目、已畢、進中、下步、脈絡。自首行取時與枝。

得:文已讀,其段已析為前會狀態之清明心象。

敗則:若文存而殘(缺段、空),視為偏信——取其有者,缺者告之於用者。

第二步:察其新陳

文之時與當下相較:

# 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

得:新陳之察附分類(新、陳、被代)與佐證。

敗則:若不在 git 庫,略枝與提交之察。獨依文首之時。

第三步:總而請續之命

簡而陳前會之狀於用者:

  • 「前會之目:[目]」
  • 「已畢:[摘]」
  • 「進中:[摘]」
  • 「擬之下步:[下步之第一]」

若新陳為「陳」或「被代」,陳其證,問是否承之或新起。

若下步有標 **[USER]** 者,明列之——須用者決方可進。

得:用者承續之計,或有調。代理有清明之命以續。

敗則:若用者云「新起」或「忽其文」,受之而進,不用承接之脈。請刪之以防後惑。

第四步:行其承接

自下步之第一行始(或用者所指之處):

  • 參進中以解部分之狀
  • 用脈絡段以避再試已敗之徑
  • 視已畢者為畢——勿再驗,除非用者請

得:代理勤於正事,由承接之文所明。

敗則:若下步含混或進中之狀不清,請用者明之,勿臆斷。

第五步:清理

承接既用而事已起,刪 CONTINUE_HERE.md:

rm CONTINUE_HERE.md

陳承接之文,後會生惑。

得:文已去。項目根已淨。

敗則:若用者欲存之(如會中為參),留之,然告會終前宜刪,勿令下會復用。

第六步:設 SessionStart 鈎(可選)

若未設,立會啟自讀 CONTINUE_HERE.md 之機。

立鈎之文:

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。文於無 jq 時退用 awk,故 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 含此諭。後會雖無 SessionStart 鈎亦可讀而行 CONTINUE_HERE.md。

敗則:若 CLAUDE.md 不存,立之而獨含此段。若文過長,置諭於前以免被截。

  • CONTINUE_HERE.md 已察(或無亦安處)
  • 新陳已察(時、枝、承接後之提交)
  • 續之計已陳於用者並得其承
  • 事自正確之下步而起
  • 文用畢已清
  • (可選)SessionStart 鈎之文已存且可執
  • (可選)CLAUDE.md 含會續之諭

  • 未承而行:必陳續之計於用者。文雖新,其意或已改。
  • 盲信陳文:逾 24 時或異枝之承接文乃議,非命。必察新陳。
  • 忽脈絡段:文之最貴者,常為已敗之徑。略此致再試死路。
  • 忘清理:用畢留 CONTINUE_HERE.md,下會生惑而再試行之。
  • 視已畢為未驗:除非用者明請,勿復做已畢之事。信前會之斷。

  • write-continue-here — 其補:會終書承接之文
  • bootstrap-agent-identity — 全身識重建,含承接之察為一啟發
  • manage-memory — 跨會持久之知(補此一過之承)
  • write-claude-md — 項目之諭,可選之續之指南所在

Dépôt GitHub

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

Compétences associées

executing-plans

Design

Utilisez 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.

Voir la compétence

requesting-code-review

Design

Cette 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.

Voir la compétence

connect-mcp-server

Design

Cette 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.

Voir la compétence

web-cli-teleport

Design

Cette 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.

Voir la compétence