capture-desktop について
capture-desktopは、貼り付けまたはファイルで渡されたDesktopの会話を、ローカルの記録や成果物、プロジェクトの正本に振り分けるエージェントスキルです。claude.aiにAPIがないため、ユーザー提供の内容から始め、確認・同期・コミットまで案内します。
主な機能
- 01原文を重複排除して一時保存
- 02内容を4種類に分類
- 03判断や正本の編集を確認
- 04同期を確認して変更をコミット
活用シーン
- 01完了したDesktopセッションの記録
- 02会話の成果物を作業フォルダーに保存
- 03メモリーやwikiの更新案を作成
- 04正本の編集後に同期
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ gasserane/ personal-skills --skill capture-desktopインストール後、Claude Code で/capture-desktopを入力して読み込まれたか確認します。
詳細
デスクトップセッションの取り込み
scripts/check_desktop_sync.py のデバイス側に対応するものです。このスクリプトはデバイスからクラウドへの同期を管理します。このスキルはクラウドからデバイスへの取り込みを管理します。claude.ai には API がないため、取り込みは貼り付けによって行います。Ane が完了したデスクトップセッションを貼り付けると、このスキルが内容をディスク上の適切な場所に振り分けます。
Step 1 — 内容を受け取る
Ane にデスクトップの会話を貼り付けてもらうか、ファイルパスが提示された場合はそれを受け付けます。貼り付け内容が長い場合は、切り詰めを防ぐため、まず一時ファイルに書き込みます。
Step 2 — 文字起こしを準備する
ヘルパーを実行して、重複を除いた逐語的な文字起こしを準備します。
python scripts/capture_desktop.py stage --input <tempfile> --title "<short title>"
- 終了コード 0:文字起こしのパスが出力されます。続行します。
- 終了コード 3:
[DUP] already captured— このセッションは以前に取り込まれています。Ane に伝え、再振り分けを希望するという確認がない限り終了します。
文字起こしはローカルのみ(Git の追跡対象外、OneDrive によるバックアップ)です。準備された文字起こし自体が「全ログ」のバケットです。このバケットについて、それ以上の作業は不要です。
Step 3 — 内容を分類する
準備した文字起こしを読みます。実質的な内容を次の4つのバケットに分類します。
- 成果物 — Ane が作成したドキュメント、分析、表、下書き。
- 決定事項/ルール/教訓 — 確定した決定事項、フレームワークに関する判断、システムの動作に関するガイダンス、あなたの振る舞いに対するフィードバック。修正だけでなく、うまくいったことも記録します。文字起こしから Ane が称賛、再利用、または確定したアプローチは、記録する価値のある成功です。
feedbackメモとして(Why: と How to apply: を含めて)保存し、/improve-systemが修正点だけでなく、確認済みの成功も反映するようにします。 - プロジェクトナレッジの変更 — 正式な情報源(
mel_wiki/のページ、~/.claude/CLAUDE.md)に反映する編集。 - 全ログ — Step 2 ですでに準備済みです。作業は不要です。
バケットが空の場合は、その旨を伝えます。内容を埋めるために何かを作り出してはいけません。
Step 4 — 各バケットを振り分ける
成果物(自動保存)。 作業フォルダー内の保存先パスを提案し、Write ツールで保存して、要約にそのパスを記載します。対象ファイルが存在する場合は、mel_wiki/wiki/concepts/edit-preservation-protocol.md を適用します。
決定事項/ルール/教訓(項目ごとに確認)。 各項目について、保存先(memory ディレクトリ内のメモリファイル、wiki エントリ、またはフィードバックメモ)を提案し、書き込む正確な内容を提示します。書き込む前に、Ane から yes/no の回答を得ます。対象ファイルが存在する場合は、mel_wiki/wiki/concepts/edit-preservation-protocol.md を適用します。
プロジェクトナレッジの変更(項目ごとに確認)。 各項目について、正式な情報源に対する正確な編集内容を提案し、yes/no の回答を得ます。Edit ツールを使って、範囲を限定して変更を適用します。対象ファイルが存在する場合は、mel_wiki/wiki/concepts/edit-preservation-protocol.md を適用します。
mel_wiki/の編集:Step 5 で作業フォルダーのコミット対象にします。~/.claude/CLAUDE.mdの編集:変更を適用した後、次を実行してリポジトリ間でコミットします。bash ~/.claude-config-clone/scripts/sync-from-local.sh --auto "capture-desktop: <one-line reason>"。 これにより、現在の CLAUDE.md が claude-config クローンにコピーされ、整合性が調整されたうえでコミットおよびプッシュされます。変更がない場合は、何も出力せず終了コード 0 で終了します。
Step 5 — 最後の確認とコミット
正式な情報源(wiki または CLAUDE.md)を編集した場合は、同期チェックを実行して、デスクトッププロジェクトの再アップロードフラグを立てます。
python scripts/check_desktop_sync.py
検出された [DRIFT] があれば報告します。その後、作業フォルダーの変更(成果物と mel_wiki/ の編集のみ。文字起こしは Git の追跡対象外です)をコミットします。ステージングはファイル名を指定して行い、git add -A は決して使いません。
git add <deliverable paths> <mel_wiki paths>
git commit -m "feat(capture): desktop session <slug> — <what landed>"
git push
Step 6 — 報告
簡潔に要約して報告します。
CAPTURE-DESKTOP — <date>
Transcript: desktop-captures/<slug>/transcript.md (local)
Deliverables: <list or none>
Decisions/rules written: <list or none>
Canonical edits: <list or none> (CLAUDE.md pushed to claude-config: yes/no)
Sync check: <in sync / N drift flagged>
Commit: <short-SHA> pushed / nothing to commit