Agentの提案ジョブに署名用Secretsまで見えていないか、切り分けに迷っていませんか。

今週は、Agentをリポジトリ分析と変更提案に限定し、Xcodeの構築・テスト・署名は独立したMac CIに残してください。権限、隔離、出力承認を実行ログで検収してから接続します。

対象読者
GitHub Actionsの組織ポリシーと導入条件を決めるIT・プラットフォーム担当者。
iOS公開工程の責任境界を定める開発責任者、資格情報と外部入力を監査するセキュリティ担当者。

最終更新:2026年11月11日。GitHubの正式公開告知、安全アーキテクチャ、Safe Outputs文書を照合しています。機能状態とRunnerの対応範囲は変更されるため、導入時にも最新の安全アーキテクチャを再確認してください。

01

Agentの分析工程とMac CIの構築工程を分ける

GitHubは2026年10月28日にGitHub Agentic Workflowsの一般提供を発表しました。正式公開告知と現行の安全アーキテクチャを前提にしつつ、Agentの処理をそのままXcodeの実行環境とみなさないことが第一の検収条件です。

Issue・Pull Requestなど
        ↓
Agent:リポジトリ分析、問題の分類、変更提案
        ↓  提案とレビュー対象を受け渡す
Safe Outputs・レビュー・ポリシー判定
        ↓
Mac CI:Xcode構築、テスト、署名、アーカイブ、公開判定

公開アーキテクチャが示すRunnerの区分は、GitHubホステッドとLinuxセルフホステッドです。これはMac CIを直接代替できるという意味ではありません。GitHubホステッドRunnerのOSや仕様は変更され得るため、Runnerの公式仕様で実行環境を確かめ、Xcodeを必要とする工程は独立したMacジョブで受け入れ確認します。

工程 検収時に確認する実行場所 合格の証拠
リポジトリ分析・変更提案 Agentのワークフロー 起動イベント、対象リポジトリ、生成された提案
提案の反映 Safe Outputsなどの後続処理とレビュー 実際の書き込み権限、承認者、処理結果
Xcode構築・署名 独立したMac CI Macジョブの実行ログ、テスト結果、署名工程の記録
02

権限の範囲は既定値ではなく実設定で判定する

既定で読み取り中心の権限が使われる場合でも、それだけで企業内の権限審査が済んだとは判断できません。トークンの許可範囲、対象リポジトリ、起動イベント、組織ポリシー、カスタム手順を、実際のワークフロー設定と照合します。イベント、トークン権限、Secretsの公式説明も確認対象です。

担当 許可する操作の例 検収する記録
Agent 分析、分類、変更案の提示 起動イベント、参照範囲、トークン権限
Safe Outputsの後続処理 設定された出力の処理 書き込み可否、処理結果、失敗時の動作
人による承認者 提案の確認、必要な承認 承認者、時刻、承認対象の差分

権限は「誰が何を実行できるか」で記録します。Pull Request由来の入力をどの処理が参照するか、組織やリポジトリのポリシーがワークフローにどう適用されるかも含めてください。例外がある場合は、理由、適用範囲、再確認の担当者を残します。

03

隔離とネットワーク境界は設定変更ごとに見直す

安全アーキテクチャに記載された隔離方式や適用状態は、導入時点の公式文書に基づいて確認します。コンテナやマイクロVMの機能があることだけで、ホスト全体や外部通信まで自動的に隔離されるとは扱わないでください。

特に、カスタム実行手順、マウント、ネットワークの許可リスト、組織ポリシーの例外は、信頼境界を変える変更です。標準設定との差分を記録し、外部入力から実行される可能性と、外部へ送信できる情報を個別に検討します。

隔離方式が有効でも、独自スクリプトや追加のマウントを入れれば検収対象は変わります。設定の説明だけで合格にせず、試行実行でログと通信先を確かめます。

04

署名資格情報はAgentの処理から分離する

Agentの環境に、本番署名用の証明書やSecrets、環境変数、外部サービスの資格情報が見えていないか棚卸しします。分析に不要な資格情報は渡さず、署名、アーカイブ、配布をMac CI側の別ワークフローに配置します。

署名資産の準備や管理は、対象アプリと配布方式に合わせて確認します。Appleの開発用プロビジョニングプロファイル作成手順を参照し、Agentが読む情報とMac CIで使う署名情報を分けたうえで、権限設定と実行ログを照合してください。

05

Safe Outputsの検知と公開承認を別の合格条件にする

Safe Outputsの公式文書を読み、どの出力が制御対象か、検知や失敗が後続処理にどう影響するかを、採用する構成で確かめます。提案された差分、脅威検知の結果、人による承認、リポジトリへの書き込みは、同じ状態として記録しません。

「検知が動いた」だけでは、出力が安全だったことも、公開してよいことも証明できません。検知失敗時に停止するのか、承認がない場合に書き込みを防げるのか、ブランチ保護が適用されるのかを、試験用の変更で確かめます。Safe Outputsを人のレビューやブランチ保護の代替として扱わないでください。

06

今週の受け入れ確認はチェック項目と証跡で残す

代表的なiOSリポジトリで、提案からMac CIの署名引き渡しまでを通して確認します。合否は「Agentが動いたか」ではなく、各段階の権限、結果、承認者を追跡できるかで決めます。

  • [ ] Agentの対象リポジトリ、起動イベント、トークン権限を設定ファイルで確認する。
  • [ ] 組織ポリシーとリポジトリ設定の適用結果を記録し、例外設定に責任者を割り当てる。
  • [ ] Agentが参照できるSecrets、環境変数、外部資格情報を一覧化し、署名用資格情報が含まれないことを確かめる。
  • [ ] カスタム手順、マウント、ネットワーク許可、隔離方式を標準構成と比較する。
  • [ ] Safe Outputsの提案、検知結果、承認、書き込みをログで区別し、失敗時の停止動作も試す。
  • [ ] 同じ変更をMac CIへ渡し、Xcode構築・テスト・署名の結果と資格情報のアクセス記録を保存する。
  • [ ] 失敗時に公開工程を止められること、承認者とブランチ保護の記録を追跡できることを確認する。
判断 満たす条件 次の対応
試験導入へ進む Agentの権限と出力が限定され、Mac CIとの境界をログで確認できる 対象を限定して運用記録を集める
追加対策まで保留 例外設定、資格情報の露出、失敗時の動作が不明 設定を修正し、同じ手順を再実行する
本番導入を見送る 分析ジョブから署名情報へ到達できる、または承認なしの書き込みを止められない 権限設計と公開ゲートを見直す
07

よくある確認事項

Agentの実行場所でXcodeの構築や署名まで完結できますか?

Agentの処理とXcode工程は分けて設計します。公開されているRunner構成だけからMac上のXcode実行を前提にせず、構築、テスト、署名を独立したMac CIで実行してください。対応状況は導入時の公式文書と実環境で再確認します。

企業で有効化する前に、どの権限を洗い出しますか?

トークン権限、対象リポジトリ、起動イベント、組織ポリシー、Secrets、カスタム実行手順を確認します。既定設定を確認したうえで、実際の設定とログを照合し、Agent、後続処理、承認者の操作範囲を表に残します。

Safe Outputsがあれば、人のレビューやブランチ保護は省けますか?

省けません。Safe Outputsの設定、検知、承認、実際の書き込みを別々に検証します。検知の実行だけで公開を許可せず、承認がない場合や検知に失敗した場合に変更が止まるかを試験してください。

AgentからMac CIの署名資格情報をどう分離しますか?

Agent側のSecretsや環境変数に署名情報を置かず、署名工程を別のMac CIワークフローにします。実行権限とログを確認し、資格情報が署名に必要な工程だけで参照されることを受け入れ条件にします。

今の構成をAgentのRunnerだけでXcode CIまで担わせると、実行環境の不一致、署名資格情報の境界、障害時の責任分界が曖昧になりがちです。まずは必要な工程がMac上にあるかを確認し、独立したMac CIが必要で、かつ一時的な検証環境を求める場合は、MESHLAUNCHの案内で確認できる内容を照合してください。継続的な専用運用や物理インターフェースが必要なら、自社保有を含めて比較し、利用地域の情報が必要な場合は日本向けMacの案内で公開内容を確認してから判断します。