tagru interview

ヒアリングを進めます。ヒアリングは、AI の質問に答えて、戦略のコンテンツの柱を決める機能です。

tagru interview [--workspace <id>] [--target <prod|test|localhost>]
tagru interview resume [--workspace <id>] [--target <prod|test|localhost>]
tagru interview start [--workspace <id>] [--target <prod|test|localhost>] [--json]
tagru interview answer <id> <回答> [--workspace <id>] [--target <prod|test|localhost>] [--json]
tagru interview finish <id> [--yes] [--workspace <id>] [--target <prod|test|localhost>] [--json]
tagru interview show [--workspace <id>] [--target <prod|test|localhost>] [--json]

確定すると今の戦略が上書きされます

確定（finish、対話モードで y）すると、今の戦略（コンテンツの柱）がヒアリングの結果で上書きされます。 対話モードでは y/N で確認します。finish は --yes が無ければ端末で確認し、 端末でない環境（スクリプト・AI エージェントなど）では --yes が無いと失敗します。

サブコマンド

サブコマンド	内容
（なし）	対話モード。新しく始めて、質問に答えながら確定まで進める（端末でだけ使えます）
resume	対話モード。最新の途中のヒアリングを続きから進める（端末でだけ使えます）
start	新しく始めて、最初の質問とヒアリングの ID を出す
answer <id> <回答>	1 回答えて、AI の返事（次の質問・最終案）を出す
finish <id>	確定して戦略に保存する（今の戦略を上書きする）
show	最新の途中のヒアリングのやり取りを表示する

start / answer / finish は 1 回ずつ実行するコマンドで、スクリプトや AI エージェント向けです（--json に対応）。

オプション

オプション	内容
--yes	確認せずに確定する。finish のみ
--workspace <id>	ワークスペース（tagru use で保存した値より優先）
-t, --target <name>	接続先
--json	JSON で出力する（start / answer / finish / show。対話モードは非対応）

• start / answer / finish（と、それを使う対話モード）は書き込みの権限（cli:write）が必要です
• ワークスペースを選んでいないときは、ワークスペースに属さない個人のヒアリングを扱います
• AI の返事を待つため、start / answer / finish（と対話モードでの同じ操作）だけタイムアウトを 120 秒にしています。show と、answer の前に行う最新のヒアリングの取得は、ほかのコマンドと同じ 30 秒です

回答の書き方

質問の種類	書き方
選択	番号を 1 つ（2）
複数選択	番号をカンマ区切り（1,3）
柱を選ぶ質問	番号をちょうど 3 つ（1,2,4）
自由記述	文章をそのまま

番号以外の入力は、どの質問でもそのまま文章として送ります（自由記述の質問への答えや、AI への相談）。 範囲外の番号や選ぶ数が合わないときは、送らずにエラーにします（対話モードでは同じ質問をもう一度聞きます）。

対話モード（tagru interview / resume）

$ tagru interview
ワークスペース: ws-xxxx
ID: iv-xxxx

[AI] 進め方
  - 事業とお客様について
  - 発信のテーマを決める
[AI] 質問（選択）: 主なお客様はどなたですか？
  1. 近所に住む家族連れ
  2. 仕事帰りの会社員

番号を 1 つ入力してください（文章で答えることもできます）（空行で中断）
> 1
[AI] 質問（複数選択）: よく使う SNS はどれですか？
  1. Instagram
  2. X
  3. TikTok

番号をカンマ区切りで入力してください（例: 1,3。文章で答えることもできます）（空行で中断）
> 1,3
[AI] 質問（自由記述）: お店のいちばんの強みを教えてください。

回答を入力してください（空行で中断）
> 駅前で 20 年続く老舗です
[AI] 最終案
  - 新作の着用レビュー
  - 店頭の舞台裏
  - お客様の声

ヒアリングを確定して、戦略に保存しますか？今の戦略（コンテンツの柱）は上書きされます。 [y/N] y
戦略に保存しました（ヒアリング ID: iv-xxxx）。`tagru strategy` で確かめられます。

• 回答の入力では、空行・Ctrl+D・Ctrl+C で中断できます。やり取りはサーバーに保存されているので、tagru interview resume で続きから再開できます
• 確定の確認（[y/N]）で y / yes 以外（空行を含む）を答えると確定せず、回答の入力に戻ります。直したい点を書いて送るとヒアリングを続けられ、空行を入れると中断します。確定の確認で中断するときは Ctrl+D・Ctrl+C を使います
• 通信が途切れたときも、サーバーには途中まで保存されています。tagru interview resume で再開してください
• 端末でない環境では 対話モードは端末でだけ使えます。… のエラー（終了コード 1）になります。start / answer / finish を使ってください
• 途中のヒアリングが無いときの resume は 途中のヒアリングはありません。… のエラーになります

1 回ずつ進める（start / answer / finish）

$ tagru interview start
ワークスペース: ws-xxxx
ID: iv-xxxx

[AI] 進め方
  - 事業とお客様について
  - 発信のテーマを決める
[AI] 質問（選択）: 主なお客様はどなたですか？
  1. 近所に住む家族連れ
  2. 仕事帰りの会社員

回答するには: tagru interview answer iv-xxxx "<回答>"（番号を 1 つ入力してください（文章で答えることもできます））

$ tagru interview answer iv-xxxx 1
ワークスペース: ws-xxxx
[AI] 質問（複数選択）: よく使う SNS はどれですか？
  1. Instagram
  2. X
  3. TikTok

回答するには: tagru interview answer iv-xxxx "<回答>"（番号をカンマ区切りで入力してください（例: 1,3。文章で答えることもできます））

最終案が出たら、確定の方法を案内します。

$ tagru interview answer iv-xxxx "駅前で 20 年続く老舗です"
ワークスペース: ws-xxxx
[AI] 最終案
  - 新作の着用レビュー
  - 店頭の舞台裏
  - お客様の声

確定するには: tagru interview finish iv-xxxx（今の戦略が上書きされます）

$ tagru interview finish iv-xxxx --yes
ワークスペース: ws-xxxx
戦略に保存しました（ヒアリング ID: iv-xxxx）。`tagru strategy` で確かめられます。

• answer は、今の質問を確かめるため、先に最新の途中のヒアリングを読みます。<id> が最新の途中のヒアリングでなければ ヒアリング … は、最新の途中のヒアリングではありません。… のエラーになります
• finish は --yes が無ければ端末で確認します。端末でない環境で --yes が無いと、次のエラー（終了コード 1）になります

$ tagru interview finish iv-xxxx
確定すると今の戦略（コンテンツの柱）が上書きされます。確認できない環境では --yes を付けて実行してください。

表示（tagru interview show）

• 最新のヒアリングが途中（進行中）なら、そのやり取りを古い順に表示します。途中のものが無ければ (なし) と出して終了コード 0 で終わります
• 表示するのは最新の 1 件だけで、過去のヒアリングの一覧はありません。やり取りは直近 100 件までです
• 表示するだけで、回答や確定は行いません

$ tagru interview show
ワークスペース: ws-xxxx
ID: iv-xxxx
開始日時: 2026-09-30 09:00
更新日時: 2026-09-30 09:05

[AI] 進め方
  - 事業とお客様について
  - 発信のテーマを決める
[AI] 質問（選択）: 主なお客様はどなたですか？
  1. 近所に住む家族連れ
  2. 仕事帰りの会社員
[あなた] 主なお客様はどなたですか？: 近所に住む家族連れ
[AI] 質問（自由記述）: お店のいちばんの強みを教えてください。

--json

いずれも詳細の外枠（item）で出します。

コマンド	item
start	{ "id", "messages" }（messages は最初の進め方と質問）
answer	{ "id", "messages" }（messages は AI の返事だけ）
finish	{ "id", "saved" }（確認で取りやめたら saved は false）
show	下の表の形。途中のヒアリングが無ければ null

{
  "target": "prod",
  "workspaceId": "ws-xxxx",
  "item": {
    "id": "iv-xxxx",
    "messages": [
      {
        "id": "m4",
        "role": "assistant",
        "type": "question",
        "createdAt": "2026-09-30T09:01:00+09:00",
        "text": "お店のいちばんの強みを教えてください。",
        "question": { "kind": "text", "key": "strength", "options": [], "maxSelect": null },
        "items": []
      }
    ]
  }
}

show の item の項目:

項目	型	内容
id	string	ヒアリングの ID
status	string	状態（途中のものだけを返すので active）
createdAt	string | null	開始日時
updatedAt	string | null	更新日時
messages	object[]	やり取り（古い順。下の表）

messages の 1 件:

項目	型	内容
id	string | null	やり取りの ID
role	string	assistant（AI）/ user（あなた）
type	string	plan（進め方）/ question（質問）/ message（メッセージ）/ final（最終案）
createdAt	string | null	日時
text	string	メッセージの本文・質問の文
question	object | null	質問のときだけ { "kind", "key", "options": [{ "value", "label", "description" }], "maxSelect" }。kind は choice（選択）/ multi_choice（複数選択）/ text（自由記述）/ proposals_select（候補から選択）/ preview（確認）
items	string[]	進め方の項目、最終案の柱のタイトル。それ以外は空配列

messages の最後が type: "final" なら確定できます（items が柱のタイトル）。

AI エージェントから使うとき

エージェントからは、対話モードではなく start / answer / finish と --json を使います。 質問の中身（事業・お客様・目標など）は推測で答えず利用者に聞くこと、確定の前に最終案を利用者に見せて確認を取ることなどは、 同梱の skill（AI エージェントから使う）に書かれています。