コメント
ドキュメントにインラインコメントを残してチームと共同作業、変更依頼、 未解決の質問を追跡できます。
コメント機能には Team プランが必要です。
コメントの追加
- エディターでドキュメントを開く。
- 右ツールバーの Comments アイコンをクリックしてコメントパネルを開く。
- コメントを入力して Post をクリック。
コメントはエディター横のサイドバーに表示されます。各コメントにはタイムスタンプと著者情報が付きます。
メンション
コメント内で @username を使用してチームメンバーに通知できます。
コメントの解決
Editor以上の権限を持つメンバーはコメントを解決できます。解決済みコメントはデフォルトで非表示 — 「Show resolved」で表示切替可能。
ワークフローのヒント: レビューラウンドにコメントを活用。対応完了ごとに解決して進捗を追跡。
共有ビューでのアンカーコメント
ドキュメントが共有(公開・プライベートリンク)されている場合、レビュアーは テキストの選択範囲に直接アンカーされたコメント(Figma スタイル)を残せます。
- 共有リンクを開く。
- トップバーの Comments アイコンをクリックしてコメントモードを有効化。
- ドキュメント内の任意のテキストを選択し右クリック、表示される インラインコンポーザーにコメントを入力。
- 既存のスレッドはハイライトされたテキストの隣に小さなアバターピンとして表示。 ピンをクリックしてスレッドの閲覧・返信ができます。
匿名・認証済みのコメントはエディターから投稿されたものと同じスレッドに保存されます。 エディターのコメントパネルに表示され、CLI および MCP からも一覧取得できます。
CLI / AI からコメントを読む
specdown comments list <path> コマンドは、共有ビューで 付けられた匿名コメントを含む、ドキュメントの全コメントスレッドを出力します。--unresolved で未解決のみ、--json でツール向け JSON 出力。
specdown comments list guides/authentication
specdown comments list guides/authentication --unresolved
specdown comments list guides/authentication --jsonMCP 経由で接続した AI アシスタントは list_comments ツールで同じデータを取得できます。
コメント権限
| 操作 | Viewer | Editor | Admin / Owner |
|---|---|---|---|
| コメント閲覧 | ✓ | ✓ | ✓ |
| コメント投稿 | ✗ | ✓ | ✓ |
| コメント解決 | ✗ | ✓ | ✓ |
| コメント削除 | ✗ | 自分のみ | ✓ |