菜单
Analyzes the session context and generates focused instructions for pi's /compact command so that important information survives compaction. Use when the context window is getting tight or when you want to tidy up the session.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/ushironoko/dotfiles --skill smart-compact命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
Start implementation work with worktree isolation and cross-session file conflict avoidance. Use this skill when beginning any non-trivial code change: after planning, when creating a new branch, implementing features, fixing bugs across multiple files, or refactoring. Also use when the user mentions worktree, bit issue, session coordination, or parallel work.
Proactively recall or update durable project knowledge through pi-harness structured memory tools. Parent agents use this without waiting for a user request when verified lasting facts, decisions, constraints, feedback, or references emerge, and at task, PR, checkpoint, compaction, pause, and session-end boundaries.
Persist mid-session progress (plan refinements, task progress notes, scope changes, decisions, blockers) to the bit issues created by start-work. Use as a checkpoint before context compaction, after meaningful progress (multiple tasks done, plan refined, scope shifted), before pausing work, or when the user mentions 'save session', 'snapshot', 'checkpoint', 'update bit issue', or 'persist progress'.
| name | smart-compact |
| description | Analyzes the session context and generates focused instructions for pi's /compact command so that important information survives compaction. Use when the context window is getting tight or when you want to tidy up the session. |
pi fork of the Claude Code smart-compact skill. Analyze the session
context and generate /compact instructions aligned with the user's
intent. pi's /compact [instructions] accepts optional instructions that
focus the summary — this skill produces those instructions.
/compact [instructions] — the instructions focus the
LLM-generated summary of older messages.contextWindow - reserveTokens (default reserve: 16384). The most recent
keepRecentTokens (default: 20000) are kept verbatim; only older
messages are summarized. Auto-compaction always uses the default summary
prompt — custom instructions only apply to manual /compact, which is
why running this skill before the threshold hits keeps you in control
of what is preserved.~/.pi/agent/settings.json or <project>/.pi/settings.json,
under the compaction key (enabled, reserveTokens, keepRecentTokens).<read-files> / <modified-files> lists tracked cumulatively
across compactions). Instructions steer what lands in those sections.Analyze the whole conversation history and extract:
Show the analysis result as a concise bullet list.
Based on the Phase 1 analysis, use pi-harness's Claude-compatible
AskUserQuestion tool with multiSelect: true to ask the user what to keep.
If interactive UI is unavailable, ask in plain conversation with a numbered
list and state that multiple selections are fine.
Rules for generating the choices:
Question template:
Which information should compaction preserve with priority? (multiple selections OK)
Example choices (generated dynamically from the session):
1. Implementation progress and remaining work for <specific task>
2. Error-investigation context around <file name>
3. Design decisions and rationale for <technology>
4. API spec and type definitions for <feature>
Important: derive the choices from the session analysis — never use preset generic choices.
Based on the user's answers, generate the instructions to pass to /compact.
Generation guidelines:
keepRecentTokens
verbatim anyway, so spend the instructions on earlier decisions and
findings that would otherwise be summarized awayOutput format:
以下の情報を重点的に保持してコンテキストを圧縮してください：
1. [保持項目1の具体的な内容]
2. [保持項目2の具体的な内容]
3. [保持項目3の具体的な内容]
特に以下は正確に保持してください：
- [重要な固有名詞、パス、コマンドなど]
Present the generated instructions to the user:
Copy and run the following command:
/compact <generated instructions>
> /smart-compact
=== Phase 1: Session context analysis ===
Main contents of this session:
- Implementing the MCPMerger feature of the dotfiles CLI
- Fixing a deep-merge bug involving defu
- Adding tests in tests/core/mcp-merger.test.ts
=== Phase 2: Interview ===
Which information should compaction preserve with priority? (multiple selections OK)
1. Investigation history and fix for the MCPMerger defu-integration bug
2. Added test cases in mcp-merger.test.ts and their intent
3. claude.json merge spec (key-preservation rules)
4. Other
> user answers: 1 and 3
=== Phase 3: Instruction generation ===
Generated instructions:
---
以下の情報を重点的に保持してコンテキストを圧縮してください：
1. MCPMergerでdefuを使ったmcpServersマージ時に、既存キーが上書きされるバグの原因と修正内容（src/core/mcp-merger.ts の mergeConfig 関数）
2. claude.jsonのマージ仕様：mcpServersキーのみマージし、apiKey等の他キーはdefu経由で保持する設計判断
特に以下は正確に保持してください：
- src/core/mcp-merger.ts, tests/core/mcp-merger.test.ts のファイルパス
- defu の非破壊マージ挙動（ターゲット側の値が優先される仕様）
---
Copy and run the following command:
/compact 以下の情報を重点的に保持してコンテキストを圧縮してください：...
/compact is a pi built-in command that only the user can run — same
limitation as in Claude Code: the skill generates the instructions, and
the user copies and executes the command manuallycontextWindow - reserveTokens; run it before auto-compaction fires,
since auto-compaction cannot take custom instructionsreserveTokens /
keepRecentTokens can be tuned in the settings files listed above