SpecDown

コメント

ドキュメントにインラインコメントを残してチームと共同作業、変更依頼、 未解決の質問を追跡できます。

コメント機能には Team プランが必要です。

コメントの追加

  1. エディターでドキュメントを開く。
  2. 右ツールバーの Comments アイコンをクリックしてコメントパネルを開く。
  3. コメントを入力して Post をクリック。

コメントはエディター横のサイドバーに表示されます。各コメントにはタイムスタンプと著者情報が付きます。

メンション

コメント内で @username を使用してチームメンバーに通知できます。

コメントの解決

Editor以上の権限を持つメンバーはコメントを解決できます。解決済みコメントはデフォルトで非表示 — 「Show resolved」で表示切替可能。

ワークフローのヒント: レビューラウンドにコメントを活用。対応完了ごとに解決して進捗を追跡。

共有ビューでのアンカーコメント

ドキュメントが共有(公開・プライベートリンク)されている場合、レビュアーは テキストの選択範囲に直接アンカーされたコメント(Figma スタイル)を残せます。

  1. 共有リンクを開く。
  2. トップバーの Comments アイコンをクリックしてコメントモードを有効化。
  3. ドキュメント内の任意のテキストを選択し右クリック、表示される インラインコンポーザーにコメントを入力。
  4. 既存のスレッドはハイライトされたテキストの隣に小さなアバターピンとして表示。 ピンをクリックしてスレッドの閲覧・返信ができます。

匿名・認証済みのコメントはエディターから投稿されたものと同じスレッドに保存されます。 エディターのコメントパネルに表示され、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 --json

MCP 経由で接続した AI アシスタントは list_comments ツールで同じデータを取得できます。

コメント権限

操作ViewerEditorAdmin / Owner
コメント閲覧
コメント投稿
コメント解決
コメント削除自分のみ

始める準備はできていますか?

コードのようにSpecを書く。Gitと同期する。チームと共有する。