Agent Skills

กำหนดพฤติกรรมที่นำมาใช้ซ้ำได้ผ่านคำจำกัดความ SKILL.md

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

วางไฟล์

สร้างหนึ่งโฟลเดอร์ต่อชื่อทักษะ และใส่ SKILL.md ไว้ข้างใน OpenCode ค้นหาตำแหน่งเหล่านี้:

การกำหนดค่าโครงการ: .opencode/skills/<name>/SKILL.md
การกำหนดค่าส่วนกลาง: ~/.config/opencode/skills/<name>/SKILL.md
เข้ากันได้กับโครงการ Claude: .claude/skills/<name>/SKILL.md
เข้ากันได้กับ Global Claude: ~/.claude/skills/<name>/SKILL.md
เข้ากันได้กับตัวแทนโครงการ: .agents/skills/<name>/SKILL.md
รองรับตัวแทนทั่วโลก: ~/.agents/skills/<name>/SKILL.md

ทำความเข้าใจกับการค้นพบ

สำหรับเส้นทางภายในโปรเจ็กต์ OpenCode จะเดินขึ้นมาจากไดเร็กทอรีการทำงานปัจจุบันของคุณจนกว่าจะถึงแผนผังงาน git โดยจะโหลด skills/*/SKILL.md ที่ตรงกันใน .opencode/ และ .claude/skills/*/SKILL.md หรือ .agents/skills/*/SKILL.md ที่ตรงกันตลอดทาง

คำจำกัดความสากลยังโหลดจาก ~/.config/opencode/skills/*/SKILL.md, ~/.claude/skills/*/SKILL.md และ ~/.agents/skills/*/SKILL.md

เขียน frontmatter

SKILL.md แต่ละอันต้องขึ้นต้นด้วย YAML frontmatter เฉพาะฟิลด์เหล่านี้เท่านั้นที่ได้รับการยอมรับ:

name (จำเป็น)
description (จำเป็น)
license (ไม่บังคับ)
compatibility (ไม่บังคับ)
metadata (ตัวเลือก แมปแบบสตริงต่อสตริง)

ช่อง frontmatter ที่ไม่รู้จักจะถูกละเว้น

ตรวจสอบชื่อ

name ต้อง:

มีความยาว 1–64 อักขระ
เป็นตัวพิมพ์เล็กและตัวเลขคละกันที่มีเครื่องหมายยัติภังค์ตัวคั่นเดียว
ไม่ขึ้นต้นหรือลงท้ายด้วย -
ไม่มี -- ติดต่อกัน
จับคู่ชื่อไดเร็กทอรีที่มี SKILL.md

regex ที่เทียบเท่า:

^[a-z0-9]+(-[a-z0-9]+)*$

ปฏิบัติตามกฎความยาว

description ต้องมีความยาว 1-1,024 ตัวอักษร เจาะจงให้ตัวแทนเลือกได้ถูกต้อง

ใช้ตัวอย่าง

สร้าง .opencode/skills/git-release/SKILL.md แบบนี้:

---
name: git-release
description: Create consistent releases and changelogs
license: MIT
compatibility: opencode
metadata:
  audience: maintainers
  workflow: github
---

## What I do

- Draft release notes from merged PRs
- Propose a version bump
- Provide a copy-pasteable `gh release create` command

## When to use me

Use this when you are preparing a tagged release.
Ask clarifying questions if the target versioning scheme is unclear.

Tool Description Discovery

OpenCode แสดงรายการทักษะที่มีอยู่ในคำอธิบายเครื่องมือ skill แต่ละรายการจะมีชื่อทักษะและคำอธิบาย:

<available_skills>
  <skill>
    <name>git-release</name>
    <description>Create consistent releases and changelogs</description>
  </skill>
</available_skills>

ตัวแทนโหลดทักษะโดยการเรียกเครื่องมือ:

skill({ name: "git-release" })

Configure Permissions

ควบคุมว่าตัวแทนทักษะใดสามารถเข้าถึงโดยใช้สิทธิ์ตามรูปแบบใน opencode.json:

{
  "permission": {
    "skill": {
      "*": "allow",
      "pr-review": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}

การอนุญาต	พฤติกรรม
`allow`	โหลดทักษะทันที
`deny`	ทักษะถูกซ่อนไม่ให้ตัวแทน การเข้าถึงถูกปฏิเสธ
`ask`	ผู้ใช้ได้รับแจ้งให้อนุมัติก่อนที่จะโหลด

รูปแบบที่รองรับไวด์การ์ด: internal-* ตรงกับ internal-docs, internal-tools ฯลฯ

Override per Agent

ให้สิทธิ์แก่ตัวแทนเฉพาะเจาะจงที่แตกต่างจากค่าเริ่มต้นทั่วไป

สำหรับตัวแทนแบบกำหนดเอง (ในตัวแทนส่วนหน้า):

---
permission:
  skill:
    "documents-*": "allow"
---

สำหรับตัวแทนในตัว (ใน opencode.json):

{
  "agent": {
    "plan": {
      "permission": {
        "skill": {
          "internal-*": "allow"
        }
      }
    }
  }
}

ปิดการใช้งานเครื่องมือทักษะ

ปิดการใช้งานทักษะโดยสิ้นเชิงสำหรับตัวแทนที่ไม่ควรใช้:

สำหรับตัวแทนแบบกำหนดเอง:

---
tools:
  skill: false
---

สำหรับตัวแทนในตัว:

{
  "agent": {
    "plan": {
      "tools": {
        "skill": false
      }
    }
  }
}

เมื่อปิดใช้งาน ส่วน <available_skills> จะถูกละเว้นทั้งหมด

แก้ไขปัญหาการโหลด

หากทักษะไม่แสดง:

ตรวจสอบว่า SKILL.md สะกดด้วยตัวพิมพ์ใหญ่ทั้งหมด
ตรวจสอบว่าส่วนหน้าประกอบด้วย name และ description
ตรวจสอบให้แน่ใจว่าชื่อทักษะไม่ซ้ำกันในทุกสถานที่
ตรวจสอบการอนุญาต ทักษะที่มี deny ถูกซ่อนไม่ให้ตัวแทนเห็น