ここ最近で良いと思ったコーディングエージェントのSkillと設定

Transcript

1. ここ最近で良いと思った コーディングエージェントの Skillと設定 @garicchi
2. # ⾃⼰紹介 @garicchi C# + Microsoft Azure の Webシステムエンジニア
3. # 私のClaude Code環境 インターネット claude code (auto mode) proxy 通信制限 claude code (auto mode) プロジェクトA⽤ sandbox プロジェクトB⽤ sandbox tmux claude code (auto mode) proxy 通信制限 プロジェクトC⽤ sandbox 開発PC proxy 通信制限
4. # このセッションのねらい ① Skills、設定などの⼊⾨者向け解説 ② 個⼈的におすすめの設定を紹介
5. # コーディングエージェントすごい！ claude code、codex、github coplit、antigravity etc… AIが⾃動でプログラミングしてくれて、 アウトプットの質も量も⾮常に⾼い 最近はほとんど⼿でコードを書かなくなった...
6. # コーディングエージェントは間違えることもある コーディングエージェントはすごいのだが、 間違った判断をしてしまい、⼿戻りが発⽣することもある ⚪⚪のスタイル でコードを書いて 欲しいなぁ Pythonは3.8を 使うこと ？？ ⚪⚪のAPIの仕様 は〜〜 JavaScriptは△△ のスタイルで... AIに情報を与えていない AIに情報を与えすぎている 開発効率の低下 ？？
7. # もっと開発効率をあげるには? AIを取り巻く環境や設定をカスタマイズする AGENTS.md Skills ！ hooks permissions サブエージェント MCP 設定を⼯夫すれば、よりAIエージェントが意図通りに動き 開発効率が上がる
8. # AGENTS.md (CALUDE.md) 常に把握しておいてほしい基本的な情報を書く ここに書いた内容で、コーディングエージェントの基本的な動作が変わる ユーザー設定 (例) Pythonは 3.8を利⽤すること AGENTS.md 探す 読む ソースコード 探す AGENTS.md 読む 書いてある内容に従って動く
9. # Skills 普段は読み込んで欲しくないのだが、 必要になったタイミングで読み込んで欲しい情報や指⽰を書く Pythonで コーディングしてね 探す Skills⼀覧 Python Skill 読む JavaScript Skill 書いてある内容に従って動く 今必要ないので 読まない
10. # Skills の特徴 AIに与える情報が増えすぎない AGENTS.md ほぼ読む Pythonで コーディングしてね Skills⼀覧 必要な場合読む Python Skill JavaScript Skill カスタムコマンドとして使える git commit skill発動 Skills⼀覧 実⾏ git commit Skill
11. # AGENTS.mdとSkills AGENTS.md (CLAUDE.md) Skills 基本的な情報を書く 必要な時だけ参照したい情報を書く (ほぼ)常にAIに読み込まれるので詳 細な情報を書きすぎない 詳細な情報を書く ⾃動化したい処理などを書く 【例】 基本的な⾏動ルール どこに何が書いてあるかを書く 【例】 APIの仕様書、ツールの使い⽅を書く この2つをカスタマイズすることが 開発効率を上げるファーストステップ
12. おすすめの設定やSkill
13. # おすすめの設定やSkill ① 「1問1答にすること」 とAGENTS.mdに書く ログイン処理の 設計をしたい わかりました ログイン処理ですね コードベースを調査したところ OpenIDConnectを使⽤するの がよいと思いますがそれでもよ いですか？ また、セキュリティ対策として ⚪⚪のライブラリがあります が使⽤しますか? また... ログイン処理の 設計をしたい わかりました Open ID Connectを使 ⽤しますか? yes 次に、 ⚪⚪のライブラリ を使⽤しますか?
14. # おすすめの設定やSkill ② 「絶対に情報の裏どりをすること 」 とAGENTS.mdに書く ⚪⚪のAPIを呼び出す コードを書いて 完成しました！ ⚪⚪のAPIを呼び出す コードを書いて まずは裏どりを ⾏います そのAPIはバージョン が古いのでは.. 申し訳ありません 今調べたら 新しいバージョンが ありました 裏どりをした結果 最新のAPIが あったので コードを修正します APIの ドキュメント
15. # おすすめの設定やSkill ③ コードレビューのSkillを作る / 使う レビューSkill発動 /diff-review mainとの差分を 確認します diff-review skill mainブランチとのgit差分を取得し、 コードレビューを⾏ってください etc.. レビューの結果 ⚪⚪の部分に問題が あることが判明しました コーディングエージェントにレビューをさせると 実装ミスがかなり減る
16. # おわりに コーディングエージェントは AGETNS.mdやSkillsなどをカスタマイズすると もっと開発効率をあげることができる コーディングエージェントをカスタマイズして よりシステム開発を効率化しよう！