mk-session-continuation
Persists and restores mid-session workflow progress across context resets. Use when resuming workflows, saving state, or handling context compaction. Triggers on: handoff, save state, resume workflow.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 16
- Forks
- 3
01 前言 Front Matter
- name
- mk-session-continuation
- description
- Persists and restores mid-session workflow progress across context resets. Use when resuming workflows, saving state, or handling context compaction. Triggers on: handoff, save state, resume workflow.
02 资源文件 2
- 参考文档references/handoff-flow.md1.4 KB
- 参考文档references/resume-and-state.md2.0 KB
03 SKILL.md 正文
<!-- Split for progressive disclosure (checklist #11, #14): 427 → ~60 lines -->
Session Continuation
Manage workflow state across sessions with handoff and resume.
When to Use
- Runtime reports that the session is approaching its context-warning threshold
- User says "handoff", "save", "pause"
- User says "resume" + workflow ID
- Session ending with incomplete workflow
- Incomplete workflow from previous session
Plan State
Saved workflow state lives in .codex/logs/workflows/; the active plan is resolved
from .meowkit/state/active-plan.json or by scanning tasks/plans/. Nothing is carried
between sessions in the environment.
Process
- Detect trigger — token limit, user command, or session ending
- If handoff — load
references/handoff-flow.md, execute save + summary - If resume — load
references/resume-and-state.md, execute load + restore + continue - If list — show all saved workflows from
.codex/logs/workflows/
References
| Reference | When to load | Content |
|---|---|---|
| handoff-flow.md | On handoff/save trigger | State save format, summary generation |
| resume-and-state.md | On resume trigger | Resume steps, state management, error handling, TOON format |
Quick Commands
workflow:handoff → Save state + get resume instructions
workflow:resume AUTH-123 → Load state + continue from last phase
workflow:list → Show all saved workflows
Gotchas
- Stale handoff after codebase changes: Saved state references files that were renamed or deleted → Validate all file paths in handoff state before resuming
- TOON corruption on concurrent sessions: Two agents writing state simultaneously → Use file locking or session-scoped state files
04 同仓库更多 Skills
mk-worktree
Manages git worktrees for parallel agent isolation: creates parallel/{name}-{timestamp} branches, merges with conflict detection. NOT for user feature branches (use git worktree directly).
mk-workflow-orchestrator
Auto-invoked 7-phase workflow for complex-feature intent; fasttrack mode for pre-approved specs. NOT for explicit single tasks (mk:cook), green-field builds (mk:autobuild), or simple fixes (mk:fix).
mk-web-to-markdown
Fetch a URL and return clean markdown, for arbitrary external pages (blog, RFC, GitHub issue, vendor doc) not covered by mk:docs-finder. Static-only by default; opt-in JS rendering available.
mk-vulnerability-scanner
Vulnerability analysis: OWASP Top 10, current threat landscape, supply chain security, attack surface mapping, risk prioritization. Use for security audits. NOT for STRIDE/CSO infra audits (mk:cso).
mk-vue
Vue 3 authoring/review: components, composables, reactivity, Pinia, Pinia Colada, file routing, forms. Composition API + script setup. Auto-activates on .vue files. Deep review: mk:vue-best-practices.
mk-vue-testing-best-practices
Vue 3 testing best-practices review: Vitest + Vue Test Utils for components, composables, Pinia, Router, async/Suspense, forms, a11y, plus Playwright E2E strategy. Advisory only.