GitHub Actions YAML リンター
ブラウザ上で GitHub Actions のワークフロー YAML ファイルをリントします。構文エラー(タブ、閉じていない引用符、重複したキー)、必須キーの欠落(on、jobs)、runs-on や steps のないジョブ、固定されていない action 参照や @main/@master を検出し、重大度の概要と行ごとの問題テーブルとして表示します。
入力
出力
概要
| 重大度 | 件数 |
|---|---|
| No data yet | |
問題
| 行 | 重大度 | メッセージ |
|---|---|---|
| No data yet | ||
このツールを使う他の方法
REST API
curl -X POST https://api.iotools.cloud/v1/tool/github-actions-yaml-linter \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inputYaml": "name: CI\non: [push]\njobs:\n build:\n runs-on: …",
"hints": "true"
}'ご自身のアカウントのキーに差し替えてください。ツールのフィールドがそのままリクエストボディになります——ラッパーはありません。
AIエージェントに依頼する
Use the IOTools `github-actions-yaml-linter` tool (GitHub Actions YAML Linter) on this input:
YOUR_INPUT_HEREIOTools MCPサーバーに接続された任意のエージェントにこれを貼り付け、入力内容を追加してください。
埋め込みウィジェット
<iframe
src="https://iotools.cloud/embed/github-actions-yaml-linter/"
width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
title="GitHub Actions YAML リンター — iotools.cloud"
sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
allow="clipboard-write"
style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>ご自身のページに貼り付けるだけ——無料、キー不要、リンクを掲載するだけです。
| API/MCP 1回あたりの費用 | 5クレジットから |
|---|---|
| クレジットが足りませんか? | 料金を見る |
次の方法でも利用可能
ガイド
GitHub Actions のワークフローファイルを貼り付けるだけで、問題点を行ごとに即座にレポートします。壊れた .github/workflows/*.yml をプッシュして失敗した実行を待つ前に確認できます。このリンターはブラウザ内でワークフローを解析し、Actions のビルドを実際に壊すルールに照らして検査します。結果は重大度の概要と、詳細な問題テーブルにまとめられます。
チェック内容
YAML の構文。 ワークフローが失敗する最も一般的な原因は、不正な形式の YAML です。このリンターは、インデントに使われたタブ文字(YAML はスペースを要求します)、閉じていない引用符、同じマッピング内の重複したキー、周囲のブロックとインデントが揃っていない行を検出します。
必須の構造。 すべてのワークフローには on: トリガーと jobs: ブロックが必要です。通常のジョブには runs-on: ランナーと、steps: 配下の少なくとも 1 つのエントリが必要です。再利用可能ワークフローのジョブ(uses:)では runs-on と steps を宣言してはいけません。キーが欠けている、または場所が誤っている場合は、ジョブ名とともにエラーとして報告されるので、どこを確認すればよいか正確に分かります。
Action の固定とセキュリティ。 actions/checkout@main や @master のように、動くブランチで Action を参照すると、そのブランチが変わるたびにビルドが静かに変化します。これはサプライチェーンのリスクです。このような参照は警告として表示されます。@v4 のようなバージョンタグに固定している場合は、サードパーティ製 Action に対して完全なコミット SHA の使用を勧めるベストプラクティスのヒントが表示されます。@ref が一切ない Action はエラーです。
ベストプラクティスのヒント。 ヒントを有効にすると、リンターは長時間実行されるジョブに timeout-minutes を設定するよう促し、::set-output:: や ::set-env:: のような非推奨のワークフローコマンドを避けるよう案内します。ヒントをオフにすると、重大なエラーと警告だけが表示されます。
使い方
- ワークフローファイルの内容をコピーし、入力ボックスに貼り付けます。
- 概要テーブルで、エラー・警告・ヒントの件数をすばやく確認します。
- 問題テーブルを上から順に確認します。各行には行番号、重大度、分かりやすい説明が表示されます。
- 修正して貼り付け直し、件数がゼロになるまで繰り返します。
問題テーブルはコピーするか、CSV としてダウンロードして、プルリクエストのレビューで共有できます。
ワークフローがどこかにアップロードされますか?
いいえ。解析とリントはすべて、軽量で専用に作られた YAML パーサーを使って、ブラウザ内で完結します。シークレット名や内部のジョブの詳細を含め、ワークフローがお使いのマシンの外に出ることはありません。
これは完全な YAML バリデーターですか?
GitHub Actions のワークフロースキーマに特化しているため、ファイルを汎用の YAML として扱うのではなく、ジョブ、ステップ、ランナー、トリガー、permissions を理解します。この特化があるからこそ、「line 12: bad syntax」のような素っ気ないメッセージではなく、Actions に即した実用的なフィードバックを返せます。