Support GitHub Copilot CLI as an execution engine

[nonz250]

Summary

Add support for GitHub Copilot CLI as an alternative execution engine alongside Claude Code CLI.

Research: Copilot CLI Permission Flags

Note: Re-verified from official docs and changelog on 2026-04-05. Some flags from initial research could not be confirmed.

Permission control flags (verified)

Flag	Exists	Effect
--yolo	Yes	Alias for --allow-all. Auto-approve all permissions
--allow-all	Yes	Auto-approve all permissions. Same as --yolo
--allow-all-tools	Yes	Auto-approve all tool usage
--allow-all-paths	Yes	Auto-approve all file path access
--allow-tool	Yes	Allow specific tool (e.g., --allow-tool 'shell(git)')
--deny-tool	Yes	Deny specific tool (takes priority over allow)
--allow-all-urls	Not confirmed	Not found in docs or changelog
--autopilot	Not confirmed as CLI flag	Exists as interactive mode feature (Shift+Tab), not as a CLI flag

Non-interactive execution

# Full autonomous execution
copilot -p "prompt" --yolo

# Restricted tool access
copilot -p "prompt" --allow-tool 'shell(git)' --allow-tool 'write'

Flag mapping with Claude Code

Claude Code	Copilot CLI
claude -p	copilot -p
--dangerously-skip-permissions	--yolo (alias: --allow-all)
(no equivalent)	--allow-all-tools (tools only, not paths)
(no equivalent)	--allow-tool (granular per-tool control)

Key differences from Codex

• Copilot's --yolo is an alias for --allow-all (permission-focused)
• Codex's --yolo is an alias for --dangerously-bypass-approvals-and-sandbox (approval + sandbox bypass)
• Same name, different semantics — they were defined independently
• Copilot has no sandbox concept; Codex does

Considerations

• Copilot offers granular tool-level control (--allow-tool, --deny-tool) that others lack
• --autopilot may not be usable as a CLI flag for non-interactive execution — needs further investigation
• --headless --stdio was recently removed (Issue #1606)
• Source: GitHub Copilot CLI docs, changelog

🤖 Generated with Claude Code

[nonz250]

✅ Claude Code 実行結果: 成功

コードベースの調査が完了しました。以下が解決方針です。

---

Issue #36: Support GitHub Copilot CLI as an execution engine — 解決方針

概要

現在 sabori-flow は Claude Code CLI (claude -p) のみを実行エンジンとしてハードコードしている。Issue #36 は GitHub Copilot CLI (copilot -p) を代替エンジンとしてサポートする要求。

変更が必要なファイル一覧

モデル層

ファイル	変更内容
src/worker/models.ts	Engine enum の追加（claude, copilot）、ExecutionConfig に engine フィールド追加

設定層

ファイル	変更内容
src/worker/config.ts	engine フィールドのパース・バリデーション追加（デフォルト: claude）
src/utils/config-defaults.ts	getDefaultExecution() に engine: "claude" 追加

実行層（最も影響が大きい）

ファイル	変更内容
src/worker/executor.ts	runCopilot() 関数追加、resolveCopilotAutonomyFlags() 追加、エンジン選択ファクトリ createExecutor(engine) 追加

パイプライン層

ファイル	変更内容
src/worker/pipeline.ts	PipelineDeps.runClaude を runEngine 等に汎化。defaultDeps でエンジン選択を反映
src/worker/main.ts	autonomy ログのエンジン名対応、engine 情報のログ出力

CLI 層

ファイル	変更内容
src/commands/init.ts	engine の対話入力追加（選択肢: claude / copilot）
src/commands/add.ts	同上（既存設定の引き継ぎ）
src/commands/helpers/repository-prompt.ts	engine 選択の共通ヘルパー（必要に応じて）

テスト

ファイル	変更内容
tests/worker/executor.test.ts	Copilot 用フラグ解決テスト、runCopilot テスト追加
tests/worker/config.test.ts	engine パース・バリデーションテスト追加
tests/worker/pipeline.test.ts	runEngine 汎化後のテスト修正
tests/worker/main.test.ts	engine ログ出力のテスト追加
tests/worker/helpers/factories.ts	makeExecutionConfig() に engine デフォルト追加
tests/worker/helpers/mock-deps.ts	runClaude → runEngine へのリネーム

ドキュメント・設定例

ファイル	変更内容
config.example.yml（存在する場合）	engine フィールドの例追加

変更内容の詳細

1. Engine enum の導入

export const Engine = {
  CLAUDE: "claude",
  COPILOT: "copilot",
} as const;
export type Engine = (typeof Engine)[keyof typeof Engine];

ExecutionConfig に engine: Engine を追加。デフォルトは claude（後方互換性維持）。

2. Copilot 用 autonomy フラグマッピング

Issue の調査結果に基づくマッピング:

Autonomy	Claude Code	Copilot CLI
full	--dangerously-skip-permissions	--yolo
sandboxed	（未対応→interactive）	（未対応→interactive。Copilot にサンドボックス概念なし）
interactive	フラグなし	フラグなし

3. executor.ts のリファクタリング

現在の runClaude() と対称な runCopilot() を追加し、エンジン選択用ファクトリを提供:

// ファクトリパターン
export function createExecutor(engine: Engine) {
  switch (engine) {
    case Engine.CLAUDE: return runClaude;
    case Engine.COPILOT: return runCopilot;
  }
}

runCopilot() は copilot -p を実行し、stdin 経由でプロンプトを渡す（Claude と同じパターン）。

4. PipelineDeps の汎化

PipelineDeps.runClaude → PipelineDeps.runEngine にリネーム。defaultDeps でファクトリから適切な実装を選択。processIssue に ExecutionConfig.engine 情報が渡されるため、defaultDeps のワイヤリング方法を検討（pipeline 呼び出し時に deps を動的構築、または engine を引数として渡す）。

5. config.yml 対応

execution:
  engine: copilot        # 新規追加（デフォルト: claude）
  autonomy: full
  max_parallel: 1
  max_issues_per_repo: 1

バリデーション: Engine enum の値のみ許可。

影響範囲の分析

直接影響

• executor モジュール: 最大の変更箇所。新エンジン実装＋ファクトリ追加
• models/config: フィールド追加（後方互換あり、デフォルト claude）
• pipeline: DI インターフェース変更（runClaude → runEngine）。テストのモック修正が必要
• CLI コマンド: 対話フローに engine 選択ステップ追加

間接影響

• main.ts: ログメッセージのエンジン名反映
• テスト全般: DI 名変更に伴うリネーム
• config.example.yml: ドキュメント更新

影響なし

• prompt.ts: プロンプトテンプレートはエンジン非依存（両 CLI とも stdin でプロンプトを受け取る）
• worktree.ts, label.ts, comment.ts, fetcher.ts: エンジンに依存しない
• process.ts: 低レベル層は変更不要（runCommand は任意のコマンドを実行可能）

想定されるリスクと注意点

1. Copilot CLI の可用性: copilot コマンドがユーザー環境にインストールされている保証がない。実行時エラーのハンドリング（ENOENT → 分かりやすいエラーメッセージ）が必要

2. --yolo フラグのセマンティクスの違い: Issue に記載の通り、Copilot の --yolo は --allow-all のエイリアスで、Claude の --dangerously-skip-permissions とは異なるセマンティクス。autonomy=full のログメッセージをエンジンごとに分ける必要がある

3. sandboxed autonomy の扱い: Copilot にはサンドボックス概念がないため、Claude と同様に interactive へフォールバック＋警告ログ

4. --autopilot フラグの不確実性: Issue の調査で CLI フラグとしての存在が未確認。現時点では --yolo のみ使用し、将来的な対応余地を残す

5. 後方互換性: engine フィールドはオプション（デフォルト claude）とすることで、既存の config.yml がそのまま動作する

6. PipelineDeps のリネーム: runClaude → runEngine は破壊的変更だが、内部 API のため外部影響なし。テストのモック修正が必要

7. stdin 互換性: Copilot CLI が -p フラグで stdin からプロンプトを受け取れることを前提としている。動作検証が必要

8. 出力フォーマットの差異: Copilot CLI の stdout/stderr フォーマットが Claude と異なる可能性がある。sanitizeOutput が両方のフォーマットに対応できるか確認が必要

[nonz250]

✅ Claude Code 実行結果: 成功

実装結果サマリ

PR を作成しました: #39

変更概要

GitHub Copilot CLI (copilot -p) を Claude Code CLI に並ぶ代替実行エンジンとして追加しました。config.yml の execution.engine で claude / copilot を選択でき、デフォルトは claude で既存ユーザーに影響なし。

主な変更ファイル (18ファイル)

レイヤー	ファイル	変更内容
モデル	src/worker/models.ts	Engine enum 追加、ExecutionConfig.engine フィールド追加
実行	src/worker/executor.ts	runCopilot(), resolveCopilotAutonomyFlags(), createExecutor() 追加
設定	src/worker/config.ts	engine フィールドのパース・バリデーション
パイプライン	src/worker/pipeline.ts	runClaude → runEngine 汎化、createDefaultDeps(engine) ファクトリ
メイン	src/worker/main.ts	エンジン別ログメッセージ
CLI	src/commands/init.ts	エンジン選択プロンプト追加
i18n	src/i18n/types.ts, messages.ts	prompt.selectEngine メッセージ追加
テスト	6ファイル	Copilot テスト追加、既存テスト更新
ドキュメント	CLAUDE.md, README.md, README.ja.md	エンジンサポートの記載

テスト結果

• 全 428 テスト 通過 (19 テストファイル)
• ビルド成功