show-grill-clearly

グリルを明確に提示する

確立済みのグリル判断セットを、ブラウザーで引き継げる形にします。この支援ツールは判断を収集するものであり、事実を見つけたり、ユーザーに代わって決定したりするものではありません。

1. 引き継ぎを確認する

確立済みのグリル引き継ぎを、根拠の範囲として使用します。未解決でユーザーが決定する事項のうち、動作、契約、データ、ワークフローを変更するものが少なくとも1つあり、かつ、引き継ぎの内容だけで誠実な選択肢とその結果を提示できる場合に限り、先に進みます。根拠が不足している場合は、担当のグリルに確認すべき不足事項をまとめて1つのリストにして返し、そこで終了します。

チャットでの直接回答はいつでも受け付けます。ブラウザー支援ツールを強制せず、同じ判断セットに照らして内容を調整してください。

2. 判断セットを整える

確認済みの事実はrecapに、未解決の重要事項はすべてquestionsに記載します。確認済みの判断を再び問うことも、未解決の事項をコンテキストに隠すことも避けてください。依存関係のある質問は筋道立てて並べ、別々の判断を含む質問は分割してください。

各質問について：

• グリルの質問を、会話記録がなくても読者が判断できるsourceQuestionに書き換えます。回答を左右する要素、つまり利害、拘束力のある制約、最悪のケースはすべて残し、他のフィールドにすでに記載されている説明、言い換え、背景情報は省きます。判断に関わる内容がまだ収まらない場合、その質問には複数の判断が含まれています。圧縮して削るのではなく、分割してください。
• 具体的なscenarioを1つ、判断に関係するcontextの事実を最大3つ、区別できる選択肢を2〜4つ追加します。これらは判断を説明するものであり、判断そのものを置き換えたり、再定義したりするものではありません。
• 各選択肢のnoteには、具体的な影響またはコストを記載します。
• 確立済みの根拠が裏付ける場合に限り、recommendationを含めます。これはあくまで助言であり、事前選択してはいけません。

ユーザー向けの文章は、正確な技術テキストを保持したうえで、繁体字中国語を使用してください。元の質問や結果の意味を弱めず、補足情報を読みやすくまとめます。

3. 作成して開く

assets/questionnaire-template.htmlは、レンダラーであり、操作方法の仕様でもあります。埋め込みの検証機能が、ペイロードのフィールド、識別子、制限、構造上の完全性についての唯一の情報源です。ここでこれらの機械的なルールを再度説明しないでください。

ファイル書き込みツールを使って、判断データをオペレーティングシステムの一時ディレクトリにJSONペイロードファイルとして保存し、現在のオペレーティングシステムに対応するビルダーを実行します。パスは、このスキルのディレクトリからの相対パスです。

ビルダーが受け取るのはファイルパスのみです。ヒアドキュメント、echo、-cを使って、ペイロードをシェルコマンドに直接埋め込んではいけません。約8 KBを超えるシェルコマンドは転送中に切り詰められ、シェル構文エラーで失敗します。同じコマンドをツールの外で実行すると成功します。テンプレートを手動で編集したり、ビルダーの代わりに以前の質問票をコピーしてテンプレートとして使ったりしてはいけません。

Windows：

powershell.exe -NoProfile -File scripts/build-questionnaire.ps1 -Data <payload.json>

macOS：

sh scripts/build-questionnaire.sh <payload.json>

各ビルダーは、リポジトリ、インストール済みスキル、共有状態の外にある、一意の一時パスに自己完結型のHTML質問票を1つ書き込み、既定のブラウザーで開きます。出力されたARTIFACT=<path>を成果物の受け渡しを保証するものとして扱い、LAUNCH=accepted|failedをその成果物についての最終的なブラウザー起動結果として扱います。起動に失敗した場合は、引き継ぎを失敗とせず、クリック可能な成果物パスを提示します。

4. 返却して一時停止する

クリック可能な成果物パスと、ビルダーの起動結果を返します。ユーザーに回答し、**「回答を整理する prompt」**を選択して、結果を元の会話に貼り付けるよう依頼します。担当のグリルは一時停止してください。

回答が返ってきたら：

• 明示された選択と条件を尊重します。
• メモのみの回答は、その記述に沿って解釈します。曖昧さのない判断が示されていない場合、その質問は未解決のままにします。表示されたガイダンスを代わりに採用してはいけません。
• required、推奨、緊急度にかかわらず、空欄の質問はすべて未解決のままにします。
• 未解決の質問が残っている場合は、すべてまとめて確認します。元のワークフローを再開するのは、未解決の質問がなくなった場合、またはユーザーが表示された残りの推奨事項を明示的に受け入れた場合に限ります。