workflow command とは?

workflow command は、step が特別な形式の行を stdout に書き込むことで runner に伝える制御命令です。runner はこれらの行を解釈して、step の output を設定したり、secret をマスクしたり、ログセクションをグループ化したり、annotation を作成したりします。これは、スクリプトが CI エンジンに応答するために使う軽量なプロトコルです。

なぜ重要か

workflow command により、どの言語のどのスクリプトでも、特別な SDK なしで CI 機能を駆動できます。shell の one-liner でも、正しい行を出力するだけで token をマスクしたり、エラー annotation を発行したりできます。これらを知っておくと、値が伝播しなかった理由や、secret がログに漏れた理由をデバッグするのに役立ちます。

関連ガイド