wrap について
wrapは、/reflectの実行、対象worktreeの整理、ユーザーへの/clearの案内を行う、セッション終了用のエージェントスキルです。マージ済みと未マージのブランチを区別し、整理結果を報告します。
主な機能
- 01整理前に/reflectを実行
- 02マージ済みの.worktrees項目を削除
- 03未マージworktreeを残して警告
- 04条件に応じて.branch-context.mdを処理
- 05整理結果を報告し/clearを案内
活用シーン
- 01コーディングセッションを終えて学びを整理
- 02マージ済みのセッションworktreeを安全に削除
- 03ユーザーによるセッションのクリアを準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ camacho/ ai-skills --skill wrapインストール後、Claude Code で/wrapを入力して読み込まれたか確認します。
詳細
Wrap
セッションの締めくくり:振り返り、worktree のクリーンアップ、/clear の準備をします。
1. 振り返り
Skill ツールから /reflect を呼び出します。次に進む前に、処理の完了を待ちます。
振り返りのロジックをインラインで記述しないでください。スキルを呼び出してください。スキルが MEMORY.md、Basic Memory vault、GitHub の Issue、計画の最終化、.last-reflect-ts を処理します。
2. セッションのクリーンアップ
振り返りの完了後、セッションの worktree をクリーンアップします。
REPO_ROOT="$(git rev-parse --show-toplevel)"
git -C "$REPO_ROOT" worktree list
.worktrees/ 配下の各エントリーについて(メインの worktree は対象外):
REPO_ROOT="$(git rev-parse --show-toplevel)"
BRANCH=$(git -C <worktree-path> rev-parse --abbrev-ref HEAD)
git -C "$REPO_ROOT" branch --merged main | grep -q "$BRANCH" && MERGED=true || MERGED=false
- マージ済み:
git -C "$REPO_ROOT" worktree remove <path>とgit -C "$REPO_ROOT" branch -d "$BRANCH"を実行します - 未マージ:ブランチ名を示して警告し、削除しないでください
.branch-context.md:"$REPO_ROOT/.branch-context.md" にファイルが存在し、振り返りで学びが統合されたことが確認できた場合は、削除します。振り返りで処理がスキップされた場合、または学びがなかったと報告された場合は、ファイルを残して次の警告を表示します:「.branch-context.md に未反映の学びが含まれている可能性があります。」
報告:
Session cleanup:
Removed: .worktrees/feat-foo (branch feat/foo, merged)
Kept: .worktrees/feat-baz (branch feat/baz, NOT merged)
Cleaned: .branch-context.md (learnings consolidated)
3. /clear の指示
セッションを終了しました。準備ができたら
/clearと入力してください。
/clear を呼び出さないでください。これはユーザーのみが入力できる組み込みコマンドです。/clear の実行後、SessionStart フックがキャッチアップの指示を自動的に挿入します。
よくある間違い
| 間違い | 修正方法 |
|---|---|
| 振り返りのロジックをインラインで記述する | Skill ツールから /reflect を呼び出します |
| 未マージの worktree を削除する | 警告のみにとどめます。未マージの作業は絶対に削除しないでください |
/clear を直接呼び出す | ユーザーに入力するよう伝えます。/clear は組み込みコマンドです |
| メインの worktree をクリーンアップする | .worktrees/* のエントリーのみをクリーンアップします |
| クリーンアップの報告を省略する | クリーンアップしたもの、残したものを必ず報告します |