asc-testflight について
asc-testflight は TestFlight のベータグループとテスターを管理するコマンドラインスキルです。応答にすぐ実行できる次のコマンドを含み、CSV のインポートとエクスポートにも対応します。
主な機能
- 01ベータグループとテスターの一覧表示
- 02テスターの CSV インポートとエクスポート
- 03次の操作に使えるコマンドの提示
- 04JSON、テーブル、Markdown 形式での出力
活用シーン
- 01アプリのベータグループの確認
- 02グループ内テスターの確認
- 03テスター一覧のインポートとエクスポート
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ tddworks/ asc-cli-skills --skill asc-testflightインストール後、Claude Code で/asc-testflightを入力して読み込まれたか確認します。
同梱ファイルreferences/commands.md
詳細
asc による TestFlight ベータテスター管理
TestFlight の配布に向けて、ベータグループとテスターを管理します。
認証
TestFlight のコマンドを実行する前に、認証情報を設定してください。
asc auth login --key-id <id> --issuer-id <id> --private-key-path ~/.asc/AuthKey.p8
CAEOAS — 次のステップを示すアフォーダンス
すべての JSON レスポンスには、すぐに実行できるコマンドを含む "affordances" が含まれます。
BetaGroup のアフォーダンス:
{
"id": "g-abc123",
"appId": "6450406024",
"name": "External Beta",
"affordances": {
"listTesters": "asc testflight testers list --group-id g-abc123",
"importTesters": "asc testflight testers import --group-id g-abc123 --file testers.csv",
"exportTesters": "asc testflight testers export --group-id g-abc123"
}
}
BetaTester のアフォーダンス:
{
"id": "t-xyz789",
"groupId": "g-abc123",
"email": "[email protected]",
"affordances": {
"listSiblings": "asc testflight testers list --group-id g-abc123",
"remove": "asc testflight testers remove --group-id g-abc123 --tester-id t-xyz789"
}
}
アフォーダンスのコマンドをそのままコピーしてください。ID を調べる必要はありません。
App ID の解決
project-context.md を参照してください。ユーザーに確認したり、asc apps list を実行したりする前に、.asc/project.json を確認します。
一般的なワークフロー
APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')
# If empty: ask user or run `asc apps list | jq -r '.data[0].id'`
# 1. Find beta groups for an app
asc testflight groups list --app-id "$APP_ID" --pretty
# 2. List testers in a group (copy affordance "listTesters" from step 1)
asc testflight testers list --group-id g-abc123 --pretty
# 3. Add a single tester
asc testflight testers add \
--group-id g-abc123 \
--email [email protected] \
--first-name Jane \
--last-name Doe
# 4. Remove a tester (copy affordance "remove" from tester JSON)
asc testflight testers remove --group-id g-abc123 --tester-id t-xyz789
# 5. Bulk import from CSV (header row required: email,firstName,lastName)
asc testflight testers import --group-id g-abc123 --file testers.csv
# 6. Export to CSV (pipe to file or use redirect)
asc testflight testers export --group-id g-abc123 > testers.csv
# 7. Clone a group's testers to a new group
asc testflight testers export --group-id g-abc123 > testers.csv
asc testflight testers import --group-id g-new456 --file testers.csv
CSV 形式
CSV のインポート/エクスポートでは、ヘッダー行が必要です。firstName と lastName は省略できます。
email,firstName,lastName
[email protected],Jane,Doe
[email protected],John,Smith
[email protected],,
出力フラグ
--pretty # Pretty-print JSON
--output table # Table format
--output markdown # Markdown table
コマンドの完全なリファレンス
すべてのフラグ、フィルター、例については、commands.md を参照してください。
コメント
Markdown 対応