Useuser

このスキルを使用すると、ネイティブな macOS システムダイアログを通じてユーザーに質問を投げかけることができます。ユーザーからの直接的な入力、アクション実行前の確認、または確認応答が必要な重要情報の表示が必要な場合に使用します。

このスキルを使う場面

• 確認が必要: 要件が不確かであったり、さらなるコンテキストが必要な場合
• 承認が必須: 破壊的または取り消し不可能なアクションを実行する前
• ユーザーの選好: ユーザーがどのオプションを優先するかを知る必要がある場合
• 重要な通知: ユーザーに重要な事項について警告する必要がある場合
• 必須の質問: ユーザー入力なしに先に進めない場合

利用可能なダイアログタイプ

1. テキスト入力ダイアログ

ユーザーが応答を入力する、オープンエンドな質問を投げかけます。

scripts/ask_text.sh "What is the database connection string?" "postgresql://localhost:5432/mydb" 300

パラメータ:

• $1 - 質問テキスト（必須）
• $2 - デフォルト値（オプション、デフォルトは空）
• $3 - タイムアウト（秒）（オプション、デフォルトは300）。タイムアウトなしの場合は 0 または none を使用します。

返り値: ユーザーが入力したテキスト、キャンセルされた場合は "CANCELLED"、タイムアウトした場合は "TIMEOUT"。

タイムアウトなしの例:

scripts/ask_text.sh "What is your preferred username?" "" 0

2. 複数選択ダイアログ

ユーザーが選択するためのオプションリストを提示します。

scripts/ask_choice.sh "Which authentication method should I use?" "OAuth2" "JWT" "Session-based" "API Keys"

パラメータ:

• $1 - 質問/プロンプトテキスト（必須）
• $2+ - 利用可能な選択肢（最低2つ必須）

返り値: 選択されたオプションのテキスト、キャンセルされた場合は "CANCELLED"。

3. はい/いいえ確認ダイアログ

シンプルなはい/いいえ の回答を取得します。

scripts/ask_confirm.sh "Should I delete the old migration files?" "no" 300

パラメータ:

• $1 - 質問テキスト（必須）
• $2 - デフォルトボタン: "yes" または "no"（オプション、デフォルトは "no"）
• $3 - タイムアウト（秒）（オプション、デフォルトは300）。タイムアウトなしの場合は 0 または none を使用します。

返り値: "YES" または "NO"、キャンセルされた場合は "CANCELLED"、タイムアウトした場合は "TIMEOUT"。

4. 情報ダイアログ

ユーザーの確認応答が必要な情報を表示します。

scripts/show_info.sh "Migration completed successfully! 47 records updated." 300

パラメータ:

• $1 - 表示するメッセージ（必須）
• $2 - タイムアウト（秒）（オプション、デフォルトは300）。タイムアウトなしの場合は 0 または none を使用します。

返り値: 確認応答時は "OK"、キャンセルされた場合は "CANCELLED"、タイムアウトした場合は "TIMEOUT"。

5. システム通知

macOS 通知を送信します（非ブロッキング）。

scripts/notify.sh "Build completed successfully" "Development Server" "Ready for testing" "yes"

パラメータ:

• $1 - 通知メッセージ（必須）
• $2 - タイトル（オプション、デフォルトは "Useuser"）
• $3 - サブタイトル（オプション）
• $4 - 音を再生: "yes" または "no"（オプション、デフォルトは "no"）

返り値: 成功時は "OK"。

使用例

例1: ユーザーの選好を取得する

新しいプロジェクトをセットアップするとき:

# 使用するフレームワークを質問
framework=$(scripts/ask_choice.sh "Which framework should I use for this project?" "React" "Vue" "Svelte" "Angular")

if [ "$framework" != "CANCELLED" ]; then
    echo "User selected: $framework"
fi

例2: 破壊的なアクションを確認する

ファイルを削除する前:

confirm=$(scripts/ask_confirm.sh "This will permanently delete 15 files. Are you sure?" "no")

if [ "$confirm" = "YES" ]; then
    # 削除を進める
    echo "Deleting files..."
else
    echo "Operation cancelled by user"
fi

例3: 設定値を取得する

特定の入力が必要な場合:

api_key=$(scripts/ask_text.sh "Please enter your API key:" "" 120)

if [ "$api_key" != "CANCELLED" ] && [ "$api_key" != "TIMEOUT" ]; then
    echo "API key received"
fi

例4: 長時間実行される操作について通知する

バックグラウンドタスクが完了したとき:

scripts/notify.sh "Database backup completed" "Backup Tool" "All 3 databases backed up successfully" "yes"

エラーハンドリング

すべてのスクリプトはエラーを適切に処理します:

• ユーザーがキャンセル: "CANCELLED" を返す
• タイムアウト: "TIMEOUT" を返す（対応しているダイアログ）
• AppleScriptエラー: "ERROR: <message>" を返す

常に返り値をチェックしてから処理を進めます:

result=$(scripts/ask_confirm.sh "Continue with deployment?")

case "$result" in
    "YES")
        echo "Deploying..."
        ;;
    "NO")
        echo "Deployment cancelled by user"
        ;;
    "CANCELLED")
        echo "Dialog was dismissed"
        ;;
    "TIMEOUT")
        echo "No response received, timing out"
        ;;
    ERROR*)
        echo "An error occurred: $result"
        ;;
esac

ベストプラクティス

1. 具体的に: 明確で、実行可能な答えが得られる質問をします
2. コンテキストを含める: 質問に関連するコンテキストを含めます
3. 適切なダイアログタイプを使用: はい/いいえ は確認、複数の選択肢は選択、オープンエンドな質問はテキスト入力を使用します
4. 合理的なタイムアウトを設定: ユーザーを無限に待たせないが、十分な時間を与えます
5. すべてのケースを処理: キャンセルとタイムアウトのシナリオは常に処理します
6. 割り込みを最小化: 本当に人間の入力が必要な場合のみ質問します
7. 通知は控えめに: 重要で非ブロッキングの更新のために通知を予約します

プラットフォーム要件

• macOS のみ: このスキルは AppleScript を使用して osascript で実行され、macOS でのみ動作します
• ターミナル権限: ターミナルアプリがダイアログを表示するために権限が必要な場合があります（システム設定 > プライバシーとセキュリティ > アクセシビリティ）