コーディングエージェント運用大全

coding agentはrepository、branch、CI、secrets、dependency、PR、rollbackに作用するため、能力存在とenterpriseでの許可・監査・費用・品質を切り分ける必要がある。

coding / provider mapping / organization overlay / implementation / security / audit / cost

GitHub Copilot cloud agentの現行Docsが示すtask/PR/metrics/availability gateと、GitHub code scanningの補助的役割は何か。coding agent自体の正しさや安全性を確定できるか。

• source class: official product documentation; exact title: About GitHub Copilot cloud agent; author/org: GitHub; canonical URL: https://docs.github.com/en/copilot/concepts/agents/cloud-agent/about-cloud-agent publication/update/access: current page accessed 2026-09-13 JST; version/release/tag/commit/API revision/model ID: Copilot cloud agent current docs; supporting locator: lines 81-85（issue/task assignment、research/plan、custom agents）、86-99（PR lifecycle metrics、external invocation）、102-108（paid plan、admin enable、repository opt-out）、125-129（GitHub Actions minutes and AI credits）; evidence label: VERIFIED_SPEC + PRODUCT_VOLATILE; relation: support / limit.
• source class: official security product documentation; exact title: About code scanning; author/org: GitHub; canonical URL: https://docs.github.com/en/code-security/concepts/code-scanning/code-scanning publication/update/access: current page accessed 2026-09-13 JST; version/release/tag/commit/API revision/model ID: GitHub code scanning/CodeQL current docs; supporting locator: page sections on finding vulnerabilities/errors, schedule/event triggers, SARIF/API, CodeQL and third-party tools; private repository license gate as stated on page; evidence label: VERIFIED_SPEC + PRODUCT_VOLATILE; relation: context / limit.

GitHub Docsはcloud agentをissue/taskから作業させ、PRを作成・外部toolからinvokeし、enterprise/org ownerがPR lifecycle metricsを見られることを記載する。Business/Enterpriseではadmin policy enableが必要で、repository opt-out、Actions minutes、AI creditsもavailability/cost gateになる。Code scanningは脆弱性・error検出、CodeQLまたはSARIF結果を扱う補助層である。これらは運用接続点の証拠だが、agent patchの正しさ、secure-by-default、license compliance、rollback成功、全repositoryへの可用性を保証しない。

PRが作成・mergeされたことはコード品質の証明ではない。code scanningのalertは検出範囲とrule/configに依存し、未検出を安全の証拠にできない。branch protection、required review、CI、secret scanning、dependency pinning、license/OSS policy、runner networkは別設定。pageの機能・料金・モデル選択はPRODUCT_VOLATILE。

paid Copilot plan、Business/Enterprise admin policy、repository opt-out、GitHub Actions/AI credits、branch permissions、secret/network restrictions、code scanning license、CI statusを確認する必要がある。実repositoryへのagent起動・PR作成・CI実行は未実施。

read-only repo discovery→isolated branch/worktree→tests/scanning→human review→protected merge→rollback/revertのcontrol plane設計候補。実装・安全性試験未実施。

fixture repository群で patch correctness、test pass、static alerts、dependency/license diff、secret exposure、PR review completeness、revert time、agent action traceを別scoreにする。merge率を品質scoreに代用しない。

SECURITY/PRIVACY: least privilege token、no production secrets、network egress allowlist、sandbox runner。AUDIT: issue/branch/commit/PR/CI/scanner/model/config/approver。COST: Actions minutes、AI credits、review/rollback工数。OPERABILITY: protected branch、required checks、kill switch、revert playbook。

「GitHub Copilot cloud agentはtaskからrepository作業・PR作成へ接続でき、管理者有効化、repository opt-out、Actions minutes/AI credits等のgateを伴う。Code scanningは別の検出・SARIF/CodeQL層であり、agent生成コードの正しさ・安全性・license適合・merge可否を自動保証するものではない。」

本文ではagent capability、repository/IAM gate、CI/review gate、scanner coverage、cost、rollbackを分離して記載する。次回はGitHub branch protection・secret scanning・dependency/OSS controlsの一次Docsと、isolated test repositoryのTEST_PROFILEを追加する。

agentの実際のtool permission境界、model/version pinning、network/secret access default、failure/rollback rate、各plan/regionの差、code scanning false-negative/false-positive。

agentがPRを出したこと・CIが通ったこと・scannerが無alertであることを、総合的な安全・品質保証へ変換しない。 UNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED

---