> ## Documentation Index > Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt > Use this file to discover all available pages before exploring further. # 共有メモリファイルを管理する > メンバーとコーディングエージェントがワークスペースを横断して共有するUTF-8ファイルを整理します。 **メモリ**は、ワークスペースで共有するUTF-8ファイルシステムです。メンバーとコーディングエージェントは、ローカルのproject checkoutへコピーせずにテキストファイルを作成・整理・検索・閲覧・編集できます。 ファイルシステム全体を見るには**設定 → メモリ**を開きます。1つのProjectのフォルダを操作するには、そのProjectの設定を開きます。 ## ファイルシステムの構造を理解する ```text theme={"system"} / ├── workspace/ │ ├── instructions.md │ ├── working-memory.md │ ├── integrations/ │ └── skills/ ├── projects// │ ├── instructions.md │ ├── integrations/.md │ ├── skills/ │ └── 自由に作成するファイル ├── archived// 読み取り専用のアーカイブ済みProjectファイル └── legacy/ 読み取り専用のインポート済み・退役済みコンテンツ ├── workspace/ └── projects// ``` | 場所 | 用途 | 変更できる対象 | | - | - | - | | `workspace/` | ワークスペース全体で共有するファイル。 | ワークスペースのコンテンツ書き込み権限を持つメンバーと、許可されたエージェント。 | | `projects//` | 1つのProjectの指示、連携メモ、skills、自由記述ファイル。 | そのProjectのエージェントと、ワークスペースのコンテンツ書き込み権限を持つメンバー。 | | `archived//` | Projectをアーカイブしたときに保持するProjectフォルダとファイル。アーカイブを解除すると、同じフォルダが`projects/`へ戻ります。 | Projectのアーカイブ中は変更できません。読み取り専用です。 | | `legacy/` | 以前の設定項目からインポートしたテキストの完全なスナップショットと、Projectを完全削除したときに保持するフォルダ一式。 | 変更できません。読み取り専用です。 | 接続済みproviderについて以前の指示がない場合、各Projectに空の`integrations/.md`が作成されます。連携を解除しても、そのファイルや編集内容は削除されません。 Projectをアーカイブするとフォルダは`archived/`へ移動し、アーカイブを解除すると`projects/`へ戻ります。Projectを完全削除すると現役・アーカイブ済みProjectの一覧からは消えますが、フォルダとファイルは`legacy/projects/`に読み取り専用で保持されます。 > [!NOTE] > > Cognoが予約するのは上図の場所だけです。`notes/`、`agents/`、`README.md`のようなフォルダやファイルは、メンバーまたはエージェントが自由に作成した内容か、以前の試用版から保持された内容です。標準構造としてCognoが作成するものではありません。 > [!NOTE] > > メモリファイルは毎回のpromptへ自動挿入されません。コーディングエージェントが必要なファイルを一覧・検索・閲覧します。ワークスペース全体の読み取りが標準で、他のProjectフォルダも読めます。変更できるのは自分のProjectフォルダと共有のWorkspace Skillフォルダで、他のProjectのファイルは変更できません。相対パスは自分のProjectから始まります。 メモリ全体が大きくて一度に読み込めない場合も、エージェントはフォルダ名を少しずつ辿ってから必要なファイルを開けます。 ## メモリファイルを編集する **1. 設定 → メモリを開く** **設定 → メモリ**を開きます。**エクスプローラー**に`workspace`、稼働中の`projects`、アーカイブ済みProjectの`archived`、`legacy`がこの順で表示されます。`archived`と`legacy`は最初は折り畳まれています。 **2. ファイルを作成または開く** **新しいファイル**または**新しいフォルダ**を選ぶか、既存のファイルを選びます。Markdownファイルは**プレビュー**または**Markdown**で、その他のUTF-8ファイルは**プレーンテキスト**で開きます。 **3. 編集して保存を待つ** エディタへ入力します。入力を止めると自動保存され、**⌘S**ですぐに保存できます。 **4. エージェントから見えるパスをコピーする** Taskや会話で正確なパスを指定する場合は、**パスをコピー**を選びます。 Memoryはページを開いている間も更新を確認します。変更のないファイルは読み込み済みの版を再利用し、選択したファイルだけを開きます。新しい版を検知しても、編集中の内容はエディターに保持されます。 編集中にエージェントや別のメンバーが同じファイルを保存すると、**編集中にこのファイルが更新されました。**と表示されます。**最新を読み込む**または**自分の内容で上書き**を選びます。Cognoが別の版を黙って上書きすることはありません。 > [!WARNING] > > ファイルやフォルダの削除は元に戻せません。フォルダを削除すると、中のファイルもすべて削除されます。 ## スキルでエージェントに教える スキルは、ある種類の作業のやり方をコーディングエージェントに伝える `SKILL.md` を入れたフォルダです。メモリに置くと、そのワークスペースや Project のエージェントの run すべてで、Claude Code や Codex 自身のスキル一覧に、そのコンピューターにもとからあるスキルと並んで載ります。 エージェントは最初にスキルの名前とdescriptionを見て、選んだスキルの本文を読みます。Cogno組み込みの`chat-reply`は、チャットの依頼・要約・進捗と、長さや見せ方へのフィードバックを扱います。会話ごとに別のスキルを作る必要はありません。 Cognoはチャットで、平易な言葉で約5行で返信します。3件を超える一覧は上位3件だけを返し、残りはTaskに載せます。Slack、Microsoft Teams、Discord、Google Chatで同じです。 返信の見せ方や口調の希望を伝えると、Cognoはその人・その場所について短い1行としてメモリに保存します。新しい希望を言うと、日付付きのメモを増やさずにその1行を書き換えます。Cognoがメンションされたときは、最初の投稿の前にその行を読みます。 **イベントで動くスキル。** `.cogno.yaml` に `event` を持つスキルは、メッセージが `when` の条件の実例であるときだけ動きます。近い話題、その状況についての話、以前の発言の取り下げや訂正では動きません。Cognoがこうしたスキルを作るときは、`when` を1つの具体的な状況に絞り、Cognoが投稿できるチャンネルを使います。スキル自身の出力も1〜3行に収めます。 | 保存する場所 | 受け取る run | 一覧での名前 | | - | - | - | | `workspace/skills/<名前>/SKILL.md` | ワークスペースのすべての run | `<名前>` | | `projects//skills/<名前>/SKILL.md` | その Project の run | `:<名前>` | `skills` フォルダは最上位に置く必要はありません。`skills` という名前のフォルダなら、どの深さにあってもスキルとして扱われます。`workspace/teams/sales/skills/proposal/SKILL.md` はワークスペースのスキル `proposal`、`projects/acme/docs/skills/release/SKILL.md` は Project `acme` のスキルです。誰に届くかは最上位のフォルダで決まります。`workspace/` 配下はワークスペース全体、`projects//` 配下はその Project です。同じ場所に同名のスキルが 2 つあるときは、最初の 1 つだけが読み込まれます。隠しフォルダ（名前が `.` で始まるフォルダ）は人に見えなくなるだけで、中のスキルも通常どおり読み込まれ、エージェントは `workspace/.cogno/skills/` の下に自分のスキルを追加できます。Cogno 組み込みのスキルもそこに表示されて読み取り専用なので、そこに作る新しいスキルには、組み込みと重ならない名前が必要です。 ファイルは次の形で書きます。 ```markdown theme={"system"} --- description: いつ使うスキルかを 1〜2 文で。 --- # 手順 … ``` | 規則 | 内容 | | - | - | | `description` | 必須、1,024 文字まで。エージェントがスキルを選ぶときに見るのはこれです。 | | 名前 | フォルダ名、またはヘッダーの `name:` 行。小文字・数字・単独のハイフンだけ、55 文字まで、`claude` と `anthropic` は使えません。 | | ほかのファイル | `SKILL.md` と同じフォルダのファイル（`scripts/` など）も一緒に渡ります。 | | 変更 | 保存した変更は、動いているエージェントにも次のターンで届きます。 | `SKILL.md` が読み込めない形のときは、エディターに **保存しましたが、このスキルはまだエージェントに読み込まれません。** と、直し方が表示されます。ファイル自体は保存されているので、直して保存し直してください。 コンピューターにもとからあるスキルが隠れることはありません。名前が重なったときは、Cogno 側のスキルに suffix が付きます。 | 状況 | エージェントの一覧での名前 | | - | - | | そのコンピューターに同じ名前のスキルや command がある | `<名前>-cogno` | | ワークスペースのスキルが Cogno 自身のスキルと同じ名前 | `<名前>-ws`（両方に当てはまるときは `<名前>-cogno-ws`） | | Project 名に空白・`:`・`/`・`@` が含まれる | それらは `_` になります。`Sales Ops:<名前>` は `Sales_Ops:<名前>` と表示されます | | Project と同じ名前の plugin を入れている | `-cogno:<名前>` | > [!NOTE] > > Scheduled Skill は通常のスキルと同じ形です。Project 内の `skills/<名前>/SKILL.md` または `/workspace/skills/` 配下のフォルダで、 > 隣の `.cogno.yaml` に `schedule` の entry（cron。例: `- schedule: "0 9 * * 1"`）を書いたものです。 > 他のスキルと同様にエージェントへ渡され、さらに指定の時刻に実行されます。 > entry には `timezone` と `enabled` も書けます。Workspace Skill は `project` で実行先の Project を指定できます。 > エージェントは `list_scheduled_skills` で状態、次回と前回の実行時刻を確認できます。 > Project のランはその Project と共有の Workspace Skill を、Project のない受付ランは Workspace を確認します。 > 1 回だけの実行は Scheduled Skill ではありません。`skills/<名前>.md` のような > 平らなファイルはスキルではありません。 変更・停止したい定期作業を、Cognoが受け取れる会話で伝えてください。ファイルの場所や元のスレッドを指定する必要はありません。複数の作業が当てはまるときは、届け先や時間で対象を伝えてください。 Cognoの組み込みの見回りは、重要な仕事と繰り返される手作業をそれぞれ日次で確認します。ワークスペースのタイムゾーンの09:00を基準に、開始時刻をワークスペースごとに分散します。具体的な期限、未完了Task、約束された返事は、必要に応じて早めに対象を絞って確認します。重要な仕事の見回りでは、役立つ変化や未解決の仕事がなければ、変化なしの投稿をせず終了します。独自の上書き設定と定期作業の停止は維持されます。 ## リファレンス | 項目 | 動作 | | - | - | | 内容 | UTF-8テキストファイルのみ。バイナリファイルには対応していません。 | | パス | 大文字と小文字を区別します。`.`と`..`のパス要素は使えません。 | | エージェントの読み取り | `memory_bash`と`memory_read`は標準でワークスペース全体を表示し、相対パスは現在のProjectから始まります。 | | エージェントの書き込み | `memory_write`、`memory_edit`、ファイル編集で、自分のProjectのファイルと共有のWorkspace Skillを更新できます。既存のgrantで制限され、他のProject、`archived/`、`legacy/`は変更できません。 | | Projectの表示範囲 | Project設定ではそのProject配下、ワークスペースのメモリではファイルシステム全体を表示します。 | | 保存 | 開いた時点のファイル版を使った競合検出付き自動保存。 | | 移行 | 既存の指示とワーキングメモリをそのままコピーします。Cognoが要約や分割をすることはありません。以前に削除されたProjectの孤児フォルダは`legacy/projects/`に保持されます。 | ## 関連ドキュメント * [Projectを扱う](/docs/ja/projects.md) * [エージェントを実行する](/docs/ja/agents.md) * [連携を接続する](/docs/ja/integrations.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.