ภาพรวมทักษะ 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 มากขึ้นให้กับเอเจนต์ โดยอิงตามความต้องการและขยายความรู้และความเชี่ยวชาญเริ่มต้นของเอเจนต์ให้เกินกว่าวงจรการฝึกโมเดลปกติ
  • เวิร์กโฟลว์ที่ทำซ้ำได้: ระบุวิธีการมาตรฐานเพื่อให้มั่นใจว่างานแบบหลายขั้นตอนในการพัฒนา 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 หากติดตั้งทักษะแล้ว skills add จะอัปเดตเป็นเวอร์ชันล่าสุด

Android Studio

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

เปิดใช้งานสกิล

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

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

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

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

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

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

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

  • 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: คำอธิบายที่ชัดเจนเกี่ยวกับสิ่งที่ทักษะทำได้และเวลาที่ Agent ควรใช้ทักษะดังกล่าว
  • เนื้อหา: เนื้อหา 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คำสั่ง ให้ใช้เส้นทางแบบสัมพัทธ์จากรูทของทักษะ ตัวอย่างเช่น Run the script at scripts/cleanup.py

วิธีการทำงานของทักษะ

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

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