remember

remember skill の概要

remember ができること

remember skill は、事実、慣例、意思決定、ハマりどころを Claude の自動メモリに明示的に保存するための、用途を絞った Knowledge Capture skill です。自動保存に任せるには重要すぎる情報を扱う場面に向いています。たとえば「CI の問題の原因がようやく分かった」「このプロジェクトにはドキュメント化されていない慣例がある」「Claude にこのチームの好みを忘れてほしくない」といったケースです。

単にアシスタントへ「覚えておいて」と頼んで残ることを期待するのではなく、remember はエージェントに再現可能な手順を与えます。知識を整理し、重複を確認し、タイムスタンプ付きで文脈のあるメモリエントリを書き込む流れです。

向いているユーザーとチーム

remember skill は、継続的なプロジェクトで繰り返し使われる文脈が重要になる場合に役立ちます。たとえば、開発チーム、複数リポジトリを扱う個人開発者、AI 支援のデバッグワークフロー、時間とともに改善していく必要があるエージェントに適しています。特に、重要な知識がチャット履歴にはあるものの、まだ CLAUDE.md、ドキュメント、テスト、コードコメントには反映されていない場合に有用です。

この skill は、完全なナレッジベース、メモアプリ、ドキュメント生成ツールではありません。役割はもっと限定的です。今後の Claude セッションに影響すべき、短く実用的なメモリを残すことにあります。

通常のプロンプトとの違い

「これを覚えておいて」のような通常のプロンプトは曖昧です。remember skill は、何を覚えるべきか、なぜ重要なのか、そのメモリがプロジェクト固有なのかグローバルなのかを確認することで、運用上の規律を加えます。また、メモリファイルが同じ事実の繰り返しでノイズだらけにならないよう、重複チェックの手順も含まれています。

そのため remember は、忘れることのコストが高い場面で価値を発揮します。たとえば、同じデバッグの繰り返し、不適切なツール選定、無視されがちなコーディング規約、好みのブレなどです。

remember skill の使い方

remember のインストールとソース確認

使用している skill manager でリポジトリから skill をインストールします。例:

npx skills add alirezarezvani/claude-skills --skill remember

次に、以下のソースを確認します。

engineering-team/self-improving-agent/skills/remember/SKILL.md

この skill はコンパクトで、リポジトリのプレビュー上では個別の scripts/、references/、rules/、resources/ ディレクトリはありません。そのため、読むべき中心ファイルは SKILL.md です。本番向けのエージェント設定で使う前に、使用例、重複チェックコマンド、メモリエントリ作成のワークフローを確認しておきましょう。

remember の基本的な使い方

/si:remember に続けて、保存したい知識を正確に指定します。

/si:remember "This project's CI requires Node 20 LTS — v22 breaks the build"

よい入力は、具体的で、長く使えて、行動につながる内容です。弱い入力の例:

/si:remember "CI is weird"

強い入力の例:

/si:remember "CI fails on Node 22 because the build image expects Node 20 LTS; use Node 20 for local reproduction and GitHub Actions parity"

強い例では、将来の Claude に対して、何が起きたのか、どこに適用されるのか、どの行動を取るべきなのかが伝わります。

プロンプトに含めるべきこと

よい結果を得るには、次の 4 点を含めます。

• Fact: Claude に保持してほしい事実。
• Context: 適用範囲。repo、endpoint、test suite、tool、team など。
• Reason: 忘れると悪い出力につながる理由。
• Scope: プロジェクト固有か、一般的な好みか。

例:

/si:remember "Project-specific: In this repo, API auth uses a custom JWT library instead of passport. Do not recommend passport middleware unless we are replacing the auth layer."

このように書くと、単なる曖昧なメモではなく、後から役立つメモリを作るための材料を skill に渡せます。

Knowledge Capture の実践ワークフロー

remember は、発見、意思決定、修正の直後に使うのが効果的です。情報が新鮮で、会話が別の話題へ進む前が最適なタイミングです。

実践的な流れは次のとおりです。

1. デバッグ、レビュー、計画中に、長く使える事実を見つける。
2. 文脈と影響を含めて 1 文にまとめる。
3. /si:remember "<fact>" を実行する。
4. skill に重複メモリを確認させる。
5. 似たエントリがある場合は、ノイズを増やすのではなく更新または明確化する。
6. 新しいメモリを今後のセッションで使える状態にして作業を続ける。

このワークフローにより、メモリを会話ログの写しにせず、実用的な状態に保てます。

remember skill FAQ

remember はいつ使うべきですか？

remember は、その知識が今後の作業に影響しそうで、かつコードベースやドキュメントから自明ではない場合に使います。よい候補には、ビルド要件、フレームワーク上の制約、アーキテクチャ上の意思決定、繰り返し起きるテスト問題、ドキュメント化されていない慣例、安定したユーザーまたはチームの好みなどがあります。

「いま file X を編集中」のような一時的なタスク状態には使わないでください。ただし、その事実がセッション終了後にも重要である場合は例外です。

remember は初心者にも向いていますか？

はい。コマンド自体はシンプルです。ただし初心者は、曖昧なメモや感情的なメモを保存しないよう注意する必要があります。「the database is annoying」のようなメモは役に立ちません。一方で、「Local DB tests require Docker Compose service postgres-test to be running before npm test」のようなメモは有用です。

この skill は、ユーザーが運用上の学びを明確に説明できるほど効果を発揮します。

remember と CLAUDE.md の違いは？

CLAUDE.md は、今後のすべてのエージェントがリポジトリの一部として読むべき、安定した共有プロジェクト指示に向いています。remember は、段階的な学習、苦労して得た発見、まだ正式なドキュメントにする準備ができていない文脈に向いています。

よい使い方は、まず remember で捕捉し、繰り返し使われるメモリやチーム全体に関わるメモリを CLAUDE.md、README、テスト、アーキテクチャ文書へ昇格させることです。

remember を使わない方がよい場合は？

remember を secrets、credentials、private tokens、機密性の高い個人情報の保存に使わないでください。知識をチーム全体に見える形で共有すべき場合は、ソース管理されたドキュメントの代替として使うべきではありません。また、推測、未解決の仮説、一度きりの観察も、明確に不確実であると示さない限り保存しない方が安全です。

メモリは将来のミスを減らすためのものであり、憶測を残すためのものではありません。

remember skill を改善する方法

より鋭い入力で remember の結果を改善する

品質を最も大きく左右するのは入力文です。remember を呼び出す前に、粗い発見を長く使える指針へ書き換えましょう。

粗い例:

/si:remember "Jest hangs sometimes"

改善例:

/si:remember "Project-specific: Jest integration tests can hang after DB tests unless run with --forceExit; use this flag when reproducing CI test hangs locally."

この例では、ツール、条件、回避策、スコープが明示されています。そのため、保存されたメモリを Claude が正しく適用しやすくなります。

重複した古いメモリを避ける

上流のワークフローには、プロジェクトのメモリファイルに対する重複チェックが含まれています。この手順を省かないでください。重複したメモリは、特に慣例が時間とともに変わる場合に、矛盾した指針を生みます。

古いエントリを見つけた場合は、単に追加するのではなく、概念としてメモリを更新する方を優先します。たとえば「This replaces the old Node 18 note; the project now standardizes on Node 20 LTS.」のように、置き換え関係を明確にすると、矛盾する事実を積み上げるより安全です。

繰り返し使うメモリをドキュメント化する

同じメモリが複数のコントリビューターに影響するなら、メモリの外へ昇格させましょう。CLAUDE.md、README.md、オンボーディング資料、テストセットアップ手順、アーキテクチャ決定記録に追加します。remember は捕捉には優れていますが、共有された運用ルールにはソース管理されたドキュメントの方が適しています。

目安として、Claude がそのメモリを 2 回以上必要としたなら、人間にも必要な可能性が高いです。

注意すべきよくある失敗パターン

主な失敗パターンは、保存しすぎること、スコープを狭めないこと、根拠なしに結論を保存することです。「always use explicit error handling」のように広すぎるエントリは、それが本当にグローバルな好みでない限り避けてください。代わりに、スコープを明確にした指針を優先します。例: 「In this repo, avoid catch-all error handlers in API routes because errors are logged by middleware.」

よい remember の使い方は、将来の支援を改善する、短く文脈のあるメモリを作ることです。同時に、エージェントを硬直させたり、ノイズを増やしたりしないことも重要です。