val

Val QA scan — GitHub Action

バイブコーディングで作成したアプリの QA エージェントである Val を、すべての PR で実行します。Val はプレビュー URL に対して実際のブラウザーを操作し、リンク切れ、動作しないボタン、レイアウトの崩れ、アクセシビリティ違反を検出して、PR コメントとしてレポートを投稿します。

Val のサブスクリプションが必要です

Val は有料の製品です。val.nyx-intelligence.com でライセンスキーを取得し、リポジトリシークレット（例：VAL_LICENSE_KEY）として保存して、アクションに渡してください。

クイックスタート

name: Val QA
on: pull_request

jobs:
  qa:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy preview
        id: deploy
        # ... your preview deployment step (Vercel, Netlify, etc.) ...
        # outputs.url should be the preview URL

      - name: Val scan
        uses: nyx-intelligence/val-action@v1
        with:
          url: ${{ steps.deploy.outputs.url }}
          license-key: ${{ secrets.VAL_LICENSE_KEY }}
          devices: 'desktop,iPhone 14'
          fail-on: 'high'

入力

名前	デフォルト	説明
url	（必須）	Val がスキャンする URL です。プレビュー環境の URL を指定してください。
license-key	（必須）	Val のライセンスキー（vk_...）です。val.nyx-intelligence.com で取得してください。
max-pages	12	クロールする同一オリジンのページの最大数です。
devices	desktop	カンマ区切りのデバイスプロファイルです。例：desktop,iPhone 14,Pixel 7。
fail-on	high	アクションを失敗とする重要度です。high、medium、low、never のいずれかを指定します。
comment	true	レポートを PR コメントとして投稿します（true ／ false）。
github-token	${{ github.token }}	PR コメントの投稿に使用するトークンです。

出力

名前	説明
high	重要度が高い指摘の数です。
medium	重要度が中程度の指摘の数です。
low	重要度が低い指摘の数です。
report-path	生レポートファイルのパスです。

Val のチェック項目

• リンク切れと 4xx／5xx レスポンス
• 捕捉されていない JS エラーとコンソールエラー
• 破損または欠落した画像
• モバイルでの水平方向のレイアウトのはみ出し
• 固定コンテナー内でのテキストの切り取り
• 累積レイアウトシフト（読み込みのガタつき）
• アクセシビリティの基本項目：alt の欠落、名前のないボタン、ラベルのない入力欄、<html lang> の欠落
• マルチデバイス：モバイルまたはデスクトップでのみ発生するバグを検出

権限

コメントを投稿するには、アクションに pull-requests: write が必要です。

permissions:
  contents: read
  pull-requests: write