OpenHands🤲にContributeしてみた

AI駆動開発(AI-Driven Development) 勉強会 【大阪支部 #2】
https://aid.connpass.com/event/356707/

Transcript

1. OpenHands　　　に Contributeしてみた @こたうちさんさん 私が生産者(の一部)です。
2. 自己紹介 • こたうち さんさん • @kotauchisunsun • こたうち企画　主催 • 本職：サーバーサイドエンジニア • スマートグラスが好き
3. 1月からほぼ毎日投稿してます！！ 2025年だけで150本以上アップロードしてます。
4. HUAWEI Eyewear2 RayNeo X3 Pro Monocle Even Realities ASUS AirVision M1 Oakley Meta
5. YouTubeChannel運用ツール AI Coding ニュースサイト ニュースの収集・選定 概要文の生成 YouTube運用の効率化ツールをAI Codingしてる。
6. OpenHandsとは Docker + WebUI (local) OpenHands Cloud (SaaS) OpenHands CLI (local) OpenHands Resolver (Github,Gitlab,BitBucket) • 自然言語でコーディングを指示できるAI Coding Agent • いろいろな形態がある こたうちがContributeをしたのはコレ New！
7. デモ
8. OpenHands Resolverの機能　①Issueの解決 GithubのIssueを作成し、”fix-me”のラベルをつけるだけ！ あとは勝手にPRが作られる！
9. OpenHands Resolverの機能　②PR修正への対応 “@openhands-agent”と修正内容をリプライするだけ！
10. OpenHands Resolverの始め方 • Github Actionsのworkflowのファイルを置く(Qiita記事or公式リポジトリ参照) • LLMのモデルの指定・APIキーの登録 • プライベートのリポジトリならPATトークンが必要 ◦ プライベートのリポジトリでも動く！！ • Geminiの無料枠で動く • Github Actionsの無料枠で動く • 完全無料でAI Codingできる！ 無料最強 タッグ
11. なんでContributeしたの？
12. Devinへの憧れ(2025年3月頃の話) ※当時月額50万円 Devinよさそうだけど 高いなぁ。 無料でできねぇかなぁ。 ①タスクを依頼 ②コードを実装 ③PR作成 null-sensei
13. その時に見つけた技術記事 https://zenn.dev/itaosan/articles/43742985318a21
14. 動かねぇ。
15. OpenHandsのリトライ処理 リクエスト 429エラー(リクエスト上限) 無料枠 ・・・ リクエスト LLM_RETRY_MIN_WAIT LLM_NUM_RETRIES 何回か 繰り返す 待機
16. OpenHands Resolverのリトライ処理のバグ リクエスト 429エラー(リクエスト上限) 無料枠 ・・・ リクエスト LLM_RETRY_MIN_WAIT LLM_NUM_RETRIES 何回か 繰り返す 待機 リトライ関連の設定値が、 Resolverだと反映されない挙動だった
17. OpenHandsへContributeした内容 OpenHands ResolverによるGemini無料枠での稼働が安定するようになった。 やや強引にリトライ設定値を反映するPR 他の設定値も反映できるようにしたPR 大小合わせて6つのPRがマージ
18. 2025年6月時点でのAI Coding Agentは戦乱状態 Visual Studio Code コマンドライン SaaS Plugin
19. OpenHandsの現在のメリット “GithubのIssueをGithub Actions上で解決し、 PRを無料で作らせる ”用途 Gemini無料枠が使える コマンドラインで動く 問題解決ができる ClineやRooCodeなどのVSCodeプラグインは Github Actions上では動かせない。 ClaudeCodeやRobodev(?)は LLMをGeminiに変更できない。 OpenHandsで修正できた内容がCodex CLIで 修正できなかった(Geminiが原因？) • Geminiの無料枠は日毎に復活する • Github Actionsの無料枠は2000分(Pulbic無制限) 無料の範囲内でかなりのことが出来る。
20. OpenHands公式の ベストプラクティス
21. OpenHandsの公式ベストプラクティス 良いプロンプトの例： 具体的 修正箇所の明示 適切な範囲 追加する必要がある機能や修正が必要なエラーを明確に説 明します。 コードベース内で変更する必要がある場所がわかっている場 合は指定します。 通常は 100 行のコードを超えない、単一の機能に重点を置く。
22. OpenHandsの公式ベストプラクティス 悪いプロンプトの例： 抽象的 曖昧な修正箇所 過大な指示 コードを改善してください。 （漠然としすぎていて、具体的ではありません） ユーザー認証のどこかにバグがあります。見つけて修正できま すか？（詳細度と位置情報が不足しています） バックエンド全体を書き換えて、別のフレームワークを使用す る。（適切なスコープが設定されていない） 割とどんなAI Coding Agentでも使える内容
23. 個人的な OpenHands Resolver プラクティス
24. AIにコーディング時に Lint・自動テストをさせない。 Github Actionsに指示させる。
25. タスクを忘れるAI • 機能Aを実装 ◦ 機能A-1を実装 ◦ 機能A-2を実装 • 機能Bを実装 • 機能Cを実装 • 機能Dを実装 • Lintを実行 • 自動テストを実行 やってほしいタスク • 機能Aを実装 ◦ 機能A-1を実装 ◦ 機能A-2を実装 • 機能Bを実装 • 機能Cを実装 • 機能Dを実装 • Lintを実行 • 自動テストを実行 実際に行ったタスク 複雑なタスクになればなるほど後半のタスクを忘れがち。 (RooCodeのOrchestratorなどはだいぶマシ)
26. Github ActionsにLint修正やテスト修正のAI指示をさせる PR作成 Lint実行 Lint成功？ Lint実行をコメント指示 No
27. AIに機能の実装に集中させる Lint実行 自動テスト実行 機能実装 機能実装 Lint実行指示 テスト修正指示 やることが多いとうまく動かない AIにタスクを一気に渡さない。 AIは実装に集中。Lintやテスト修正のフォローアップをGithub Actionsにさせる。 ♪～
28. Github Actionsによるフォローアップは前時代的か？ • 手動やローカルでコードを書くこともある。 • Lint忘れやテスト忘れでプッシュ ◦ AIも忘れる。 • 人力レビューが止まる ◦ (マージが遅れる。リリースが遅れる。 ) • 割とやりたくないLintエラー修正や テスト修正をOpenHandsが フォローしてくれる。 ①Lint忘れ・テスト忘れで ブランチにプッシュ ③Lint修正・ テスト修正を OpenHandsが 自動修正 ②作業忘れを検知 手動でのコード品質維持のコストやリードタイムを下げることができる。
29. シンギュラリティ来てる？
30. 人類の最後の柱がOpenHandAgentに 倒れようとしている 人間が書いたコード量 < AIが書いたコード量になりそう。 OpenHandsAgentによるOpenHandsの修正が人間を超えるのも時間の問題。
31. コミット数に関しては AI Agentが人間を突破した。
32. まとめ • OpenHandsの紹介 • OpenHands ResolverはGeminiと利用することで無料でGitthub Issueを解決出来 る • OpenHands(AI Coding Agent)へのプロンプトのベストプラクティス ◦ 具体的 ◦ 修正箇所の明示 ◦ 適切な範囲 • Lint忘れ・テスト忘れのためのGithubActionsによるフォローが有用 • OpenHands自体の開発がOpenHandsにより行われ、人間を一部超えた。
33. 言いたかったこと
34. AIによるCodingは不完全
35. AI Coding Agent自体も不完全
36. まだまだつくる部分はいっぱいある
37. みなさんもContributeしてはいかが？
38. ご清聴ありがとうございました。 Github Sponsor♡リンク→