sync: update from private repo (2336949a)

2026-09-17 11:29:31 +00:00
parent 28f74c4e37
commit 57702b4f34
2139 changed files with 321270 additions and 17494 deletions
@@ -0,0 +1,44 @@
+# AskUser
+
+ユーザーに選択肢つきで質問し、回答があるまでタスクを停車する park ツール。
+
+## いつ使うか
+
+- 指示が曖昧で、**進め方の分岐を自分で列挙できる**とき（デプロイ先、対象範囲、形式の選択など）
+- Mission Brief と今回の指示がずれて見え、どちらに従うべきか確認したいとき
+- 複数の論点をまとめて確認したいとき（1 回の停車で最大 4 問）
+
+## いつ使わないか
+
+- 選択肢を作れない開放的な質問（「何をお望みですか？」）→ `complete({status:"needs_user_input", missing_info})`
+- 自明な既定値があり、進めてから報告すれば足りる場合 → 質問せず進める
+- subtask 実行 → 利用不可（degrade メッセージが返る）。自明な選択肢で進めるか complete で報告
+
+## 書き方
+
+```json
+{
+  "questions": [
+    {
+      "question": "デプロイ先はどちらにしますか？",
+      "header": "デプロイ先",
+      "options": [
+        { "label": "本番", "description": "即時反映。ロールバック可" },
+        { "label": "ステージング", "description": "検証後に手動昇格" }
+      ],
+      "multiSelect": false
+    }
+  ]
+}
+```
+
+- 選択肢は **2〜6 個・相互排他**に。網羅しようとせず、迷う候補は入れずに自由記述（UI が常に追加する「その他」）に任せる
+- `question` は文脈を含め単体で意味が通るように。ユーザーは会話全体を読み直さない
+- `header` はカードの短いラベル。省略可
+
+## 挙動
+
+- 呼ぶとタスクは停車（`waiting_human`）し、ワーカーは解放される。ツール内で回答を待たない
+- 回答は次の再開時に**ユーザーメッセージ**として届く（「見出し: 選択」の平文）
+- ASK 上限は停車 1 回で 1 消費（質問数ではない）。上限は askPolicy 設定に従う
+- 回答を受けたら、決定事項を `MissionUpdate` の `decisions` / `clarifications` に記録すること