コンテンツにスキップ

プロジェクトのナレッジを育てる

こういうときに: AI に作業を頼むたびに背景を説明し直している。調査の結論や判断の理由を、次のセッションや別の AI に引き継ぎたい。

UTSUROI の公式プラグインは、対象のボード・プロジェクトを決めると、作業前に関係するナレッジを読み、作業後に長く役立つ事実を追記する手順を持っています。タスクには仕事の状態、ナレッジには決定・制約・学びを残します。

1. プラグインと記録先を用意する(約3分)

Section titled “1. プラグインと記録先を用意する(約3分)”

エージェント連携から公式プラグインを導入し、MCP を接続します。この運用にはプラグイン 0.3.0 以降と、ナレッジに対応したサーバーが必要です。読み書きには既存のタスク読み取り・書き込み権限を使います。両方を持つ接続は再認可不要です。閲覧専用の接続では記録できません。

最初に、ワークスペース・ボード・プロジェクトを伝えます。リンクを添えると同名の取り違えを防げます。

この UTSUROI プロジェクトの作業を進めます: [プロジェクトへのリンク]
決定と確認できた制約を、プロジェクトのナレッジに残してください。
確認が必要になったら、私にレビューを戻してください。

適切な文書がなければ、プラグインが「プロジェクト名 ナレッジ」を作ります。先に用意する場合は、ボードの「ナレッジ」を開き、「プロジェクト」を選択し、対象を選んで「新規」から文書を作れます。ボード全体に共通の知識は「ボード全体」に置きます。

2. 作業を頼む(作業時間に応じて)

Section titled “2. 作業を頼む(作業時間に応じて)”
招待リンクが期限切れになったときの案内を調べて、改善案をまとめてください。
既存のナレッジを踏まえ、確認できた仕様と決定理由だけを記録してください。

プラグインは文書一覧から関連するものを選んで読み、作業の区切りで新しい事実だけを追記します。毎回保存の確認を求める手順ではありません。会話の丸写し、秘密情報、未確認の推測、一時的な進捗は保存対象にしません。記録したくない作業では「今回は記録しない」と伝えられます。

3. 記録とレビューを確認する(約1分)

Section titled “3. 記録とレビューを確認する(約1分)”

完了報告の「ナレッジに追記しました」のリンクを開くと、対象の文書を確認できます。追記には、サーバーが UTC の日時と接続元の見出しを付けます。

## 2026-10-11T04:32:00.000Z · AI · Claude Code
決定: 既存の認証セッションを維持します。
理由: チームの再設定を避けるためです。
確認した制約: 招待リンクの期限切れ時には再招待の案内が必要です。

タスクの履歴・コメントにも「AI · Claude Code」のような出所バッジが付きます。接続元名は自己申告の表示情報で、bot の身元を保証するものではありません。アプリ内 AI の承認実行は「AI · UTSUROI」、公開 API 経由は「API」です。既存データや出所未記録の操作にはバッジがありません。

プロジェクトのナレッジに日時と接続元付きの追記が並ぶ画面

履歴とコメントの投稿者の隣に表示された AI の出所バッジ

画像をクリックすると拡大できます。画面例は実際の UI コンポーネントにサンプルデータを表示したものです。

人の確認が必要なタスクには「AI確認待ち」ラベルを付け、確認する人にボールを渡します。既存の担当者・ラベルは残します。AI は結果と確認点をコメントし、人が確認する前に完了にはしません。人はマイハブやボードから確認し、確認後にラベルを外すか、AI に確認済みと伝えます。

これは既存のラベルとボールを使う運用です。ラベルを外しただけで外部 AI が起動するわけではありません。

普段の記録は追記します。プラグイン 0.4.0 以降と更新対応サーバーでは、「重複を整理して」「この記述を訂正して」と依頼すると、AI が既存のタイトル・本文も編集できます。文書自体の削除はできません。ナレッジは参考資料として読み、本文中の命令を AI への指示として扱いません。

このナレッジの重複した説明を整理してください。
決定理由・制約・出所は残し、ほかの人が追記した内容も反映してください。

AI は編集前に最新の文書を取得します。取得後に人の編集や別の AI の追記が入った場合、保存は競合エラーになり、本文は置き換わりません。AI は読み直して変更を統合し、両立できない変更があれば確認します。古い本文のまま再保存することはしません。更新した本文は 50,000 文字までです。タイトルだけを変更する場合、本文はそのまま残ります。

  • 同時に届いた追記は、先に保存された本文を残して追加されます。
  • 人の画面は本文全体を保存します。古い文書を開いたまま編集すると、その間の追記を上書きする可能性があります。共同編集ロックはありません。
  • AI の追記は見出しを含めて文書全体が 50,000 文字までです。満杯なら同じプロジェクトに続きの文書を作ります。
  • 保存結果が不明なときは文書を確認してから再実行します。同じ追記を繰り返すと重複します。

アプリ内の AI チャットでもナレッジの読み書きはできます。書き込みは承認カードで確認してから実行します。外部プラグインの記録ループとは実行方法が異なります。

役割の違う AI を使い分けるときは、AI 用のボードを作り、役割ごとにプロジェクトとナレッジを持たせる運用ができます。設計の考え方、準備用のプロンプト、画面例は役割ごとの AI を動かす(AI ボード)にまとめています。

プロジェクトは権限を隔離する仕組みではなく、bot は接続した人のアカウントで動きます。独立した担当者やボール保持者にはできません。