アプリ開発でOpenHandsを軽く使ってみた

2026/03/26（木）AI駆動開発ミートアップ資料
https://openhands.connpass.com/event/385282

Transcript

1. アプリ開発で OpenHands を 軽く使ってみた 栃折 泰史 2026年3月26日 © 2026 Fujitsu Limited 1
2. 自己紹介 ⚫ 名前：栃折泰史 ⚫ 最近の業務： ⚫ 富士通人工知能研究所にてMulti AI Agent Frameworkを開発 ⚫ これまでの発表： ⚫ オープンソースカンファレンス ⚫ PaaS勉強会 ⚫ 最近の興味 ⚫ 育児：9歳と7歳の男児 ⚫ ワークライフバランス ⚫ 子供が喜ぶアプリを作りたいが ⚫ 趣味でのAI/コーディングの時間が中々と れない。。。 ⚫ メタルのライブ参加 © 2026 Fujitsu Limited 2
3. はじめに ⚫ Multi AI Agent Frameworkというアプリの開発でOpenHandsを使い続けてみた ので経験で得たノウハウを共有します © 2026 Fujitsu Limited Frontend, builder-backendという コンポーネント部分の開発で実践 3
4. OpenHandsを使う場面 ⚫バグ修正・エンハンス ←メインはここ ⚫テストコード作成 ⚫環境構築 ⚫CI設定 ⚫ドキュメントの作成・更新 ⚫既存コードの理解 © 2026 Fujitsu Limited 4
5. 直近半年間でのコード修正量 © 2026 Fujitsu Limited Frontend Builder-backend コードの約4% コードの約34% 5
6. 使い方種類1：Web App © 2026 Fujitsu Limited OpenHands に修正指示 OpenHandsがコンテナ上で 修正とPull Request作成 • 95%は私がこの使い方で実践しました • OpenHands v0系、モデルはClaude Sonnetを使用 • CLIはほとんど使ってないです 6
7. 使い方種類2：GitHub Action © 2026 Fujitsu Limited 1. issue作成 2. fix-me ラベル作成 3. GitHub Actionで OpenHandsが自動修正・ Pull Request作成 7
8. 成功率・コード品質を高めるためには ⚫ OpenHandsが修正に必要な情報を与える + 極力自律的に行わせる ⚫ テストコード作成とテスト実行を同時に行わせ、テスト実行時のエラー情報を使って OpenHandsに自己修正させる ⚫ Linter/Formatterの実行と修正も同様にOpenHandsに行わせる ⚫ DockerfileやGitHub Actionなどのテストコードを作りづらいもののみ手動で実行してエ ラー情報を与えて修正させる ⚫ OpenHandsで上記を実現するためには ⚫ リポジトリに .openhands/setup.sh を作って (またはランタイムコンテナイメージのカ スタマイズ) テストやLinter実行環境を自動構築させる ⚫ リポジトリに .openhands/microagents/repo.md (最近skillsにリネーム、 AGENTS.mdにも対応したらしい)にリポジトリ説明、テスト作成・テスト/lint実行につ いての開発ルールを書く © 2026 Fujitsu Limited 8
9. Builder-backendでの資材 © 2026 Fujitsu Limited 理由あってDockerイメージカスタマイズでやってますが 通常は.openhands/setup.shで事足りると思います これを作ってから想定したテスト とlintを実行するようになった Uvを使った環境構築 最近はAGENTS.mdに対応 9
10. OpenHands Web App版の挙動 (v0系) © 2026 Fujitsu Limited 1.ランタイムコンテナ作成 2. setup.sh実行 3. ユーザー指示 4. repo.mdの読み込み 5. 修正前準備 6. 計画・タスク作成 10
11. OpenHands Web App版の挙動 (2/2) © 2026 Fujitsu Limited 7. タスクごとにコード 参照と修正 8. テスト実行と修正 9. 全体テストとLint/Formatter実行 10. コード修正完了 テスト実行結果を 元に自分で直している 11
12. まとめ ⚫OpenHandsは自律的にコーディング＋テスト/lintまで簡単な設定 で行ってくれる良いツール ⚫効果的に使うためにはエージェントが自律的に動ける環境を作ろう ⚫.openhands/setup.sh ⚫.openhands/microagents/repo.md (AGENTS.md) ⚫上記を特に調整する ⚫OpenHandsを使ってみましょう＆ノウハウをシェアしていきま しょう © 2026 Fujitsu Limited 12
13. OpenHandsを使っていく中で 起きたミニ事件集 © 2026 Fujitsu Limited 13
14. ミニ事件①：実行コマンドの標準出力が出ない ⚫事象：コマンド実行などの出力が突如出なくなった。。。 ⚫原因：setup.shを作成したらOpenHandsのバグを踏んだ ⚫[Bug]: `set -eou` causes terminal to break · Issue #10550 · OpenHands/OpenHands →Closed as not planned ⚫教訓： ⚫バグが直るまでは.openhands/setup.shでset –eouxのオプションを使わない ⚫GitHubのissueはチェックする © 2026 Fujitsu Limited 本来ここに標準出力・ エラーが表示される 14
15. ミニ事件②：pre-commit.shが動かない ⚫事象：ドキュメント通りのpre-commit.shを作ったものの動かない ⚫Repository Customization - OpenHands Docs ⚫原因：OpenHandsのバグ？ドキュメントの誤り？で動かない ⚫Pre-commit hooks not automatically executed before agent creates pull requests · Issue #11409 · OpenHands/OpenHands →Closed as not planned ⚫教訓： ⚫repo.mdにpre-commit.shをコミット前に実行するように書く ⚫GitHubのissueはチェックする、ドキュメントは参考にしつつも動くものを信 用する © 2026 Fujitsu Limited 15
16. ミニ事件③：OpenHandsがpre-commitせずにコミット ⚫ 事象：OpenHandsが作成したPull Requestでpre-commit時に検出できる LintのエラーがCIで検出 ⚫ 原因：ディスク枯渇でpre-commitのエラーが解消できず、苦し紛れに pre-commitを無視するオプション付加してコミットしていた ⚫ 教訓： ⚫ OpenHandsにチェックする指示は出していたとしても、CIでのチェックは別途用意する ⚫ エージェントの動きをよく観察し、エージェントが働きやすい、風通しのよい環境を作る © 2026 Fujitsu Limited 16
17. Thank you © 2026 Fujitsu Limited