ภาพรวมทักษะ Android

ทักษะของ Android คือวิธีการที่ปรับให้เหมาะกับ AI เพื่อช่วยให้เครื่องมือและเอเจนต์ AI เข้าใจและดำเนินการตามรูปแบบที่เฉพาะเจาะจงซึ่งเป็นไปตามแนวทางปฏิบัติแนะนำและคำแนะนำในการพัฒนา Android ได้ดียิ่งขึ้น โดยทักษะเหล่านี้จะอยู่ในที่เก็บ GitHub ของทักษะของ Android

คุณสามารถใช้ทักษะของ Android เพื่อทำงานต่างๆ เช่น

  • ย้ายข้อมูลจาก XML ไปยัง Compose
  • อัปเกรดเป็น AGP 9
  • ตั้งค่าเฟรมเวิร์กใหม่ๆ เช่น Navigation 3
  • ปรับ UI ของแอปให้ทันสมัยโดยทำให้แสดงผลแบบเต็มหน้าจอ
  • ปรับปรุงประสิทธิภาพด้วยการตรวจสอบการกำหนดค่า R8

การใช้ทักษะของ Android จะช่วยให้ LLM มีความรู้และบริบทที่อัปเดตล่าสุดเกี่ยวกับเวิร์กโฟลว์ Android เฉพาะทาง

ทักษะของ Android เป็นไปตามมาตรฐานแบบเปิดของทักษะของเอเจนต์ จึงใช้งานร่วมกับเครื่องมือ AI ที่รองรับทักษะได้ หน้านี้อธิบายวิธีใช้ทักษะใน Android Studio และวิธีใช้ Android CLI เพื่อติดตั้งทักษะสำหรับใช้กับเอเจนต์และ เครื่องมือที่คุณเลือก

ประโยชน์หลักของทักษะของ Android

ทักษะของ Android มีประโยชน์หลักๆ หลายประการที่มุ่งเร่งเวิร์กโฟลว์แบบ Agent เพื่อให้สร้างโค้ด Android คุณภาพสูงได้อย่างมีประสิทธิภาพมากขึ้น

  • อิงตามความรู้ของผู้เชี่ยวชาญ: ให้บริบทที่เฉพาะเจาะจงกับ Android มากขึ้นแก่ Agent โดยใช้การเชื่อมต่อแหล่งข้อมูลตามความต้องการ และขยายความรู้และความเชี่ยวชาญเริ่มต้นของ Agent ให้เหนือกว่าวงจรการฝึกโมเดลปกติ
  • เวิร์กโฟลว์ที่ทำซ้ำได้: ให้วิธีการมาตรฐานเพื่อช่วยให้มั่นใจว่างานหลายขั้นตอนในการพัฒนา Android จะดำเนินการอย่างสม่ำเสมอ
  • การจัดกลุ่มทรัพยากร: รวมสคริปต์ เทมเพลต หรือเอกสารประกอบเพิ่มเติมไว้ข้างๆ วิธีการหลักใน SKILL.md เพื่อให้เอเจนต์มีทุกสิ่งที่จำเป็นในที่เดียว โดยไม่จำเป็นต้องแนบไฟล์ด้วยตนเองสำหรับพรอมต์
  • ความเชี่ยวชาญที่แชร์: จัดแพ็กเกจรูปแบบการพัฒนา Android ของทีมลงในโฟลเดอร์ที่แชร์เพื่อให้เข้าถึงและทำงานร่วมกันได้แบบรวม

ใช้ทักษะของ Android

ทักษะของ Android ผสานรวมอยู่ใน Android CLI เพื่อใช้กับเอเจนต์ที่คุณเลือก

gemini_cli_skills_demo.gif

Android CLI

เราขอแนะนำให้ติดตั้งทักษะของ Android โดยใช้ Android CLI ซึ่งจะช่วยให้ค้นพบ ดาวน์โหลด และจัดการทักษะสำหรับเอเจนต์ที่คุณเลือกได้ง่ายขึ้น

  • หากต้องการดูรายการทักษะที่พร้อมใช้งาน ให้เรียกใช้ android skills list
  • หากต้องการติดตั้งทักษะ ให้เรียกใช้ android skills add --skill skill-name

Android Studio

คุณสามารถดาวน์โหลดทักษะจากที่เก็บ GitHub ของทักษะของ Android แล้วนำเข้าไปยังโปรเจ็กต์ใน Android Studio

เปิดใช้งานทักษะ

เอเจนต์จะเปิดใช้งานทักษะที่เกี่ยวข้องกับงานของคุณโดยอัตโนมัติ หากต้องการใช้ทักษะ ให้แจ้งให้เอเจนต์ทำงานที่เกี่ยวข้องกับทักษะนั้นๆ เช่น "ทำให้ UI ของแอปแสดงผลแบบเต็มหน้าจอ" เอเจนต์ควรค้นหาและใช้ทักษะโดยอัตโนมัติหากทักษะนั้นพร้อมใช้งาน

ใน Android Studio คุณยังเรียกใช้ทักษะ ด้วยตนเองได้โดยตรงโดยพิมพ์ @skill-name ในหน้าต่างแชท

สร้างทักษะของคุณเอง

คุณสามารถสร้างทักษะของคุณเองเพื่อจัดแพ็กเกจและแชร์เวิร์กโฟลว์ของทีม ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อกำหนดของทักษะได้ที่ ข้อกำหนดของทักษะของเอเจนต์

เอเจนต์จะค้นหาทักษะโดยเริ่มจากไดเรกทอรี .skills/ หรือ .agent/skills/ ที่อยู่ในไดเรกทอรีรากของโปรเจ็กต์ หากต้องการสร้างทักษะที่กำหนดเอง ให้ทำตามขั้นตอนต่อไปนี้

  1. สร้างไดเรกทอรี สำหรับทักษะ (เช่น my-new-skill/)
  2. สร้างไฟล์ SKILL.md (คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) ภายในไดเรกทอรีใหม่

ทักษะต้องเป็นไปตามกฎต่อไปนี้

  • 1 ไดเรกทอรีต่อ 1 ทักษะ: ทักษะแต่ละอย่างต้องมีไดเรกทอรีที่ไม่ซ้ำกันของตัวเอง ซึ่งรวมถึงไฟล์ SKILL.md และ ทรัพยากรเพิ่มเติม
  • การซ้อน: ทักษะทั้งหมดต้องอยู่ในไดเรกทอรี .skills/ หรือ .agent/skills/ ที่ไดเรกทอรีรูทของโปรเจ็กต์ อย่างไรก็ตาม คุณสามารถใช้ไดเรกทอรีย่อยเพื่อการจัดระเบียบที่ดีขึ้นได้ (เช่น skills/ui-flows/<skill name>/SKILL.md หรือ skills/testing/<skill name>/SKILL.md)
  • ขอบเขต: ระบบรองรับเฉพาะทักษะที่อยู่ในฐานของโค้ดของโปรเจ็กต์
โครงสร้างไดเรกทอรีที่แสดงตำแหน่งของไฟล์ทักษะในโปรเจ็กต์
โครงสร้างไฟล์ทักษะ

ไฟล์ SKILL.md ใช้บล็อก YAML สำหรับข้อมูลเมตาและ Markdown มาตรฐานสำหรับวิธีการ

  • name: ตัวระบุที่ไม่ซ้ำกันสำหรับทักษะ ซึ่งควรตรงกับชื่อไดเรกทอรี
  • description: คำอธิบายที่ชัดเจนเกี่ยวกับสิ่งที่ทักษะทำและเวลาที่เอเจนต์ควรใช้ทักษะ
  • เนื้อหา: เนื้อหา Markdown ใต้บล็อก YAML มีวิธีการที่แนะนำลักษณะการทำงานของเอเจนต์เมื่อทักษะทำงานอยู่
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

หลักเกณฑ์การจัดรูปแบบ

  • ชื่อ: สูงสุด 64 อักขระ (ตัวอักษรพิมพ์เล็ก ตัวเลข และขีดกลางเท่านั้น)
  • คำอธิบาย: สูงสุด 1,024 อักขระ
  • เนื้อหา: ตั้งเป้าไว้ที่ 10,000-20,000 อักขระ (~2,500-5,000 โทเค็น) หาก วิธีการมีความยาวเกินกว่านี้ ให้พิจารณาย้ายเอกสารประกอบโดยละเอียดไปยังไฟล์ทรัพยากร ตามที่อธิบายไว้ใน ไดเรกทอรีทักษะที่ไม่บังคับ

ไดเรกทอรีทักษะที่ไม่บังคับ

หากต้องการให้ไฟล์ SKILL.md กระชับและเป็นโมดูล คุณสามารถรวมทรัพยากรเพิ่มเติมไว้ในไดเรกทอรีที่ไม่บังคับต่อไปนี้ภายในโฟลเดอร์ของทักษะ

  • scripts/: มีโค้ดที่เรียกใช้งานได้ (เช่น Python หรือ Bash) ที่เอเจนต์สามารถเรียกใช้ได้
  • references/: มีเอกสารประกอบทางเทคนิคโดยละเอียด ข้อมูลอ้างอิง API หรือคำแนะนำเฉพาะโดเมน
  • assets/: มีทรัพยากรแบบคงที่ เช่น เทมเพลตเอกสาร ไดอะแกรม UI หรือสคีมา JSON

เมื่ออ้างอิงไฟล์เหล่านี้ภายในวิธีการ SKILL.md ให้ใช้ Relative Path จากไดเรกทอรีรูทของทักษะ เช่น Run the script at scripts/cleanup.py

ลักษณะการทำงานของทักษะ

ทักษะแสดงถึงความเชี่ยวชาญตามความต้องการ โครงสร้างนี้ช่วยให้เอเจนต์รักษาความสามารถเฉพาะทางจำนวนมากได้โดยไม่ทำให้หน้าต่างบริบททันทีของโมเดลรก

โมเดลจะตัดสินใจด้วยตนเองว่าจะใช้ทักษะเมื่อใดโดยพิจารณาจากคำขอและคำอธิบายของทักษะ เมื่อระบุทักษะที่เกี่ยวข้องได้ โมเดลจะดึงวิธีการและทรัพยากรทั้งหมดที่จำเป็นต่อการทำงานให้เสร็จสมบูรณ์แบบไดนามิก