ナレッジヘルスチェック(🩺)— 利用者がコメントを見るとき
ナレッジヘルスチェック(🩺)— 利用者がコメントを見るとき
ナレッジエディターのセクションコメント欄に 🩺 バッジ付き の指摘が表示されることがあります。これは AI エージェントによるヘルスチェック(Lint) の結果です。人間のコメントと区別して読むためのガイドです。
運用サイクル全体は「ナレッジ運用とレビューの進め方」(No.5.4)、MCP 経由の実行は「Cursor / Claude から使う」(No.7.1)。
ヘルスチェックとは
ナレッジが増えると、矛盾・古い記述・孤立ページ・リンク不足 などが溜まり、回答品質が下がることがあります。ヘルスチェックはそれを洗い出す仕組みです。
- 判断(内容の正しさの分析)は接続中の AI(Cursor / Claude 等)が行う
- 指摘の投稿は MCP
add-comment(source="health_check")でセクションコメントとして残る - エディター UI では 🩺 バッジ で人間のコメントと区別
誰が・いつ見るか
| 役割 | 行動 |
|---|---|
| オーナー | 🩺 指摘を確認 → 必要なら本文を修正(エディター or MCP)→ 対応後コメントはオーナーが削除可 |
| メンバー | 指摘を参考に 追加の人間コメント で補足。本文編集は不可(No.1.6) |
| 一般閲覧者 | パブリックならコメント閲覧可。🩺 も表示される |
画面上の見つけ方
/knowledge/{code}/{id}でナレッジを開く- 各セクション下の 「コメント」 パネルを展開
- 🩺 バッジ 付きがヘルスチェック指摘
横断でコメントを確認する(オーナー向け)
複数ナレッジにまたがるコメントを一括して確認するには、利用分析の 「ナレッジ閲覧」カード の种類フィルタで コメント を選択するのが一番です(旧「コメント専用カード」は廃止)。ここでは自分がオーナーの全エージェントにわたるコメントがナレッジ単位で一覧化され、行クリックで該当セクションに騱ベます。
指摘の典型例
- 他ナレッジとの 矛盾
- 古くなった 主張・日付
- 孤立ページ(関連ナレッジリンクが無い)
- リンクすべき のに未リンクの近い内容
- データ欠落(調査が必要な空白)
オーナーの対応フロー
- 🩺 コメントを読む
- 本文を修正(エディターの「編集」or MCP で更新)
- 関連ナレッジリンクを追加(メタ行の「関連ナレッジ」)
- 対応済みなら オーナーがコメントを削除(メンバーは削除不可)
- 定期レビューは No.5.4 のサイクルに組み込む
- チャットで効かない・孤立ページの指摘は No.5.9 も参照
MCP 利用者向け(補足)
get-knowledge でナレッジを取得すると、初回全文取得時に health_check ブロック(孤立判定・経過日数・レビュー推奨フラグ等)が同梱されることがあります。should_review=true のとき、AI が get-reference name=health-check-guide を読んで指摘を add-comment します。