Android skills に学ぶ

Transcript

1. Android skills に学ぶ potatotips #96 iOS/Android開発Tips共有会 株式会社プログリット
2. About Me 山崎 弘毅 Android エンジニア 所属: 株式会社プログリット 趣味: 走ること🏃 Copyright © PROGRIT Inc. All rights reserved 2
3. What Are Android skills? • 公式ガイダンスに沿った実装をエージェントにさせるスキル集 • agentskills.io のオープンスタンダードに準拠している • 現在 21 個のスキルが公開されている 公式ドキュメント : リポジトリ : developer.android.com/tools/agents/android-skills github.com/android/skills Copyright © PROGRIT Inc. All rights reserved 3
4. Philosophy Android 公式ブログに、Android skills の理念と方法論をまとめた記事が公開されました Inside Android Skills - Built for deprecation（2026-08-06） Copyright © PROGRIT Inc. All rights reserved 4
5. Philosophy “Currently, we only consider new skills when there's a verifiable knowledge gap in state-ofthe-art (SOTA) models.” → モデルに検証可能な知識のギャップがあるときだけ作る “you don't need to teach the model what it already knows” ・既に知っていることは書かない “if the information is in the documentation, and models decide to search for it, we don't publish a skill for it” ・調べれば分かることはスキルにしない “Before their release, each skill is tested against a comprehensive set of evals that prove that the skill delivers clear value” ・価値を証明する eval が通ったものだけ公開する “Skills of today will be in the models of tomorrow” ̶ Karpathy（記事の loose paraphrase） → いずれモデルに吸収される。捨てる前提で作る Copyright © PROGRIT Inc. All rights reserved 5
6. When Should We Write Our Own Skill? “When do core or basic skills make sense?” “You deviate from the norm” → 標準から外れた設計をしている（チーム独自のルール） “You're refactoring or reviewing legacy code” → モデルが周囲のレガシーな書き方に引っ張られるのを防ぎたい “You want to use smaller, cheaper models” → 小さく安いモデルに任せたい “You're using vague prompts” → 曖昧な指示でも意図を汲ませたい Copyright © PROGRIT Inc. All rights reserved 6
7. Building a Skill スキルの基本構造 ̶ Frontmatter と body の2つだけ Frontmatter 起動時に全スキルの name / description だけが読まれる → どのスキルを使うかの判断材料になる --name: writing-commit-messages description: git のコミットメッセージを書くときに使う --- body スキルが選ばれてから読まれる → 実際の指示を自然言語で書く Conventional Commits の形式で書く（feat: / fix: など） 1コミット = 1つの目的にする 仕様 : agentskills.io Copyright © PROGRIT Inc. All rights reserved 7
8. Building a Skill Android skills の中身から、自分たちのスキル作りに使える3点 ① 詳細は references/ に切り出す ② OK / NG の具体例を示す ③ MUST / NEVER で断定する Copyright © PROGRIT Inc. All rights reserved 8
9. ① Move Details to references/ SKILL.md は簡潔にして、詳細は references/ に置く ・読まれるまでトークンを消費しない ・既存のドキュメントをそのまま置ける ・人間にとっても読みやすく、管理しやすい Copyright © PROGRIT Inc. All rights reserved 9
10. ② Show Wrong and Correct Code 「間違った書き方」と「正しい書き方」をコードで示す ・具体例で解釈のブレをなくせる ・実コードをそのまま示せる ・ルールを言葉で抽象化しなくて済む 出典: camera/camerax/SKILL.md Copyright © PROGRIT Inc. All rights reserved 10
11. ③ State Rules as MUST / NEVER 守らせたいルールは MUST / NEVER で断定する 出典: security/android-intent-security/SKILL.md ・ルールを「解釈の余地なし」として渡せる ・守るべき境界が一目で分かる Copyright © PROGRIT Inc. All rights reserved 11
12. Takeaways 何をスキルにするか（What） モデルが知らない最新の情報や、チーム独自のルールをスキルにする。 どうスキルにするか（How） 自然言語で書くだけでなく、意図が誤解なく伝わるように工夫できる。 スキルの価値はモデルとエージェントの進化で変わるので、定期的な見直しが必要。 Copyright © PROGRIT Inc. All rights reserved 12
13. Credits The Android robot is reproduced or modified from work created and shared by Google and used according to terms described in the Creative Commons 3.0 Attribution License. Android is a trademark of Google LLC. Code and text excerpts are from github.com/android/skills, licensed under the Apache License 2.0. Screenshots are from developer.android.com. Copyright © PROGRIT Inc. All rights reserved 13