開発連携を使う

Acsim Desktopの開発EpicとIssueを使い、GitHub、Devin、CLI連携へつなぐ方法と、タスク管理やソースコード連携との違いを説明します。

「開発連携」は、設計した内容をソフトウェア開発の作業へつなぐための機能群です。中心となる「開発Epic」では、実装する機能を Epic、その配下の実装作業を Issue として整理します。

GitHub、Devin、CLIの設定をすべて行う必要はありません。開発Epic／Issueだけで作業を整理することもできます。外部サービスや開発フォルダへつなぐ場合に、必要な連携だけを設定します。

Epicで機能単位をまとめ、配下のIssueで実装作業を管理します。

ほかの「連携」「タスク」との違い

機能	目的	主な利用場面
タスク管理	プロジェクト全体の作業計画と進捗を管理する	調査、会議、設計、移行、教育などを含む計画
開発Epic／Issue	実装する機能と開発作業を整理する	GitHub Issueや開発エージェントへつなぐ
ソースコード連携	既存コードをAIの分析対象にする	現行仕様の把握、影響調査、設計の根拠づくり
GitHub／Devin／CLI連携	実装作業を外部の開発環境へ届ける	Issue登録、実装セッション、コーディングエージェントとの連携

「ソースコード連携」は入力側、「GitHub／Devin／CLI連携」は開発作業を実行する側の連携です。

たとえば「受注登録」を1つの Epic とし、「入力画面を作る」「APIを実装する」「権限を確認する」を配下の Issue に分けます。

AIポータルから作成を依頼する場合、依頼文を中心に、既存の Epic／Issue、要求、設計資料が存在すれば参照されます。

依頼例:

要求管理と基本設計書をもとに、受注登録機能の開発Epicを作成してください。フロントエンド、API、権限制御、テストをIssueに分け、各Issueに完了条件と参照する成果物を記載してください。

生成された内容は、実装可能な単位になっているか、完了条件が確認可能か、要求や設計への参照が正しいかを確認します。

プロジェクト設定の「GitHub連携設定」で、連携先の GitHub Organization またはユーザーと、リポジトリを選択します。認証には端末の GitHub CLI を使用するため、事前にターミナルで gh auth login を実行してログインしてください。

連携後は、開発Epic／Issueを GitHub Issue として登録でき、Acsim DesktopとGitHubの間で状態を相互に同期できます。登録前に、公開してよい説明、添付情報、連携先リポジトリを確認してください。

GitHub連携設定は現在の端末に保存されます。別の利用者や別の端末へ自動では引き継がれません。

プロジェクト設定の「Devin連携」で API キーを登録すると、Issue の詳細から Devin セッションを作成できます。対象は、GitHubへ登録済みのIssueです。

Issueの説明と参照先だけで実装判断ができるかを確認してから開始してください。APIキーは端末に保存される設定です。画面のスクリーンショットや問い合わせへ貼り付けないでください。

「CLI連携」では、端末上の開発フォルダをプロジェクトへ接続します。接続すると、Acsimの成果物を外部のコーディングエージェントから参照し、提案をAcsimへ戻すための案内ファイルが開発フォルダへ追加または更新されます。

主に追加・更新されるのは CLAUDE.md、AGENTS.md、.acsim/link.json、.acsim/agents/acsim-cli.md です。既存の案内ファイルがある場合は、変更内容を確認してください。

CLI連携は、接続したフォルダや外部ツールへ新しい権限を付与する機能ではありません。外部ツールは、端末上でそのツールに与えられている権限の範囲で動作します。

接続を解除しても、追加された案内ファイルは開発フォルダに残ります。不要な場合は、内容とほかの用途を確認したうえで手動で整理してください。