runhuman-testing について
AI コーディングツールとオンデマンドの人間テスターをつなぐ CLI スキルです。自然言語でテストを依頼し、構造化された指摘や録画などの結果を取得できます。
主な機能
- 01人間によるテストジョブの作成と管理
- 02再利用可能なテンプレートと出力スキーマ
- 03デスクトップまたはモバイル端末の指定
- 04ジョブの完了待機と構造化結果の取得
- 05指摘の課題トラッカーへの登録(任意)
活用シーン
- 01サインアップやチェックアウトフローのテスト
- 02ビジュアルや UX のフィードバック収集
- 03モバイル対応やブラウザーの確認
- 04ステージングサイトでの探索的テスト
MCP 対応
README では MCP の `create_job` ツールに言及しています。Runhuman はテストジョブを作成・管理する CLI も提供します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ volter-ai/ runhuman-skills --skill runhuman-testingインストール後、Claude Code で/runhuman-testingを入力して読み込まれたか確認します。
同梱ファイルREADME.mdLICENSE
詳細
Runhuman CLI
Runhumanは、AIコーディングツールとオンデマンドのプロの人間テスターをつなぎます。テスト内容を自然言語で説明すると、実際の人間がテストを実施し、構造化されたフィードバックが返されます。
Runhumanを使用する場面
適している用途: ユーザーフロー(登録、チェックアウト)、ビジュアルやレイアウトのテスト、モバイル対応、UXフィードバック、探索的テスト、クロスブラウザーチェック。
適していない用途: 単体テスト、パフォーマンスベンチマーク、セキュリティ監査、高頻度の自動テストスイート。
クイックスタート
# 1. Install (or use npx runhuman for any command without installing)
npm install -g runhuman
# 2. Authenticate (opens browser for GitHub OAuth)
runhuman login
# 3. Set up a project
# List existing projects:
runhuman projects list
# Or create a new one:
runhuman projects create "My App" --organization <orgId> --default-url https://staging.myapp.com --set-default
# Switch to an existing project:
runhuman projects switch <projectId>
# 4. Create a test
runhuman job create https://staging.myapp.com \
-d "Test the signup flow: click Sign Up, fill the form, verify confirmation page"
新規プロジェクトと既存プロジェクトの選択: 新しいプロジェクトを作成するか、既存のプロジェクトを使うかをユーザーに確認します。runhuman projects listで既存のプロジェクトを表示し、--set-defaultを指定してprojects createを実行するか、projects switchを実行してアクティブなプロジェクトを設定します。デフォルトでは、projects switchはグローバル(~/.config/runhuman/config.json)にデフォルトを設定します。現在のディレクトリだけにローカル設定するには、--global falseを指定します。
デフォルトの設定: runhuman config set <key> <value>を使って、project、color、apiUrlなどのデフォルトを設定します。設定階層全体を確認するには、runhuman config listを使います。
ローカルリポジトリ設定: runhuman initを実行すると、プロジェクト名、デフォルトの所要時間/デバイスクラス、1つ以上のリンク済みGitHubリポジトリを含む.runhumanrcが現在のディレクトリに作成されます。プロンプトを省略するには--yesを指定します。または、--name、--github-repo <owner/repo>、--github-repos <a/b,c/d>を指定して、対話なしで値を設定します。
ジョブコマンドの名前空間
すべてのジョブコマンドはrunhuman jobの下にあります。
runhuman job create # create a new test
runhuman job status # check a job's status
runhuman job wait # block until a job completes
runhuman job results # view detailed results
runhuman job list # list jobs (with filters)
runhuman job watch # tail a live job
runhuman job artifact # download a raw session artifact
runhuman job share # toggle public sharing on
runhuman job unshare # toggle public sharing off
runhuman job create-issue # file an extracted finding as a GitHub issue
非推奨のフラット形式のショートカット。 以前のフラット形式(
runhuman create、runhuman status、runhuman wait、runhuman results、runhuman list、runhuman watch)も引き続き解決されますが、1行の非推奨警告が出力され、削除が予定されています。新しいスクリプトでは、必ずrunhuman job <subcommand>を出力してください。フラット形式のショートカットを呼び出す記述は追加しないでください。
IDの省略形
すべてのコマンドは、gitの短縮ハッシュと同様に、IDの先頭部分を省略して指定できます。CLIが最適な一致を自動的に解決します。
runhuman job status 712e # resolves to full job ID
runhuman projects switch proj # resolves to matching project
複数のIDが一致した場合、CLIはさらに文字を指定するよう求めます。破壊的操作(projects delete、keys delete、projects transfer --to-org)には完全なIDが必要です。
結果を待つ
# Block until the test completes (useful in CI/CD)
runhuman job create https://staging.myapp.com \
-d "Test checkout flow end-to-end" \
--sync
# Check status of an existing job
runhuman job status <jobId>
# Wait for a previously-created job to finish
runhuman job wait <jobId>
# View detailed results
runhuman job results <jobId>
テストの作成
job createコマンドは、テストを送信する主な方法です。最低限、URLと説明またはテンプレートのいずれかを指定してください。
説明を指定する場合
runhuman job create https://staging.myapp.com \
-d "Test the signup flow: click Sign Up, fill the form, verify confirmation page"
出力スキーマを指定する場合
構造化されたJSON結果を取得するには、--schemaまたは--schema-inlineを使います。
# Schema from a file
runhuman job create https://staging.myapp.com \
-d "Test the search feature" \
--schema ./search-schema.json \
--sync --json
# Inline schema
runhuman job create https://staging.myapp.com \
-d "Test signup and login" \
--schema-inline '{"signupWorks":{"type":"boolean"},"loginWorks":{"type":"boolean"},"issues":{"type":"array","items":{"type":"string"}}}' \
--sync --json
スキーマファイルの例(search-schema.json):
{
"searchWorks": {
"type": "boolean",
"description": "Does the search return results?"
},
"resultCount": {
"type": "number",
"description": "Number of results shown"
},
"issues": {
"type": "array",
"description": "List of any bugs or issues found"
}
}
スキーマを指定したジョブが完了すると、runhuman job results <jobId> --jsonは標準エンベロープ内のdata.result.dataに抽出データを返します。
{
"success": true,
"data": {
"jobId": "job_abc123",
"status": "completed",
"result": {
"passed": true,
"explanation": "All tests passed successfully",
"data": {
"searchWorks": true,
"resultCount": 10,
"issues": []
}
},
"costUsd": 0.18,
"testDurationSeconds": 120
}
}
抽出されたスキーマデータのみを取得するには、--schema-onlyを使います:runhuman job results <jobId> --schema-only。
テンプレートを指定する場合
テンプレートは再利用可能なテスト設定です。--templateで名前を指定するか、--template-fileでローカルの.mdファイルを指定します。
# By name (resolved from repo .runhuman/templates/ → project templates → built-ins)
runhuman job create https://staging.myapp.com --template "Find Bugs"
# By local file path
runhuman job create --template-file .runhuman/templates/smoke-test.md
テンプレートを使う場合、URLと説明は省略できます。テンプレート自体から取得できるためです。
デバイスクラス
テスターが使うデバイスを指定するには、--device-class desktopまたは--device-class mobileを指定します。
runhuman job create https://staging.myapp.com -d "Test mobile layout" --device-class mobile
テスタープールの要件
ジョブの対象となるテスターを絞り込みます。Max/Enterprise/Enterprise Pro プランのみが対象です。下位プランでは、サーバーがアップグレードリンクとともにジョブの作成を拒否します。ユーザーが対象プランを利用していると伝えている場合、またはプールの絞り込みを明示的に依頼している場合を除き、これらのフラグは追加しないでください。
| フラグ | 値 | マッチ条件 |
|---|---|---|
--required-devices | カンマ区切り:ios、android、pc、mac | いずれか — テスターは少なくとも1つに対応している必要があります |
--required-languages | カンマ区切り:english、spanish | すべて — テスターは指定した言語をすべて話せる必要があります |
--require-social-videos | ブール値 | — |
--require-sideload | ブール値 | --required-devices ios または android と併用します |
つまり、--required-languages english,spanish は、どちらか一方ではなく、両方を話せるテスターを必要とします。--require-sideload は、モバイルアプリ(Android APK または iOS IPA)をサイドロードできるテスターを必要とします。
runhuman job create https://staging.myapp.com \
-d "Test the checkout flow on Android" \
--required-devices android
複数リポジトリのコンテキスト
ジョブは1つ以上の GitHub リポジトリにリンクでき、AI が抽出した所見をイシューとして登録できます。リポジトリは次の3つの方法で指定できます。
# Single repo (back-compat flag)
runhuman job create https://staging.myapp.com -d "Test checkout" \
--github-repo owner/repo
# Multiple repos, comma-separated
runhuman job create https://staging.myapp.com -d "Test checkout" \
--github-repos "owner/frontend,owner/backend"
# Or inherit from the project / template / .runhumanrc default
runhuman job create https://staging.myapp.com -d "Test checkout"
--auto-create-github-issues を追加すると、ジョブの完了後、AI が抽出した各所見をサーバーが自動的に GitHub のイシューとして登録します。少なくとも1つのリポジトリがリンクされている必要があります(上記のフラグ、テンプレート、またはプロジェクトのデフォルト設定で指定)。
所見のイシューへの自動登録
ジョブの完了後、サーバーは AI が抽出した所見をトラッカーに直接登録できます。トラッカーごとにオプトイン用のフラグがあり、組み合わせて使用できます。
| フラグ | 効果 |
|---|---|
--auto-create-github-issues | 所見を GitHub のイシューとして登録します(リンク済みのリポジトリが必要です) |
--auto-create-github-issues-repo <owner/repo> | リンク済みリポジトリの中から特定のリポジトリを対象にします |
--auto-create-github-feedback | AI フィードバックの分類からもイシューを登録します(バグだけではありません) |
--auto-create-jira-issues | 所見を Jira のイシューとして登録します |
--auto-create-jira-feedback | フィードバックの分類からも Jira のイシューを登録します |
--auto-create-linear-issues | 所見を Linear のイシューとして登録します |
--auto-only-tester-surfaced | テスターが明示的に報告した所見のみを登録します(テレメトリのみの所見は除外) |
--reopen-on-duplicate | 重複する所見の対象がクローズ済みのイシューの場合、そのイシューを再オープンします(デフォルト:クローズ状態を維持) |
--comment-on-duplicate | 所見が既存のイシューと一致する場合、新しいイシューを作成する代わりに相互参照コメントを投稿します |
Jira および Linear への登録には、プロジェクトで該当する連携が接続されている必要があります。GitHub のフラグには、少なくとも1つのリポジトリがリンクされている必要があります。
動画の強化と指示の書き換え
--enhanced-video— 生の画面録画に加えて、ロゴのオープニングとエンディング、字幕の焼き込み、重要な場面のオーバーレイを含む強化版動画を生成します。--enhance-instructions— 投稿前に、プロジェクトのナレッジベースを使ってテスター向けの指示を書き換えます(Enterprise 以上。プロジェクトでナレッジベースの実行が正常に完了している必要があります)。
通知と組織の指定
ジョブごとの通知設定の上書きには、inherit(デフォルト — プロジェクトの設定、次にアカウントの設定を適用)、always、または never を指定します。
runhuman job create https://staging.myapp.com -d "Test checkout" \
--email always --in-app never \
--email-on-failure always --in-app-on-failure always
アカウントが複数の組織に属している場合、-o, --organization <id> を渡すと、特定の組織をジョブの対象にできます(job rerun および MCP の create_job ツールと同等の機能です)。
非同期ワークフロー(作成、待機、結果取得)
--sync を使わない場合は、先にジョブを作成してから、別途完了を待ちます。
# 1. Create the job (returns immediately)
JOB_ID=$(runhuman job create https://staging.myapp.com -d "Test search" --json | jq -r '.data.jobId')
# 2. Wait for the tester to complete (blocks with live status updates)
runhuman job wait "$JOB_ID"
# 3. Get the results
runhuman job results "$JOB_ID" --json
job wait は --timeout <seconds> を受け付けます(デフォルト:600)。スクリプトや自動化で構造化出力が必要な場合は、任意のコマンドで --json を使用してください。JSON レスポンスは安定した形式で、リストのペイロードは data.items に、単一エンティティのペイロードは data に直接格納されます。
job status と job wait はどちらも、画面録画をダウンロードできる状態かを示す Recording: 行を出力します(Ready to download、Processing、または録画がない場合は表示なし)。録画のアーティファクトを取得する前に、この表示を確認してください。
テンプレート
テンプレートでは、テスト対象、テスト時間、収集する結果を定義します。ソースは3つあり、次の順に確認されます。
| ソース | 場所 | 作成方法 |
|---|---|---|
| リポジトリテンプレート | ユーザーのリポジトリ内の .runhuman/templates/*.md | Markdown ファイルをコミットします |
| プロジェクトテンプレート | Runhuman データベースに保存 | templates create またはダッシュボード |
| 組み込みテンプレート | Runhuman に同梱 | 自動的に利用できます |
組み込みテンプレート
一般的な QA シナリオに対応する3つの組み込みテンプレートがあります。
| テンプレート | 内容 |
|---|---|
| バグを見つける | アプリをテストし、深刻度、再現手順、期待される動作を含むバグレポートを作成します |
| UX を評価する | 使いやすさ、ビジュアルデザイン、モバイル対応を評価し、1〜10で採点します |
| 製品へのフィードバックを提供する | 第一印象、長所、短所、提案について、率直なフィードバックを提供します |
リポジトリテンプレート
リポジトリテンプレートは、YAML フロントマターを含む .runhuman/templates/ 内の .md ファイルです。
---
name: Smoke Test
duration: 5
device_class: desktop
url: https://staging.example.com
---
Verify the app loads and core features work:
1. Load the homepage and confirm it renders without errors
2. Navigate to the login page and verify the form appears
3. Check that the main navigation links work
## Results
Page loads without errors: [ ]
Login form is accessible: [ ]
Navigation works: [ ]
Issues found: ___
フロントマターのフィールド(すべて任意):name、duration(分、1〜60)、device_class(desktop/mobile)、url、max_extension_minutes、extension_count、github_repos(owner/repo 文字列の YAML リスト)。
CLI でプロジェクトテンプレートを作成する
runhuman templates create "Search Test" \
--project proj_abc123 \
-d "Search for 'recursion' and confirm the joke appears" \
--schema ./search-test-schema.json
オプション:--duration <minutes>(1〜60)、--device-class <class>、--schema <path>。
テンプレートを一覧表示するには:runhuman templates list --project <projectId>
ジョブの出力:結果、アーティファクト、共有、イシュー
job results は概要を確認するためのコマンドです。生データへのアクセスや後続の操作には、ほかに4つのサブコマンドを利用できます。
# High-level results view (with optional rich-data flags)
runhuman job results <jobId>
runhuman job results <jobId> --transcript --console-logs
runhuman job results <jobId> --all # every rich section
runhuman job results <jobId> --schema-only # just extracted schema data
runhuman job results <jobId> --raw # raw tester response
# Download a single raw artifact (good for piping)
runhuman job artifact <jobId> transcript
runhuman job artifact <jobId> console-logs --json | jq '.data.consoleMessages[]'
# Other types: structured-output, network-requests, conversation, events, key-moments
# Toggle public sharing — `share` prints the public URL
runhuman job share <jobId>
runhuman job unshare <jobId>
# File one extracted finding as a GitHub issue
runhuman job create-issue <jobId> --index 0
runhuman job create-issue <jobId> --index 0 --repo owner/repo # override default
詳細データのセクション(transcript、logs、network、events、key-moments、conversation)と、対応する job artifact のタイプは、サーバー側で有料プラン限定となっています。制限対象のリクエストには、「サブスクリプションが必要です」というエラーが返されます。
job create-issue は、ダッシュボードの各検出結果にある「Create Issue」ボタンと同様に、検出結果を編集せずに送信します。タイトルや本文を後から編集する場合は、ダッシュボードまたは gh issue edit を使用してください。
プロジェクト
runhuman projects list
runhuman projects create "My App" --organization <orgId> [--default-url <url>] [--github-repo <owner/repo>] [--github-repos <a/b,c/d>] [--set-default]
runhuman projects show <projectId>
runhuman projects update <projectId> [--name <text>] [--default-url <url>] [--github-repo <owner/repo>] [--github-repos <a/b,c/d>]
runhuman projects switch <projectId> # `--global false` for current dir only
runhuman projects transfer <projectId> --to-org <orgId> # full IDs required
runhuman projects delete <projectId> --force # full ID required
--github-repo は単一の owner/repo を受け付けます。--github-repos はカンマ区切りのリストを受け付け、プロジェクトのリポジトリ一覧に追加するのではなく、置き換えます。
組織
runhuman orgs list
runhuman orgs show <orgId>
runhuman orgs balance <orgId>
runhuman orgs projects <orgId>
runhuman orgs switch <orgId> # `--global` (default) or local
# Membership
runhuman orgs members <orgId>
runhuman orgs invite <orgId> <email> --role <admin|contributor|viewer>
runhuman orgs remove <orgId> <userId>
# Pending invitations
runhuman orgs invitations list --organization <orgId>
runhuman orgs invitations revoke <invitationId> --organization <orgId> --yes
# Usage analytics
runhuman orgs usage # current org, last 30 days
runhuman orgs usage --period 7d # 7d | 30d | 90d | all
runhuman orgs usage --year 2026 --month 4 # specific month (year+month)
runhuman orgs usage --json # full response, incl. overTime / byHour / bySource
orgs invite のデフォルトは --role contributor です。--organization を省略した場合、invitations list/revoke と usage ではデフォルト組織のコンテキストが使用されます。
請求
ユーザー単位の読み取り操作です。購入手続きとプラン変更はウェブ UI で行います。billing portal を使用してアクセスしてください。
runhuman billing balance # credit balance for primary org (or --organization)
runhuman billing subscription # current tier, period, add-ons
runhuman billing portal # one-time URL to the Polar customer portal
runhuman billing portal --open # open it in the default browser
テスター向けメモ(有料機能)
メモはナレッジベースのエントリで、追加のコンテキストとしてテスターに表示されます。利用には有効な組織サブスクリプションが必要です。サブスクリプションがない場合、呼び出しはサブスクリプションが必要であることを示すエラーを返します。
runhuman notes list # everything visible to you
runhuman notes list --search "checkout" --tags "context,gotcha"
runhuman notes show <noteId>
runhuman notes create "Auth context" -b "Use the demo account..." --tags "context"
runhuman notes create "Auth context" --body-file ./note.md --project <projectId>
runhuman notes update <noteId> [--title <t>] [--body <text> | --body-file <path>] [--tags <list>] [--public|--internal]
runhuman notes delete <noteId> # full ID required
メモはデフォルトで内部限定です。顧客に表示するには、create/update で --public を指定してください。デフォルトでは組織が対象になります。単一のプロジェクトを対象にするには、--project を指定してください。
GitHub 連携
runhuman github link <owner/repo> --project <projectId>
runhuman github repos --organization <orgId> [--search <query>]
runhuman github issues <owner/repo> [--state open|closed|all] [--labels "bug,needs-qa"]
runhuman github test <issueNumber> -r <owner/repo> -u <url> [--template <id>] [--sync]
runhuman github bulk-test -r <owner/repo> -u <url> [--labels <list>] [--state <state>] [--limit <n>]
# Force-refresh a GitHub App installation's repo/permissions list — use after granting
# the app access to new repos if they don't show up in `github repos` yet.
runhuman github installation refresh --installation <installationId> --organization <orgId>
スケジュールと転送
# Recurring scheduled jobs (cron-style)
runhuman schedules list
runhuman schedules create / show / update / delete # see --help for each
# Project transfers (accept/reject/cancel a transfer to/from another org)
runhuman transfers list
runhuman transfers accept <transferId>
runhuman transfers reject <transferId>
runhuman transfers cancel <transferId>
すべての機能については、runhuman schedules --help と runhuman transfers --help を実行してください。
認証、初期化、設定
# Auth
runhuman login # browser OAuth
runhuman login --token <apiKey> # non-interactive
runhuman logout
runhuman whoami
# Initialize a local .runhumanrc
runhuman init
runhuman init --name "My App" --github-repos "owner/frontend,owner/backend" --yes
# Config
runhuman config get <key>
runhuman config set <key> <value> [--global]
runhuman config list [--show-secrets]
runhuman config reset --project|--global|--all --force
設定の優先順位:CLI フラグ > 環境変数(RUNHUMAN_API_KEY、RUNHUMAN_API_URL、RUNHUMAN_PROJECT_ID、RUNHUMAN_NO_COLOR)> .runhumanrc(プロジェクト)> ~/.config/runhuman/config.json(グローバル)> デフォルト。
コマンドグループ
任意のコマンドの詳細な使用方法を確認するには、runhuman <command> --help を実行してください。
| グループ | コマンド | 目的 |
|---|---|---|
| ジョブ | job create, status, wait, results, list, watch, artifact, share, unshare, create-issue | QA テストジョブを作成・管理します(標準の名前空間) |
| 認証 | login, logout, whoami | 認証 |
| 初期化 | init | カレントディレクトリに .runhumanrc を初期設定します |
| プロジェクト | projects list, create, show, update, switch, transfer, delete | プロジェクトを管理します |
| 組織 | orgs list, show, balance, projects, switch, members, invite, remove, invitations, usage | 組織とメンバーシップを管理します |
| 請求 | billing balance, subscription, portal | ユーザー単位の請求情報を読み取ります |
| テンプレート | templates list, create, show, update, delete | 再利用可能なテスト設定 |
| スケジュール | schedules list, create, show, update, delete | 定期的なスケジュール済みジョブ |
| 移管 | transfers list, accept, reject, cancel | 組織間のプロジェクト移管 |
| API キー | keys list, create, show, delete | API キーを管理します |
| GitHub | github link, repos, issues, test, bulk-test, installation refresh | GitHub 連携 |
| メモ(有料) | notes list, show, create, update, delete | テスター向けナレッジベースのメモ |
| 設定 | config get, set, list, reset | CLI 設定 |
注意: フラット形式のジョブ用ショートカット(
runhuman create、status、wait、results、list、watch)は非推奨です。新しいスクリプトでは必ずrunhuman job <sub>形式を使用してください。
効果的なテストの説明の書き方
-d / --description フラグは、テストで最も重要な部分です。具体的に記述してください。
良い例:
Test the checkout process:
1. Add a product to cart
2. Click "Checkout"
3. Fill shipping address
4. Complete purchase
Report: bugs, UX confusions, mobile layout issues
悪い例:
Test the site
ヒント:
- 実行する正確な手順やフローを含めます
- 操作するページやボタンを指定します
- 確認すべき項目(バグ、UX 上の問題、視覚的な問題)を明記します
- モバイルテストの場合は、その旨を説明に明記します
プロジェクトにリポジトリが接続されている場合、Runhuman はコードベースを学習しているため、より豊富で詳細なテスト結果が返され、検出事項に直接対応できます。コードコンテキストのドキュメントを参照してください。
CI/CD 連携
ユーザーから CI/CD、GitHub Actions、またはパイプラインでの QA 自動化について質問された場合:
https://runhuman.com/for_agents_github_actions.mdにある包括的なエージェントガイドを取得し、その手順に従って設定方法をユーザーに案内してください。このガイドでは、PR をトリガーとするテスト、スケジュールされた探索的 QA、オンデマンドテスト、ラベル管理、およびプラットフォーム固有の例(Vercel、Netlify、Fly.io、Railway)を扱います。
最新の Action バージョンの確認: ワークフローファイルを作成する前に、
gh release list --repo volter-ai/runhuman-action --limit 1を実行するか、https://github.com/volter-ai/runhuman-action/releasesを確認して、GitHub Action の最新リリースを調べてください。古いバージョンを固定せず、最新のバージョンタグを使用してください。
GitHub Action の使用(CI/CD に推奨):
# .github/workflows/qa.yml
- name: Run QA tests
uses: volter-ai/runhuman-action@v1 # Check latest version first
with:
url: ${{ env.PREVIEW_URL }}
pr-numbers: '[${{ github.event.pull_request.number }}]'
api-key: ${{ secrets.RUNHUMAN_API_KEY }}
on-success-add-labels: '["qa:passed"]'
on-failure-add-labels: '["qa:failed"]'
fail-on-failure: true
PR をトリガーとするテストのコードコンテキスト: プロジェクトにリポジトリが接続されている場合は、4 つの code-context 入力をまとめて渡し、デフォルトブランチではなく PR の先端のコードがテスト結果に反映されるようにしてください。
- uses: volter-ai/runhuman-action@v1
with:
url: ${{ env.PREVIEW_URL }}
pr-numbers: '[${{ github.event.pull_request.number }}]'
api-key: ${{ secrets.RUNHUMAN_API_KEY }}
enable-code-context: true
commit-sha: ${{ github.event.pull_request.head.sha }}
commit-base-sha: ${{ github.event.pull_request.base.sha }}
wait-for-code-context: true
各入力の役割と、抽出された課題で期待される内容については、コードコンテキストのドキュメントを参照してください。
ワークフローでの CLI の使用:
# Environment variable auth (for CI)
export RUNHUMAN_API_KEY=rh_live_...
# Synchronous test that blocks until complete
runhuman job create https://staging.myapp.com \
-d "Test signup flow" \
--sync \
--wait 300
すべてのコマンドは、機械可読な出力を得るための --json をサポートしています。JSON レスポンスは安定した形式で、成功時は { success, data, pagination?, warnings?, timestamp }、失敗時は { success: false, error: { message, code?, details? }, timestamp } となります。リストコマンドでは項目が data.items に格納され、単一エンティティのコマンドではエンティティが data に格納されます。
終了コード
| コード | 意味 |
|---|---|
0 | 成功 |
1 | 一般エラー |
2 | 認証エラー |
3 | 見つかりません |
4 | 検証エラー |
5 | タイムアウト |
6 | 残高不足(エラー出力内のリンクから資金を追加してください) |
詳しく知る
# Top-level help
runhuman --help
# Help for any command
runhuman job create --help
runhuman projects --help
runhuman orgs invite --help
runhuman github installation refresh --help
リソース
- ウェブサイト: https://runhuman.com
- ダッシュボード: https://runhuman.com/dashboard
- GitHub Action: https://github.com/marketplace/actions/runhuman-qa-test
- GitHub Actions セットアップガイド(エージェント向け): https://runhuman.com/for_agents_github_actions.md - GitHub Actions、CI/CD パイプライン、または QA の自動化について質問された場合は、こちらを取得してください。