ทักษะ

ทักษะคือชุดคำสั่ง Markdown ที่มีชื่อและโมเดลจะโหลดเฉพาะเมื่อจำเป็น แต่ละทักษะมี slug ($docs-style) ชื่อที่แสดง คำอธิบายสั้น และคำสั่งฉบับเต็ม

การโหลดเมื่อจำเป็น

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

วงจรชีวิต

คุณปิดใช้ทักษะได้โดยไม่ต้องลบ ทักษะที่ปิดจะหายจาก manifest และไม่ยอมโหลด การอัปเดตจะเพิ่มเวอร์ชันและเก็บ revision ก่อนหน้า โดยการย้อนกลับจะนำ revision ใด ๆ กลับมาเป็นเวอร์ชันใหม่ รูปแบบแลกเปลี่ยนคือเอกสาร SKILL.md ซึ่งมี frontmatter ระบุชื่อ slug และคำอธิบาย ตามด้วยคำสั่ง Markdown แบบคงข้อความเดิม การส่งออกจะดาวน์โหลดรูปแบบนี้ และการนำเข้ายอมรับทั้งรูปแบบดังกล่าวกับ JSON envelope ชื่อ คำอธิบาย และคำสั่งถูกเข้ารหัสขณะจัดเก็บ ส่วน slug เก็บเป็นข้อความปกติ

การนำเข้าจากแหล่งระยะไกล

ดึงทักษะจากแหล่งระยะไกลได้โดยตรงที่ Settings → Skills → From URL รูปแบบที่ยอมรับ ได้แก่ ลิงก์รายการ skills.sh, URL ของ repository หรือ tree/blob บน GitHub, รูปแบบย่อ owner/repo/skill (ซึ่งจะแปลงตามโครงสร้างปกติ skills/<name>/SKILL.md) หรือลิงก์ตรงไปยังไฟล์ SKILL.md ใด ๆ การดึงข้อมูลจะผ่านตัวป้องกันการออกสู่เครือข่ายแบบตรึงค่าเช่นเดียวกับเซิร์ฟเวอร์เครื่องมือ โดยอนุญาตเฉพาะที่อยู่สาธารณะและจำกัดขนาด เอกสารที่ได้จะเป็นทักษะของคุณซึ่งแก้ไขได้ แหล่งระยะไกลจึงไม่สามารถอัปเดตตัวเองอย่างเงียบ ๆ

ไฟล์ที่มาพร้อมทักษะ

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

ไฟล์จะเดินทางไปพร้อมกับทักษะทุกที่: Settings → Skills → From folder อัปโหลดโฟลเดอร์ SKILL.md ในขั้นตอนเดียว การนำเข้าระยะไกลดึงไฟล์ข้อความข้าง SKILL.md การส่งออก JSON รวมชุดไฟล์ และหน้าต่างแก้ไขจัดการไฟล์ทีละรายการ เส้นทางเป็นแบบสัมพัทธ์และออกนอกทักษะไม่ได้ เนื้อหาต้องเป็นข้อความ ถูกเข้ารหัสขณะจัดเก็บ และมีขีดจำกัด (32 ไฟล์, ไฟล์ละ 200 KB, ทักษะละ 1 MB)

ทักษะที่สอนจากการสาธิต

ทักษะที่มี slug ขึ้นต้นด้วย taught- ถูกสร้างจากการสาธิตงานบนหน้าจอ Work Computer ระบบจะคอมไพล์การบันทึกอย่างกำหนดผลแน่นอนเป็นคู่มือภาษาธรรมชาติ ซึ่งประกอบด้วยเป้าหมายการคลิกที่มีจุดยึด ความลับที่ปกปิด และขอบเขตที่อนุญาตซึ่งอนุมานจากเว็บไซต์ที่เยี่ยมชม แล้วบันทึกเป็นทักษะปกติ จึงมีเวอร์ชัน แก้ไข และแชร์ได้เหมือนทักษะอื่น การรัน Work ที่เปิดความสามารถคอมพิวเตอร์จะโหลดทักษะที่เจ้าของสอนและเปิดใช้งานโดยอัตโนมัติ หลังรอบจบ การรีวิวว่าสำเร็จ/ล้มเหลวด้วยคลิกเดียวบนชิปทักษะจะเพิ่มบรรทัดพร้อมวันที่ลงในส่วน Track record ของทักษะ แต่ละรีวิวเป็นเวอร์ชันทักษะปกติ ประวัติจึงแก้ไขและกู้คืนได้เหมือนการเปลี่ยนแปลงอื่น

การอนุมัติที่ต้องมี

ทักษะสามารถพกข้อเรียกร้องการอนุมัติมาพร้อมกับคำสั่งของมันได้ ในตัวแก้ไขทักษะ ถามทุกครั้งก่อน เปิดใช้ข้อเรียกร้องนี้ และ checklist จะเลือกเครื่องมือที่ ครอบคลุม: run_command, computer_act, delete_file, move_file, message_agent และ write_file การไม่ติ๊กช่องใดเลยหมายถึงครอบคลุมทั้งหกอย่าง

ขณะทักษะนี้ถูกโหลดอยู่ — ผูกกับโปรไฟล์หรือ persona สำหรับเทิร์นนั้น หรือโหลด ระหว่างเทิร์นด้วย load_skill — เครื่องมือเหล่านั้นจะหยุดรอผู้ใช้ก่อนทำงาน ไม่ว่าการตั้งค่าการอนุมัติของ run เองจะว่าอย่างไร และคำขอจะระบุชื่อทักษะที่ เรียกร้องไว้ rule "Always allow" ที่บันทึกไว้ไม่มีวันอนุมัติแทนได้ เพราะ prose ในคำสั่งเป็นเพียงคำแนะนำที่โมเดลอาจตีความเลยเถิดไปได้ ในขณะที่นี่ถูกบังคับที่ ประตูจริง ส่วน "Allow once" แบบครั้งเดียวยังทำงานได้ตามปกติ เพราะนั่นคือการ ตัดสินใจสด ๆ ไม่ใช่ rule ที่บันทึกไว้ ดูการอนุมัติการกระทำ

ฟิลด์นี้เดินทางไปพร้อมกับทักษะ: มัน round-trip ผ่านการส่งออกและนำเข้าใน JSON envelope รูปแบบแลกเปลี่ยน SKILL.md พกเฉพาะคำสั่ง การนำเข้าแบบ markdown ล้วน จึงตกไปที่ค่าเริ่มต้น (inherit) และต้องตั้งข้อเรียกร้องนี้ใหม่

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

การแชร์และโปรไฟล์

ทักษะเป็นส่วนตัวโดยค่าเริ่มต้นและแชร์ได้ผ่านรูปแบบการให้สิทธิ์ทรัพยากรร่วมกัน โปรไฟล์ผู้ช่วยสามารถผูกทักษะบางส่วน และเซสชันที่ใช้โปรไฟล์นั้นจะเห็นเฉพาะทักษะเหล่านั้นใน manifest

ตัวอย่าง

สร้างทักษะที่ Settings → Skills (หรือเลือกเทมเพลตเริ่มต้นแล้วแก้ไข):

• Slug: cite-sources

• Name: Cite sources

• Description: How to cite evidence: numbered references with URLs, no unreferenced claims. (บรรทัดนี้คือสิ่งที่โมเดลเห็นใน manifest จึงควรระบุว่าเมื่อใดควรใช้ทักษะ)

• Instructions:

  # Citing sources
  
  - Every factual claim gets a numbered reference like [1].
  - End with a References section: number, title, URL.
  - If no source exists, say so instead of inventing one.

เปิดสวิตช์เครื่องมือในช่องเขียนแล้วถามว่า:

สรุปผลลัพธ์ล่าสุดและใช้ $cite-sources

เมื่อพิมพ์ $ ระบบจะแนะนำ slug ของทักษะอัตโนมัติ โมเดลเห็น cite-sources ใน manifest เรียก load_skill เพื่อดึงคำสั่งด้านบน และจัดรูปแบบคำตอบตามนั้น หากปิดทักษะบนการ์ด ทักษะจะหายจาก manifest โดยไม่ถูกลบ