session-resume

Estrelas0

Forks0

Atualizado9 de julho de 2026 às 13:15

Claude Code / Codex / opencode 세션 기록을 열어 대화 흐름을 추출·요약한다. 다른 도구(또는 주간 한도 컷)에서 끊긴 작업을 현재 세션에서 이어하거나, 과거 세션이 무엇을 했는지 파악할 때 사용. "claude --resume <id>", "codex 세션 이어서", "opencode 세션 열어줘", "이전 세션 이어서", "저번 세션 뭐했지", "세션 기록 봐줘" 요청 시 사용.

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Fonte

nextain

nextain/naia-adk

Abrir repositório GitHub Ver repositórios do creator

Download

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Desenvolvedores de softwareInformática e Matemática·SOC 15-1252

Explorador de arquivos

3 arquivos

SKILL.md

readonly

name	session-resume
description	Claude Code / Codex / opencode 세션 기록을 열어 대화 흐름을 추출·요약한다. 다른 도구(또는 주간 한도 컷)에서 끊긴 작업을 현재 세션에서 이어하거나, 과거 세션이 무엇을 했는지 파악할 때 사용. "claude --resume <id>", "codex 세션 이어서", "opencode 세션 열어줘", "이전 세션 이어서", "저번 세션 뭐했지", "세션 기록 봐줘" 요청 시 사용.
argument-hint	[session-id \| 경로] [--tool claude\|codex\|opencode] [--cwd 경로] [--list]

세션 재개 (Session Resume)

목적

다른 AI 코딩 도구(Claude Code / Codex / opencode)에서 진행하던 세션을 현재 세션에서 열어보고 이어한다. 특히 주간 사용 한도로 중간에 끊긴 세션을 복구하거나, 어떤 도구에서 무슨 작업을 했는지 빠르게 파악할 때 쓴다.

지원 도구 / 세션 저장소

도구	저장소	식별자
Claude Code	`~/.claude/projects/<인코딩된-cwd>/<uuid>.jsonl`	uuid (예: `25f5abcc-...`)
Codex	`~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl`	`rollout-...` 파일명 또는 uuid
opencode	`opencode export` (SQLite `~/.local/share/opencode/opencode.db`)	`ses_...`

인코딩된-cwd 규칙: D:\alpha-adk → D--alpha-adk (:와 \ 각각 -).

핵심 스크립트

parse-session.js 가 세 포맷을 공통 digest로 정규화한다.

# 최근 세션 목록 보기 (세 도구 통합, 최신순)
node .agents/skills/session-resume/parse-session.js --list

# 특정 세션 열기 (도구 자동 감지)
node .agents/skills/session-resume/parse-session.js <id|경로>

# 도구 명시 / cwd 제한
node .agents/skills/session-resume/parse-session.js <id> --tool claude --cwd "D:\alpha-adk"

# 마지막 N턴만 (큰 세션 요약용)
node .agents/skills/session-resume/parse-session.js <id> --last 60

출력: stdout은 ASCII 안전(경로/카운트/도구/interrupt 종류만). 본문(한국어 포함)은 UTF-8 digest 파일로 나가며, digest=<경로> 라인에서 위치를 읽는다.

워크플로우

Step 1: 세션 식별

사용자가 id/uuid/ses_/rollout/경로를 줬으면 그대로 Step 2.
id 없이 "이전 세션"만 말하면 --list 로 최근 목록을 보여주고 가장 최근 또는 제목이 맞는 것을 고른다. (사용자에게 목록을 보여 선택하게 하거나, 맥락상 명확하면 최근 것.)

Step 2: 파싱

parse-session.js 실행 후 stdout의 digest=<경로> 라인에서 digest 파일 경로를 얻는다.

Step 3: digest 읽기

Read 도구로 digest 파일을 읽는다. 핵심 섹션:

interrupt — QUOTA(한도 컷) / EXITED(정상 종료) / COMPACTED / MID-ACTION / NORMAL
Conversation flow — USER / AI / TOOL 턴 시퀀스 (요약됨)
Last user intent — 마지막 사용자 요청 3개
Suggested next step — 중단 지점 기반 재개 제안

Step 4: 사용자에게 요약 + 이어할지 확인

2~4문장으로: 무슨 작업이 진행됐고, 어디서/왜 끊겼고(한도/에러/정상), 다음 단계가 뭔지. 그리고 "이 세션을 여기서 이어서 진행할까요?" 로 확인.

주의: 세션 기록은 "읽기 전용 참고자료"다. 실제 진실 SoT는 각 프로젝트의 코드·컨텍스트. digest가 "코드를 변경했다"고 해도 워킹트리를 직접 확인하고 믿을 만한 사실만 이어받는다 (AI 자가-선언 금지 원칙).

Step 5: 이어서 작업

사용자가 승인하면, digest의 "Last user intent" + 현재 워킹트리 상태를 결합해 다음 액션을 실행한다. (다른 도구의 세션이므로, 현재 도구의 컨텍스트 규칙을 따른다.)

인터럽트 종류 해석

interrupt	의미	재개 방침
`QUOTA`	주간/사용 한도로 컷	마지막 사용자 요청부터 재개
`MID-ACTION`	도구 호출 도중 중단	진행 중이던 변경이 완료됐는지 먼저 확인
`MAYBE-ERROR`	마지막 AI 응답이 에러/불능	원인 파악 후 재시도
`COMPACTED`	컨텍스트 압축 발생	요약 기준 재정립
`EXITED`	사용자 `/exit` 정상 종료	새 요청인지 이어하기인지 확인
`NORMAL`	정상 턴 종료	일반적 이어하기

Key Files

파일	용도
`parse-session.js`	세 포맷 통합 파서 (node, 외부 의존성 무)

참고

node(node 18+) 필요. opencode 세션 읽기엔 opencode CLI가 PATH에 있어야 한다 (스크립트가 npm 글로벌 위치를 자동 탐지).
opencode는 세션을 SQLite에 저장하므로 JSONL이 아니지만 opencode export 로 JSON을 얻어 동일 digest로 정규화한다.
Codex의 developer 역할(permissions/skills 지시문)은 노이즈라 자동 필터링한다.
Claude의 <command-name>, <task-notification>, <local-command-*> 도 user-role 이지만 노이즈라 필터링한다(실제 사용자 입력만 USER 턴으로).

Mais deste repositório

mesmo repositório

manage-discord-sessions

nextain/naia-adk

Configure, observe, and recover Discord AI jobs from the ADK workspace with either Codex or Claude. Use for Discord setup, background-job status, live activity, stalled-job diagnosis, reboot recovery, idle rotation, or session history.

2026-07-310

manage-discord-sessions

nextain/naia-adk

Codex 또는 Claude로 실행되는 Discord 백그라운드 작업의 설정·상태·실시간 활동·재부팅 복구를 ADK 워크스페이스에서 관리합니다.

2026-07-310

manage-skills

nextain/naia-adk

세션 변경사항을 분석해 verify-* 스킬 드리프트를 탐지하고 자동 생성/업데이트합니다. issue-driven-development Sync 단계, 새 패턴/규칙 도입 후, PR 전 검증 스킬 커버리지 확인 시 반드시 사용. /manage-skills로 호출.

2026-07-310

verify-request-contract

nextain/naia-adk

원요청 무결성과 세션 바인딩 하네스의 원문 해시체인, 완전 범위 추적, 서명 권한, 2회 Clean 결박, Claude Code/Codex 등록·동등성을 결정론으로 검증합니다. request-contract·session-inject 코어/어댑터·설정·스키마·review-pass를 수정한 뒤, Review/Post-test Review 및 커밋 전에 반드시 사용합니다.

2026-07-310

verify-implementation

nextain/naia-adk

등록된 모든 verify-* 스킬을 순차 실행해 통합 검증 보고서를 생성합니다. 기능 구현 후, PR 전, 코드 리뷰 시, issue-driven-development Review/Post-test Review 단계마다 반드시 사용. /verify-implementation으로 호출.

2026-07-310

verify-product-preservation

nextain/naia-adk

기존 제품의 경로·진입점·내비게이션·사용자 여정·운영 표면이 기능 추가 뒤에도 유지되는지 기준 버전과 보존 계약으로 검증합니다. 기존 프로젝트의 기능 추가·통합·리팩터링 후, planning/integration 리뷰와 release 전에 반드시 사용합니다.

2026-07-310

name	session-resume
description	Claude Code / Codex / opencode 세션 기록을 열어 대화 흐름을 추출·요약한다. 다른 도구(또는 주간 한도 컷)에서 끊긴 작업을 현재 세션에서 이어하거나, 과거 세션이 무엇을 했는지 파악할 때 사용. "claude --resume <id>", "codex 세션 이어서", "opencode 세션 열어줘", "이전 세션 이어서", "저번 세션 뭐했지", "세션 기록 봐줘" 요청 시 사용.
argument-hint	[session-id \| 경로] [--tool claude\|codex\|opencode] [--cwd 경로] [--list]

세션 재개 (Session Resume)

목적

지원 도구 / 세션 저장소

도구	저장소	식별자
Claude Code	`~/.claude/projects/<인코딩된-cwd>/<uuid>.jsonl`	uuid (예: `25f5abcc-...`)
Codex	`~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl`	`rollout-...` 파일명 또는 uuid
opencode	`opencode export` (SQLite `~/.local/share/opencode/opencode.db`)	`ses_...`

인코딩된-cwd 규칙: D:\alpha-adk → D--alpha-adk (:와 \ 각각 -).

핵심 스크립트

parse-session.js 가 세 포맷을 공통 digest로 정규화한다.

# 최근 세션 목록 보기 (세 도구 통합, 최신순)
node .agents/skills/session-resume/parse-session.js --list

# 특정 세션 열기 (도구 자동 감지)
node .agents/skills/session-resume/parse-session.js <id|경로>

# 도구 명시 / cwd 제한
node .agents/skills/session-resume/parse-session.js <id> --tool claude --cwd "D:\alpha-adk"

# 마지막 N턴만 (큰 세션 요약용)
node .agents/skills/session-resume/parse-session.js <id> --last 60

출력: stdout은 ASCII 안전(경로/카운트/도구/interrupt 종류만). 본문(한국어 포함)은 UTF-8 digest 파일로 나가며, digest=<경로> 라인에서 위치를 읽는다.

워크플로우

Step 1: 세션 식별

사용자가 id/uuid/ses_/rollout/경로를 줬으면 그대로 Step 2.
id 없이 "이전 세션"만 말하면 --list 로 최근 목록을 보여주고 가장 최근 또는 제목이 맞는 것을 고른다. (사용자에게 목록을 보여 선택하게 하거나, 맥락상 명확하면 최근 것.)

Step 2: 파싱

parse-session.js 실행 후 stdout의 digest=<경로> 라인에서 digest 파일 경로를 얻는다.

Step 3: digest 읽기

Read 도구로 digest 파일을 읽는다. 핵심 섹션:

interrupt — QUOTA(한도 컷) / EXITED(정상 종료) / COMPACTED / MID-ACTION / NORMAL
Conversation flow — USER / AI / TOOL 턴 시퀀스 (요약됨)
Last user intent — 마지막 사용자 요청 3개
Suggested next step — 중단 지점 기반 재개 제안

Step 4: 사용자에게 요약 + 이어할지 확인

2~4문장으로: 무슨 작업이 진행됐고, 어디서/왜 끊겼고(한도/에러/정상), 다음 단계가 뭔지. 그리고 "이 세션을 여기서 이어서 진행할까요?" 로 확인.

Step 5: 이어서 작업

인터럽트 종류 해석

interrupt	의미	재개 방침
`QUOTA`	주간/사용 한도로 컷	마지막 사용자 요청부터 재개
`MID-ACTION`	도구 호출 도중 중단	진행 중이던 변경이 완료됐는지 먼저 확인
`MAYBE-ERROR`	마지막 AI 응답이 에러/불능	원인 파악 후 재시도
`COMPACTED`	컨텍스트 압축 발생	요약 기준 재정립
`EXITED`	사용자 `/exit` 정상 종료	새 요청인지 이어하기인지 확인
`NORMAL`	정상 턴 종료	일반적 이어하기

Key Files

파일	용도
`parse-session.js`	세 포맷 통합 파서 (node, 외부 의존성 무)

참고

node(node 18+) 필요. opencode 세션 읽기엔 opencode CLI가 PATH에 있어야 한다 (스크립트가 npm 글로벌 위치를 자동 탐지).
opencode는 세션을 SQLite에 저장하므로 JSONL이 아니지만 opencode export 로 JSON을 얻어 동일 digest로 정규화한다.
Codex의 developer 역할(permissions/skills 지시문)은 노이즈라 자동 필터링한다.
Claude의 <command-name>, <task-notification>, <local-command-*> 도 user-role 이지만 노이즈라 필터링한다(실제 사용자 입력만 USER 턴으로).