save

セッション保存

Codex との互換性

Codex でこのスキルを実行する場合は、作業に着手する前に Claude Code 専用のプリミティブを変換します：AskUserQuestion -> chat/request_user_input、TodoWrite -> update_plan、Task/TaskCreate/TeamCreate/SendMessage -> 利用可能かつ許可されている場合は spawn_agent/send_input/wait_agent、EnterPlanMode/ExitPlanMode -> 簡潔なチャットでの計画と明示的な承認。 Read/Write/Edit/Bash/WebSearch/WebFetch は Codex のファイル／シェル／ウェブツールに対応させ、タスクで Claude Code が明示的に対象とされていない限り、~/.claude/... パスを ~/.agents/... または ~/.codex/... に対応させます。

Cursor との互換性

Cursor Agent でこのスキルを実行する場合は、作業に着手する前に Claude Code 専用のプリミティブを変換します：AskUserQuestion -> AskQuestion、TodoWrite -> Cursor の TodoWrite または同等のチェックリスト、Task/TaskCreate/TeamCreate/SendMessage/マルチエージェントのフロー -> 許可されている場合は Cursor の Task（サブエージェント）、並列 Task、または run_in_background（TeamCreate/SendMessage に完全に一致するものがない場合があります）、EnterPlanMode/ExitPlanMode -> Plan モード（SwitchMode / CreatePlan）と明示的なユーザー承認。 Read/Write/Edit/StrReplace/Bash/ウェブ／検索／MCP は Cursor Composer または Agent の同等機能に対応させます。mcp__server__tool 形式の MCP 名は、通常、設定済みのサーバー識別子を使った call_mcp_tool に対応します。タスクで Claude Code が明示的に対象とされていない限り、~/.claude/... を ~/.cursor/skills/、.cursor/skills/、.cursor/rules/ に対応させます。

セッションをまたいで継続できるよう、セッションのコンテキストを Serena MCP メモリに保存します。

<essential_principles>

基本要件

• 永続化には Serena MCP ツールのみを使用します（エージェント固有のツールは使用しません）
• 価値あるコンテキストを上書きしないよう、書き込み前に必ず既存のメモリを確認します
• セッションチェックポイントのキーには日付を含めます：session_YYYY-MM-DD_<description>
• パターンと学習内容のメモリには次を使用します：pattern_<topic>
• 保存した内容を、構造化された要約としてユーザーに報告します

</essential_principles>

フェーズ 1：セッションの分析

1. このセッションで達成したことを確認します：
   • 作成または変更したファイル
   • 決定事項とその理由
   • 発生した問題と解決策
   • 完了したタスクと残っているタスク
2. 永続化する価値がある内容を特定します：
   • セッションの状態：現在の進捗、次の手順、障害
   • 学び：再利用できるパターン、問題の解決策
   • 計画：進行中または更新済みの計画
   • TODO：未完了の作業項目

フェーズ 2：メモリの一覧確認

3. list_memories を呼び出して既存のメモリを確認します
4. 更新が必要な既存メモリと、新規作成するメモリを特定します

フェーズ 3：セッションチェックポイントの永続化

5. 次のキーを指定して write_memory を呼び出します：session_YYYY-MM-DD_<summary>

## Session: YYYY-MM-DD — <summary>

Agent: <Claude Code | Cursor | Codex> (<model>, if known)

### Accomplished
- [what was done]

### Decisions Made
- [product decision]: [rationale]
- (<Agent>) [tooling decision]: [rationale]

### Files Changed
- [file path]: [what changed]

### Pending / Next Steps
- [what remains to be done]

### Blockers (if any)
- [blocker description]

Agent: にはこのスキルを実行するエージェントの名前を記入します。モデル名を加えるのは、エージェントがそのモデルを報告した場合に限ります。Serena のメモリはエージェントではなくプロジェクトに属するため、Claude Code、Cursor、Codex はすべて同じチェックポイントを読み取ります。ツール選択に関する決定（どのブラウザー／MCP／IDE ツールを使うか、モデル固有の回避策）は、その決定を行ったエージェントにのみ適用されます。(<Agent>) を接頭辞として付けます（例：(Cursor) browser QA runs through Cursor's built-in browser）。プロダクトに関する決定（仕様、設計、API 契約、命名）は、すべてのエージェントに適用されます。接頭辞を付けずに記述します。

フェーズ 4：学びの永続化（該当する場合）

6. 再利用可能なパターンを見つけた場合は、それぞれについて次のキーを指定して write_memory を呼び出します：pattern_<topic>

## Pattern: <name>

**Context**: [when this applies]
**Solution**: [the pattern/approach]
**Example**: [concrete example]
**When to Use**: [trigger conditions]

7. 永続的な TODO がある場合は、それぞれについて次のキーを指定して write_memory を呼び出します：todo_<description>

## TODO: <description>

**Priority**: [high/medium/low]
**Context**: [why this matters]
**Acceptance Criteria**: [how to know it's done]

フェーズ 5：検証

8. 次の点を確認します：セッションチェックポイントが作成されていること、学びが保存されていること、重要なコンテキストが失われていないこと

フェーズ 6：保存内容の報告

ユーザーに次の内容を報告します：

## Session Saved

### Memories Written
| Key | Purpose |
|-----|---------|
| session_YYYY-MM-DD_xxx | Session checkpoint |
| pattern_xxx | [if any] |
| todo_xxx | [if any] |

### Next Session
Run `/load` to restore this context.

メモリの命名規則

命名規則の完全なリファレンスについては、references/memory-conventions.mdを参照してください。

概要：

Prefix	Purpose	Example
CRITICAL_*	必読のルール	CRITICAL_activation_rule
session_YYYY-MM-DD_*	セッションのチェックポイント	session_2026-02-09_auth-flow
plan_*	実行中の計画	plan_dark-mode
pattern_*	再利用可能なパターン	pattern_supabase-rls
discovery_*	ブレインストーミングの結果	discovery_api-options
todo_*	継続的なTODO	todo_fix-login

成功基準

• セッションで達成した内容を分析した
• 既存のメモリを確認した（誤って上書きしていない）
• 日付入りのキーでセッションのチェックポイントメモリを作成した
• Agent:行を記述した。すべてのツール関連の判断に(<Agent>)の接頭辞を付けた
• 学びやパターンを保存した（発見した場合）
• 保存レポートをユーザーに提示した