mcpField
R
remember

remember

github.com/jsmastery-proエージェントワークフロー237964 回インストール16 週間前に更新
リポジトリ

remember について

AIを使う開発者向けに、セッション終了時の要点保存と次のセッションでの復元を行うメモリースキルです。機密情報は除外または伏せ字にし、既存のメモリーを上書きする前に確認を求めます。

主な機能

  1. 01セッションの要点を保存
  2. 02次のセッションで情報を復元
  3. 03秘密情報の除外または伏せ字化
  4. 04メモリー上書き前の確認
  5. 05復元時に指定されたコンテキストファイルを読む

活用シーン

  1. 01セッション間でプロジェクト状況を引き継ぐ
  2. 02保存済みの決定をもとに作業を再開
  3. 03認証情報を保存せず次の作業を記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jsmastery-pro/jsm-agent-skill --skill remember

インストール後、Claude Code で/rememberを入力して読み込まれたか確認します。

詳細

AI にはセッション間で記憶がありません。新しいセッションは毎回、何もない状態から始まります。このスキルがそれを解決します。

セッションの終了時に実行して保存します。新しいセッションの開始時に実行して復元します。機能はこれだけですが、一貫して実行すれば、何も失われません。

セキュリティ境界

このスキルは、シークレットを決して保存してはなりません。会話やコンテキストに機密情報が含まれている場合は、memory.md にコピーしないでください。

機密データには、以下のものが含まれます(これらに限定されません)。

  • API キー、アクセストークン、リフレッシュトークン、セッショントークン
  • パスワード、パスフレーズ、ワンタイムコード、秘密鍵、証明書
  • Cookie、認証ヘッダー、接続文字列、Webhook シークレット
  • 認証情報に見える値や、シークレットらしき文字列

有用でも機密性の高い詳細は、代わりに伏せ字のプレースホルダーを保存してください(例:[REDACTED_API_KEY])。 機密情報かどうか判断できない場合は、機密情報として扱い、省略するか伏せ字にしてください。

呼び出し方法

セッション終了時に保存するには:

/remember save

新しいセッションの開始時に復元するには:

/remember restore

開発者が /remember だけを実行し、どちらかを指定していない場合は、どちらが必要か尋ねてください。


保存モード

開発者が /remember save を実行した場合:

保存する内容

現在の会話を確認し、まったく新しいコンテキストで作業を続けるために開発者が本当に必要とする内容だけを抽出してください。認証情報、API キー、トークンなどの機密データは保存しないでください。会話の書き起こしでも、すべての出来事の要約でもありません。必要不可欠な現状を記録します。

今日の出来事を何も知らない、同等のスキルを持つ同僚にプロジェクトを引き継ぐつもりで考えてください。何を知っていれば、情報を失うことなく作業を続けられるでしょうか?

以下を記録してください。

作成したもの — 作成または変更した具体的なファイル、完了した機能、追加したコンポーネント。正確に記述してください。「認証フローを作成した」ではなく、「app/(auth)/login/page.tsx、app/(auth)/callback/page.tsx、middleware.ts を作成した。Google と GitHub の OAuth が最初から最後まで動作する」のように記述します。

決定事項 — 変更が難しい、または今後の作業の前提となる選択。実装の詳細ではなく、アーキテクチャ上の選択です。「クライアント側ではなくサーバー側のデータ取得を採用した。読み込み状態を避け、機密性の高いロジックをクライアント側に置かずに済むため」のように記述します。

解決した問題 — 解決に時間がかかった問題。次のセッションで同じ問題を再度調査せずに済むようにします。「サードパーティーの認証コールバックには、リダイレクト URL の末尾にスラッシュが必要だったため、コールバックハンドラーで修正した」のように記述します。

現在の状態 — 現時点での正確な状況。動作するもの、一部のみ完成しているもの、既知の不具合を記録します。

次に行うこと — 次に行うべき作業。次のセッションですぐに着手できるほど具体的に記述します。

未解決の質問 — 次のセッションで対処する必要がある、未解決の事項を記録します。

保存しない内容
  • コードを見れば分かる実装の詳細
  • コンテキストファイルにすでに記載されている決定事項
  • コードベースを読めば推測できること
  • 作成の手順。保存するのは、作成したものと決定したことのみです
  • シークレットや認証情報に見える値(トークン、キー、パスワード、Cookie、認証ヘッダー、接続文字列)
書き込む前の安全確認

memory.md に書き込む前に、内容を最後に確認し、機密情報が含まれていないことを確認してください。

  • 機密情報が見つかった場合は、書き込む前に削除するか、伏せ字にしてください。
  • 次のセッションを続けるために必要な、最小限の非機密情報だけを残してください。
保存先

メモリはプロジェクトのルートにある memory.md に書き込みます。このファイルには、常に直近のセッション状態のみが保存されます。

memory.md がすでに存在する場合は、現在保存されている内容を簡潔に要約して開発者に示し、上書きする前に確認を求めます。

Step 1 — memory.md を読み取り、1行で要約してから、開発者の入力を待ちます。

memory.md already exists from a previous session.
Current memory covers: [one-line summary of existing content].

Overwrite with this session's memory? (yes / no)

Step 2 — 開発者の応答後:

  • yes の場合は、新しい memory.md を書き込みます。
  • no の場合は、何も書き込まず、次のように返信します。
No changes made. memory.md is unchanged.
形式
# Memory — [Feature or Session Name]

Last updated: [date and time]

## What was built

[Specific files, components, features completed this session]

## Decisions made

[Architectural and implementation decisions that future work depends on]

## Problems solved

[Issues resolved this session — so they are not solved again]

## Current state

[Exactly where things stand — what works, what is partial, what is broken]

## Next session starts with

[The very first thing to do in the next session — specific and actionable]

## Open questions

[Anything unresolved that needs addressing]

ファイルを書き込んだ後、開発者に次のように確認します。

Memory saved to memory.md.

Next session: run /remember restore to pick up from here.

復元モード

開発者が新しいセッションの開始時に /remember restore を実行した場合:

Step 1 — メモリを探す

プロジェクトのルートに memory.md があるか確認します。存在しない場合は、開発者に次のように伝えます。

No memory.md found in this project.

Either this is the first session, or the file was not saved.
To save memory at the end of a session, run /remember save.
Step 2 — 利用可能な情報をすべて読む

まず memory.md を読み取ります。次に、以下の特定のコンテキストファイルが存在する場合に限り、それらを確認して読み取ります。

  • CLAUDE.md、.claude/context.md — Claude Code
  • .github/copilot-instructions.md — GitHub Copilot
  • .cursorrules、.cursor/rules/ — Cursor
  • .windsurfrules — Windsurf
  • AGENTS.md — Codex
  • .clinerules — Cline
  • context.md — 汎用フォールバック

このリストにないファイルはスキャンも読み取りもしないでください。利用できる情報から、可能な限り完全な状況を把握してください。

復元時には、どの情報源に含まれていても、生のシークレットを繰り返したり、表に出したりしないでください。復元したコンテキストにシークレットが含まれている場合は、必ず伏せた形でのみ要約してください。

Step 3 — 復元した内容を確認する

作業を開始してはいけません。開発者がすぐに続行したいと決めつけないでください。Claude が正しく理解したか開発者が確認できるよう、復元した内容を要約します。

Memory restored. Here is where we are:

**Last session:** [what was built]
**Current state:** [what works right now]
**Decisions in place:** [key decisions that are locked]
**Next up:** [what the next session should start with]

Is this correct? Say yes to continue, or correct anything
that does not look right before we proceed.

開発者が確認した後にのみ、セッションを続行します。

メモリが不完全または不明瞭な場合

memory.md が存在していても重要なコンテキストが欠けている場合は、正直にその旨を伝えます。

I found memory.md but some context seems missing —
[what is unclear or absent].

Should we continue with what we have, or do you want
to fill in the gaps before we start?

推測してはいけません。決めつけてはいけません。不足している情報を示し、開発者の判断に委ねてください。


ルール

すべてのセッションの終わりに /remember save を実行します。 すべてのセッションの始めに /remember restore を実行します。

仕組みはこれだけです。一貫して使うことで機能します。 ときどきしか使わないスキルは、頼りにできないスキルです。

コメント