arXiv論文メモ
新着一覧
cs.SE · 査読状況未確認

GitHubのエージェント定期作業指示を調べる

Specifying and Maintaining Agentic Workflows: An Empirical Study of GitHub Agentic Workflows

Jasem Khelifi, Issam Oukhay, Ali Ouni, Mohammed Sayagh, and Mohamed Aymen Saied

この論文をやさしく読む

ひとことで言うと

GitHubでエージェントに定期作業を任せる指示ファイルが、どう書かれ更新されるかを実データで調べた。

何に役立つ?

エージェント用の作業仕様を維持するとき、指示の長さ、更新、保護策の書き方を検討する材料になる。

この研究の面白いところ

1,248ファイルを調べ、プロンプトインジェクション防御を明示するものは9.4%だった。

どこまで分かった?

調査対象はgh-awを使う276リポジトリのファイルであり、すべてのエージェント運用へ直接一般化できない。

v1のアブストラクトに基づくAI解説。日本語訳とは別に、用途の解釈を含みます。

アブストラクトの日本語訳

エージェント型の作業手順は、個別の仕事ごとにAIエージェントへ依頼する形から、自動実行される繰り返しの仕事を定義する形へソフトウェア開発を変えている。GitHub Agentic Workflows(gh-aw)では、自然言語の指示と設定を合わせたMarkdownファイルを、実行可能なGitHub Actionsの作業手順へ変換できる。従来の手順が主に決められた操作を指定するのに対し、これらは解釈を要する作業をAIエージェントへ委ね、実行契機と指示を結び付けるため、繰り返すリポジトリ作業の運用上の仕様にもなる。しかし開発者が仕様をどう構成・維持し、どの実行要件や保護策を書くかは十分に分かっていない。本研究は、gh-awのMarkdownファイルの構造、変化、指示内容を調べる。276リポジトリの1,248ファイル、20,841件のコミットとファイルの組み合わせの出来事、294ファイルから抽出した標本のうち判断が確定した288組の指示ラベルを分析した。指示の長さの中央値は556.5語で、62.1%のファイルにコードブロックがあり、短い依頼文を超えていた。少なくとも120日の活動が観測されたファイルの78.2%は4か月目にも更新され、ファイルサイズで正規化した変更量は最初の月の後に減った。ラベル付けされた手順の93%超に、作業、出力、制約、手順の各指示があった一方、プロンプトインジェクションへの防御を明示したのは9.4%だけだった。言語モデルによる分類は、人間が確定したラベルに対してF1=0.818、Cohenのκ=0.715だった。結果は、開発者がリポジトリ間で複製・参照される手順の変化を考慮し、必要に応じてプロンプトインジェクション防御、資源予算、証拠の信頼性確認を加えるべきだと示唆する。

v1の要旨から自動生成。本文の精読・人による確認は未実施。

初稿
2026-09-23(UTC)
最新改訂
2026-09-23 · v1
査読・掲載
査読状況未確認
arXivで読むPDF

更新履歴

取得できた版を表示。版の更新は査読済みを意味しません。過去版の本文差分は未解析です。

原文の要旨

Agentic workflows shift software development from prompting AI agents for individual tasks to defining recurring work that agents execute automatically. GitHub Agentic Workflows (gh-aw) enables this approach through Markdown files that combine natural-language instructions with configuration and compile into executable GitHub Actions workflows. Unlike conventional workflows that primarily prescribe scripted operations, these files delegate tasks requiring interpretation to AI agents. They also couple agent instructions with execution triggers, making those instructions operational specifications for repeated repository activities. However, how developers structure and maintain these specifications, and which execution requirements and safeguards they express, remains insufficiently understood. In this paper, we examine the structure, evolution, and instruction content of gh-aw Markdown files to inform how practitioners define and maintain agent-run work. We analyze 1,248 files from 276 repositories, 20,841 commit-file events, and 288 resolved instruction-label sets from a sample of 294 files. Our results show that workflow instructions extend beyond short prompts, with a median of 556.5 words and code blocks in 62.1% of files. Among files with at least 120 days of observed activity, 78.2% still receive updates in month 4, while size-normalized churn decreases after the first month. Tasks, outputs, constraints, and process instructions each appear in over 93% of labeled workflows, yet only 9.4% explicitly address prompt-injection defense. LLM classification achieves an F1 score of 0.818 and Cohen's Kappa of 0.715 against the resolved human labels. These findings suggest that developers should account for the evolution of workflows copied or referenced across repositories and consider adding prompt-injection defenses, resource budgets, and evidencecredibility checks where applicable.

arXiv ID: 2609.27263 / 要約の誤りについて