Skip to main content

ナレッジヘルスチェック(🩺)— 利用者がコメントを見るとき

ナレッジヘルスチェック(🩺)— 利用者がコメントを見るとき

ナレッジエディターのセクションコメント欄に 🩺 バッジ付き の指摘が表示されることがあります。これは AI エージェントによるヘルスチェック(Lint) の結果です。人間のコメントと区別して読むためのガイドです。

運用サイクル全体は「ナレッジ運用とレビューの進め方」(No.5.4)、MCP 経由の実行は「Cursor / Claude から使う」(No.7.1)。


ヘルスチェックとは

ナレッジが増えると、矛盾・古い記述・孤立ページ・リンク不足 などが溜まり、回答品質が下がることがあります。ヘルスチェックはそれを洗い出す仕組みです。


誰が・いつ見るか

役割 行動
オーナー 🩺 指摘を確認 → 必要なら本文を修正(エディター or MCP)→ 対応後コメントはオーナーが削除可
メンバー 指摘を参考に 追加の人間コメント で補足。本文編集は不可(No.1.6)
一般閲覧者 パブリックならコメント閲覧可。🩺 も表示される

画面上の見つけ方

  1. /knowledge/{code}/{id} でナレッジを開く
  2. 各セクション下の 「コメント」 パネルを展開
  3. 🩺 バッジ 付きがヘルスチェック指摘

横断でコメントを確認する(オーナー向け)

複数ナレッジにまたがるコメントを一括して確認するには、利用分析「ナレッジ閲覧」カード の种類フィルタで コメント を選択するのが一番です(旧「コメント専用カード」は廃止)。ここでは自分がオーナーの全エージェントにわたるコメントがナレッジ単位で一覧化され、行クリックで該当セクションに騱ベます。


指摘の典型例


オーナーの対応フロー

  1. 🩺 コメントを読む
  2. 本文を修正(エディターの「編集」or MCP で更新)
  3. 関連ナレッジリンクを追加(メタ行の「関連ナレッジ」)
  4. 対応済みなら オーナーがコメントを削除(メンバーは削除不可)
  5. 定期レビューは No.5.4 のサイクルに組み込む
  6. チャットで効かない・孤立ページの指摘は No.5.9 も参照

MCP 利用者向け(補足)

get-knowledge でナレッジを取得すると、初回全文取得時に health_check ブロック(孤立判定・経過日数・レビュー推奨フラグ等)が同梱されることがあります。should_review=true のとき、AI が get-reference name=health-check-guide を読んで指摘を add-comment します。