メンバー向け — 閲覧・コメント・レビューの進め方
メンバー向け — 閲覧・コメント・レビューの進め方
エージェントの メンバー として参加している方むけに、ナレッジの 閲覧・コメント・レビュー の進め方をまとめます。メンバーはナレッジを直接編集できませんが、コメントで専門家(オーナー)にフィードバック できます。
権限の全体像は「用語と権限」(No.2.2)・「あなたの役割別ガイド」(No.1.2)を参照してください。
メンバーでできること・できないこと
| できる | できない |
|---|---|
| ナレッジの閲覧・ダウンロード | 本文・タグ・No の編集 |
| セクションコメントの 追加 | コメントの削除(オーナーのみ) |
| チャットでの質問・メンション | インポート・新規作成・削除 |
| ナレッジ一覧での検索・絞り込み | 一括タグ設定・復元 |
| エージェントからの退出 | メンバー追加・設定変更 |
画面上は 閲覧専用モード と表示されます。編集ボタンが隠れているのは正常な挙動です。
レビューの基本フロー
flowchart LR
A["一覧で更新候補を見つける"] --> B["エディターで内容を読む"]
B --> C["コメントで指摘・質問"]
C --> D["オーナーが修正"]
D --> E["チャットで回答を確認"]
- ナレッジ一覧(
/knowledge/{code})で全体を俯瞰 — 最終更新日・コメント数に注目(No.5.1) - エディターで該当セクションを読む — 誤り・不足・古い記述をメモ(No.5.2)
- コメントを書く — セクション直下の「コメント」パネルから追加
- オーナーが対応 — 手動編集、または「AI で修正」(非孤立コメントが指示に合成される)。本文を変えずに「レビュー済み」ボタンで確認時刻を更新し、陳腐化フラグを解消することも可能(オーナーのみ)
- チャットで検証 — 想定質問を投げ、回答と根拠を確認(No.4.1)
セクションコメントの書き方
| ポイント | 例 |
|---|---|
| 具体的に | 「§手順 3 の案内が古い。アカウント設定の場所が変わったはず」 |
| 1 コメント 1 論点 | 複数の指摘はセクションごとに分ける |
| 提案があれば添える | 「〇〇と追記するとよい」 |
- コメントは 見出しテキストにアンカー されます。オーナーが見出しを大きく変えると 孤立コメント になるため、大きな構成変更の前後はオーナーと相談してください。
- コメント本文は最大 4,000 文字。
プライベート vs パブリック
| 種類 | メンバーのコメント |
|---|---|
| パブリック | ログイン済みなら誰でもコメント可(メンバーでなくても可) |
| プライベート | メンバー以上のみコメント可 |