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

ใช้ทักษะ Android

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

Android CLI

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

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

Android Studio

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

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

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

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

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

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

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

สร้างไดเรกทอรีสำหรับทักษะ (เช่น my-new-skill/)
สร้างไฟล์ 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: คำอธิบายที่ชัดเจนเกี่ยวกับสิ่งที่ทักษะทำได้และเมื่อใดที่เอเจนต์ควรใช้ทักษะนี้
เนื้อหา: เนื้อหา 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

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

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

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