--- read_when: - Anda ingin agen membuat atau memperbarui keterampilan dari obrolan - Anda perlu meninjau, menerapkan, menolak, atau mengarantina draf skill yang dihasilkan - Anda sedang mengonfigurasi persetujuan, otonomi, penyimpanan, atau batas Skill Workshop sidebarTitle: Skill Workshop summary: Buat dan perbarui Skills ruang kerja melalui peninjauan Skill Workshop title: Lokakarya Keterampilan x-i18n: generated_at: "2026-06-27T18:21:10Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 449b9cb4d26731555af97ff5b85a6fed48eecad02c81965ff95d871cc6fe1b33 source_path: tools/skill-workshop.md workflow: 16 --- Skill Workshop adalah jalur tata kelola OpenClaw untuk membuat dan memperbarui skill workspace. Agen dan operator tidak menulis file `SKILL.md` aktif secara langsung melalui jalur ini. Mereka membuat **proposal** terlebih dahulu. Proposal adalah draf tertunda yang berisi konten skill yang diusulkan, pengikatan target, status pemindai, hash, metadata file pendukung, dan metadata rollback. Proposal menjadi skill aktif hanya ketika diterapkan. Skill Workshop hanya menulis skill workspace. Ini tidak mengubah skill bawaan, plugin, ClawHub, root tambahan, terkelola, agen pribadi, atau sistem. ## Cara kerjanya - **Proposal terlebih dahulu:** konten skill yang dihasilkan disimpan sebagai `PROPOSAL.md`, bukan `SKILL.md`. - **Apply adalah satu-satunya penulisan aktif:** buat, perbarui, dan revisi tidak mengubah skill aktif. - **Dicakup ke workspace:** pembuatan menargetkan root `skills/` workspace. Pembaruan hanya diizinkan untuk skill workspace yang dapat ditulis. - **Tidak menimpa:** pembuatan gagal jika skill target sudah ada. - **Terikat hash:** proposal pembaruan terikat ke hash target saat ini dan menjadi kedaluwarsa jika skill aktif berubah sebelum apply. - **Dibatasi pemindai:** apply menjalankan ulang pemindaian sebelum menulis. - **Dapat dipulihkan:** apply menulis metadata rollback sebelum mengubah file aktif. - **Permukaan konsisten:** chat, CLI, dan Gateway semuanya memanggil layanan Skill Workshop yang sama. ## Siklus hidup ```text create/update -> pending revise -> pending apply -> applied reject -> rejected quarantine -> quarantined target change -> stale ``` Hanya proposal `pending` yang dapat direvisi, diterapkan, ditolak, atau dikarantina. ## Chat Minta skill yang Anda inginkan kepada agen. Agen memanggil `skill_workshop` dan mengembalikan id proposal. Buat: ```text Make a skill called morning-catchup that runs my Monday inbox routine. ``` Perbarui skill workspace yang sudah ada: ```text Update trip-planning to also check seat maps before booking. ``` Iterasikan pada proposal tertunda: ```text Show me the morning-catchup proposal. Revise it to also flag anything marked urgent. Apply the morning-catchup proposal. ``` Secara default, `apply`, `reject`, dan `quarantine` yang dimulai oleh agen menampilkan prompt persetujuan sebelum dijalankan. Atur `skills.workshop.approvalPolicy` ke `"auto"` untuk melewati prompt di lingkungan tepercaya. ## CLI Buat proposal skill baru: ```bash openclaw skills workshop propose-create \ --name morning-catchup \ --description "Daily inbox catch-up: triage, archive, surface, draft, plan" \ --proposal ./PROPOSAL.md ``` Buat proposal pembaruan untuk skill workspace yang sudah ada: ```bash openclaw skills workshop propose-update trip-planning --proposal ./PROPOSAL.md ``` Daftar dan periksa: ```bash openclaw skills workshop list openclaw skills workshop inspect ``` Revisi sebelum persetujuan: ```bash openclaw skills workshop revise --proposal ./PROPOSAL.md ``` Tutup proposal: ```bash openclaw skills workshop apply openclaw skills workshop reject --reason "Duplicate" openclaw skills workshop quarantine --reason "Needs security review" ``` ## Konten proposal Saat tertunda, proposal disimpan sebagai `PROPOSAL.md` dengan frontmatter khusus proposal: ```markdown --- name: "morning-catchup" description: "Daily inbox catch-up: triage, archive, surface, draft, plan" status: proposal version: "v1" date: "2026-05-30T00:00:00.000Z" --- ``` Saat apply, Skill Workshop menulis `SKILL.md` aktif dan menghapus field khusus proposal: `status`, `version` proposal, dan `date` proposal. ## File pendukung Gunakan `--proposal-dir` ketika skill yang diusulkan memerlukan file di samping `PROPOSAL.md`: ```bash openclaw skills workshop propose-create \ --name weekly-update \ --description "Friday wrap-up: stats, highlights, next week's top three" \ --proposal-dir ./weekly-update-proposal ``` Direktori harus berisi `PROPOSAL.md`. File pendukung harus berada di bawah: - `assets/` - `examples/` - `references/` - `scripts/` - `templates/` Skill Workshop memindai, membuat hash, dan menyimpan file pendukung bersama proposal. File tersebut ditulis di samping `SKILL.md` aktif hanya saat apply. Path file pendukung yang ditolak mencakup path absolut, segmen path tersembunyi, traversal path, path yang tumpang tindih, file executable dari direktori proposal, teks non-UTF-8, byte null, dan file di luar folder pendukung standar. ## Alat agen Model menggunakan `skill_workshop`: ```text action: create | update | revise | list | inspect | apply | reject | quarantine ``` Agen harus menggunakan `skill_workshop` untuk pekerjaan skill yang dihasilkan. Mereka tidak boleh membuat atau mengubah file proposal melalui `write`, `edit`, `exec`, perintah shell, atau operasi filesystem langsung. `skill_workshop` adalah alat agen bawaan dan disertakan dalam `tools.profile: "coding"`. Jika kebijakan yang lebih ketat menyembunyikannya, tambahkan `skill_workshop` ke daftar aktif `tools.allow`, atau gunakan `tools.alsoAllow: ["skill_workshop"]` ketika cakupan menggunakan profil tanpa `tools.allow` eksplisit. Proses sandbox tidak membangun alat Skill Workshop sisi host, jadi jalankan tindakan peninjauan proposal dari sesi agen sisi host normal atau CLI. ## Persetujuan dan otonomi ```json5 { skills: { workshop: { autonomous: { enabled: false, }, allowSymlinkTargetWrites: false, approvalPolicy: "pending", maxPending: 50, maxSkillBytes: 40000, }, }, } ``` - `autonomous.enabled`: mengizinkan OpenClaw membuat proposal tertunda dari sinyal percakapan yang tahan lama setelah giliran berhasil. Default: `false`. - `allowSymlinkTargetWrites`: mengizinkan apply menulis melalui symlink skill workspace yang target aslinya tercantum dalam `skills.load.allowSymlinkTargets`. Default: `false`. - `approvalPolicy: "pending"`: memerlukan prompt persetujuan sebelum `apply`, `reject`, atau `quarantine` yang dimulai oleh agen. - `approvalPolicy: "auto"`: melewati prompt persetujuan tersebut. Agen tetap harus memanggil tindakan. - `maxPending`: membatasi proposal tertunda dan dikarantina per workspace. - `maxSkillBytes`: membatasi ukuran isi proposal. Default: `40000`. Deskripsi proposal selalu dibatasi hingga 160 byte. ## Metode Gateway ```text skills.proposals.list skills.proposals.inspect skills.proposals.create skills.proposals.update skills.proposals.revise skills.proposals.apply skills.proposals.reject skills.proposals.quarantine ``` Metode hanya-baca memerlukan `operator.read`. Metode yang mengubah memerlukan `operator.admin`. ## Penyimpanan ```text /skill-workshop/ proposals.json proposals// proposal.json PROPOSAL.md rollback.json assets/ examples/ references/ scripts/ templates/ ``` Direktori status default: `~/.openclaw`. - `proposal.json`: rekaman proposal kanonis. - `proposals.json`: indeks daftar cepat, dapat dibangun ulang dari folder proposal. - `PROPOSAL.md`: proposal skill tertunda. - `rollback.json`: metadata pemulihan yang ditulis sebelum apply mengubah file aktif. ## Batas - Deskripsi: 160 byte. - Isi proposal: `skills.workshop.maxSkillBytes` (default 40.000). - File pendukung: 64 per proposal. - Ukuran file pendukung: masing-masing 256 KB, total 2 MB. - Proposal tertunda dan dikarantina: `skills.workshop.maxPending` per workspace (default 50). ## Pemecahan masalah | Masalah | Resolusi | | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Skill proposal description is too large` | Persingkat `description` menjadi 160 byte atau kurang. | | `Skill proposal content is too large` | Persingkat isi proposal atau naikkan `skills.workshop.maxSkillBytes`. | | `Target skill changed after proposal creation` | Revisi proposal terhadap target saat ini, atau buat proposal baru. | | `Proposal scan failed` | Periksa temuan pemindai, lalu revisi atau karantina proposal. | | `untrusted symlink target` | Konfigurasikan `skills.load.allowSymlinkTargets` dan aktifkan `skills.workshop.allowSymlinkTargetWrites` hanya untuk root skill bersama yang disengaja. | | `Support file paths must be under one of...` | Pindahkan file pendukung ke bawah `assets/`, `examples/`, `references/`, `scripts/`, atau `templates/`. | | Proposal tidak muncul dalam daftar | Periksa workspace `--agent` yang dipilih dan `OPENCLAW_STATE_DIR`. | | Agen tidak dapat memanggil `skill_workshop` | Periksa kebijakan alat aktif dan mode jalan. `coding` menyertakan alat ini; kebijakan `tools.allow` yang restriktif harus mencantumkannya secara eksplisit, dan proses sandbox harus menggunakan sesi agen sisi host normal atau CLI. | ## Terkait - [Skills](/id/tools/skills) untuk urutan pemuatan, presedensi, dan visibilitas - [Membuat skill](/id/tools/creating-skills) untuk dasar-dasar `SKILL.md` yang ditulis tangan - [Konfigurasi Skills](/id/tools/skills-config) untuk skema lengkap `skills.workshop` - [CLI Skills](/id/cli/skills) untuk perintah `openclaw skills`