---
title: “ทักษะตัวแทน”
description: "กำหนดพฤติกรรมที่นำมาใช้ซ้ำได้ผ่านคำจำกัดความ 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 ที่เทียบเท่า:

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

---

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

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

---

## ใช้ตัวอย่าง

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

```markdown
---
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.
```

---

## รู้จักคำอธิบายเครื่องมือ

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

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

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

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

---

## กำหนดค่าสิทธิ์

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

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

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

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

---

## แทนที่ต่อตัวแทน

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

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

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

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

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

---

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

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

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

```yaml
---
tools:
  skill: false
---
```

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

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

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

---

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

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

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