ทักษะของเอเจนต์
ทักษะของเจ้าหน้าที่ช่วยให้ 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
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.OpenCode แสดงรายการทักษะที่มีอยู่ในคำอธิบายเครื่องมือ skill
แต่ละรายการจะมีชื่อทักษะและคำอธิบาย:
<available_skills>
<skill>
<name>git-release</name>
<description>Create consistent releases and changelogs</description>
</skill>
</available_skills>ตัวแทนโหลดทักษะโดยการเรียกเครื่องมือ:
skill({ name: "git-release" })ควบคุมว่าตัวแทนทักษะใดสามารถเข้าถึงโดยใช้สิทธิ์ตามรูปแบบใน opencode.json:
{
"permission": {
"skill": {
"*": "allow",
"pr-review": "allow",
"internal-*": "deny",
"experimental-*": "ask"
}
}
}| การอนุญาต | พฤติกรรม |
|---|---|
allow | โหลดทักษะทันที |
deny | ทักษะถูกซ่อนไม่ให้ตัวแทน การเข้าถึงถูกปฏิเสธ |
ask | ผู้ใช้ได้รับแจ้งให้อนุมัติก่อนที่จะโหลด |
รูปแบบที่รองรับไวด์การ์ด: internal-* ตรงกับ internal-docs, internal-tools ฯลฯ
ให้สิทธิ์แก่ตัวแทนเฉพาะเจาะจงที่แตกต่างจากค่าเริ่มต้นทั่วไป
สำหรับตัวแทนแบบกำหนดเอง (ในตัวแทนส่วนหน้า):
---
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ถูกซ่อนไม่ให้ตัวแทนเห็น