Plugin เวิร์กช็อปทักษะ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

<workspace>/skills/<skill-name>/SKILL.md

• หน่วยความจำ เก็บข้อเท็จจริง ความชอบ เอนทิตี และบริบทในอดีต
• Skills เก็บขั้นตอนที่ใช้ซ้ำได้ซึ่ง agent ควรทำตามในงานในอนาคต
• Skill Workshop เป็นสะพานจากรอบการทำงานที่มีประโยชน์ไปสู่ skill ของ workspace ที่คงทน พร้อมการตรวจสอบความปลอดภัยและการอนุมัติแบบเลือกได้

• วิธีตรวจสอบ asset GIF แบบเคลื่อนไหวที่มาจากแหล่งภายนอก
• วิธีแทนที่ asset ภาพหน้าจอและตรวจสอบขนาด
• วิธีเรียกใช้สถานการณ์ QA เฉพาะ repo
• วิธีดีบักความล้มเหลวของ provider ที่เกิดซ้ำ
• วิธีซ่อมบันทึก workflow ในเครื่องที่ล้าสมัย

• ข้อเท็จจริงอย่าง “ผู้ใช้ชอบสีน้ำเงิน”
• หน่วยความจำอัตชีวประวัติแบบกว้าง
• การเก็บถาวร transcript ดิบ
• secret, credential หรือข้อความพรอมป์ที่ซ่อนอยู่
• คำสั่งแบบใช้ครั้งเดียวที่ไม่เกิดซ้ำ

​

สถานะเริ่มต้น

• Plugin ได้รับการรองรับมากพอสำหรับการทดสอบแบบ opt-in และการใช้งานภายใน
• พื้นที่จัดเก็บ proposal, threshold ของผู้ตรวจทาน และ heuristics สำหรับการจับข้อมูลสามารถพัฒนาเปลี่ยนแปลงได้
• การอนุมัติแบบ pending เป็นโหมดเริ่มต้นที่แนะนำ
• auto apply มีไว้สำหรับการตั้งค่าส่วนตัวหรือ workspace ที่เชื่อถือได้ ไม่ใช่สภาพแวดล้อมที่ใช้ร่วมกันหรือมี input จำนวนมากที่ไม่น่าเชื่อถือ

​

เปิดใช้งาน

{
  plugins: {
    entries: {
      "skill-workshop": {
        enabled: true,
        config: {
          autoCapture: true,
          approvalPolicy: "pending",
          reviewMode: "hybrid",
        },
      },
    },
  },
}

• เครื่องมือ skill_workshop พร้อมใช้งาน
• การแก้ไขที่ใช้ซ้ำได้อย่างชัดเจนจะถูกจัดคิวเป็น proposal แบบ pending
• การตรวจทานตาม threshold สามารถเสนอการอัปเดต skill ได้
• จะไม่มีการเขียนไฟล์ skill จนกว่า proposal แบบ pending จะถูกนำไปใช้

{
  plugins: {
    entries: {
      "skill-workshop": {
        enabled: true,
        config: {
          autoCapture: true,
          approvalPolicy: "auto",
          reviewMode: "hybrid",
        },
      },
    },
  },
}

​

การกำหนดค่า

// Conservative: explicit tool use only, no automatic capture.
{
  autoCapture: false,
  approvalPolicy: "pending",
  reviewMode: "off",
}

// Review-first: capture automatically, but require approval.
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "hybrid",
}

// Trusted automation: write safe proposals immediately.
{
  autoCapture: true,
  approvalPolicy: "auto",
  reviewMode: "hybrid",
}

// Low-cost: no reviewer LLM call, only explicit correction phrases.
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "heuristic",
}

​

เส้นทางการจับข้อมูล

​

คำแนะนำจากเครื่องมือ

​

การจับข้อมูลด้วย heuristic

• next time
• from now on
• remember to
• make sure to
• always ... use/check/verify/record/save/prefer
• prefer ... when/for/instead/use
• when asked

• งาน GIF แบบเคลื่อนไหว -> animated-gif-workflow
• งานภาพหน้าจอหรือ asset -> screenshot-asset-workflow
• งาน QA หรือสถานการณ์ -> qa-scenario-workflow
• งาน GitHub PR -> github-pr-workflow
• fallback -> learned-workflows

​

ผู้ตรวจทาน LLM

• ข้อความ transcript ล่าสุด จำกัดไว้ที่ 12,000 อักขระสุดท้าย
• Skills ของ workspace ที่มีอยู่สูงสุด 12 รายการ
• อักขระสูงสุด 2,000 ตัวจากแต่ละ skill ที่มีอยู่
• คำสั่งแบบ JSON เท่านั้น

• disableTools: true
• toolsAllow: []
• disableMessageTool: true

{
  "action": "create",
  "skillName": "media-asset-qa",
  "title": "Media Asset QA",
  "reason": "Reusable animated media acceptance workflow",
  "description": "Validate externally sourced animated media before product use.",
  "body": "## Workflow\n\n- Verify true animation.\n- Record attribution.\n- Store a local approved copy.\n- Verify in product UI before final reply."
}

​

วงจรชีวิตของ proposal

• id
• createdAt
• updatedAt
• workspaceDir
• agentId แบบเลือกได้
• sessionId แบบเลือกได้
• skillName
• title
• reason
• source: tool, agent_end หรือ reviewer
• status
• change
• scanFindings แบบเลือกได้
• quarantineReason แบบเลือกได้

• pending - รอการอนุมัติ
• applied - เขียนไปยัง <workspace>/skills
• rejected - ถูกปฏิเสธโดย operator/model
• quarantined - ถูกบล็อกโดย finding ระดับ critical จาก scanner

<stateDir>/skill-workshop/<workspace-hash>.json

​

ข้อมูลอ้างอิงเครื่องมือ

skill_workshop

​

status

{ "action": "status" }

{
  "workspaceDir": "/path/to/workspace",
  "pending": 1,
  "quarantined": 0,
  "applied": 3,
  "rejected": 0
}

​

list_pending

{ "action": "list_pending" }

{ "action": "list_pending", "status": "applied" }

• pending
• applied
• rejected
• quarantined

​

list_quarantine

{ "action": "list_quarantine" }

​

inspect

{
  "action": "inspect",
  "id": "proposal-id"
}

​

suggest

{
  "action": "suggest",
  "skillName": "animated-gif-workflow",
  "title": "Animated GIF Workflow",
  "reason": "User established reusable GIF validation rules.",
  "description": "Validate animated GIF assets before using them.",
  "body": "## Workflow\n\n- Verify the URL resolves to image/gif.\n- Confirm it has multiple frames.\n- Record attribution and license.\n- Avoid hotlinking when a local asset is needed."
}

{
  "action": "suggest",
  "apply": true,
  "skillName": "animated-gif-workflow",
  "description": "Validate animated GIF assets before using them.",
  "body": "## Workflow\n\n- Verify true animation.\n- Record attribution."
}

{
  "action": "suggest",
  "apply": false,
  "skillName": "screenshot-asset-workflow",
  "description": "Screenshot replacement workflow.",
  "body": "## Workflow\n\n- Verify dimensions.\n- Optimize the PNG.\n- Run the relevant gate."
}

{
  "action": "suggest",
  "skillName": "qa-scenario-workflow",
  "section": "Workflow",
  "description": "QA scenario workflow.",
  "body": "- For media QA, verify generated assets render and pass final assertions."
}

{
  "action": "suggest",
  "skillName": "github-pr-workflow",
  "oldText": "- Check the PR.",
  "newText": "- Check unresolved review threads, CI status, linked issues, and changed files before deciding."
}

​

apply

{
  "action": "apply",
  "id": "proposal-id"
}

quarantined proposal cannot be applied

​

reject

{
  "action": "reject",
  "id": "proposal-id"
}

​

write_support_file

• references/
• templates/
• scripts/
• assets/

{
  "action": "write_support_file",
  "skillName": "release-workflow",
  "relativePath": "references/checklist.md",
  "body": "# Release Checklist\n\n- Run release docs.\n- Verify changelog.\n"
}

​

การเขียน Skill

<workspace>/skills/<normalized-skill-name>/

• แปลงเป็นตัวพิมพ์เล็ก
• ช่วงของอักขระที่ไม่ใช่ [a-z0-9_-] จะกลายเป็น -
• อักขระที่ไม่ใช่ตัวอักษรและตัวเลขที่ต้น/ท้ายจะถูกลบออก
• ความยาวสูงสุดคือ 80 อักขระ
• ชื่อสุดท้ายต้องตรงกับ [a-z0-9][a-z0-9_-]{1,79}

• หาก Skill ยังไม่มีอยู่ Skill Workshop จะเขียน SKILL.md ใหม่
• หากมีอยู่แล้ว Skill Workshop จะต่อท้ายเนื้อหาไปที่ ## Workflow

• หาก Skill มีอยู่ Skill Workshop จะต่อท้ายในส่วนที่ร้องขอ
• หากไม่มีอยู่ Skill Workshop จะสร้าง Skill ขั้นต่ำแล้วต่อท้าย

• Skill ต้องมีอยู่แล้ว
• ต้องมี oldText อยู่ตรงกันแบบสมบูรณ์
• แทนที่เฉพาะรายการแรกที่ตรงกันแบบสมบูรณ์เท่านั้น

​

โมเดลความปลอดภัย

• เก็บ scanFindings
• เก็บ quarantineReason
• ปรากฏใน list_quarantine
• ไม่สามารถนำไปใช้ผ่าน apply

​

แนวทางพรอมป์

• ขั้นตอน ไม่ใช่ข้อเท็จจริง/ความชอบ
• การแก้ไขจากผู้ใช้
• ขั้นตอนที่สำเร็จซึ่งไม่ชัดเจน
• ข้อผิดพลาดที่เกิดซ้ำ
• การซ่อม Skill ที่ล้าสมัย/บาง/ผิด ผ่าน append/replace
• การบันทึกขั้นตอนที่นำกลับมาใช้ได้หลังจากลูปเครื่องมือยาวๆ หรือการแก้ไขที่ยาก
• ข้อความ Skill แบบคำสั่งสั้นๆ
• ไม่มีการดัมป์ทรานสคริปต์

• โหมด pending: เข้าคิวคำแนะนำ ใช้ apply หลังได้รับการอนุมัติอย่างชัดเจน
• โหมด auto: นำการอัปเดต workspace-skill ที่ปลอดภัยไปใช้ เว้นแต่ apply: false จะเข้าคิวแทน

​

ค่าใช้จ่ายและพฤติกรรมรันไทม์

• ใช้บริบท provider/model ที่กำหนดค่าเดียวกันเมื่อมี
• ถอยกลับไปใช้ค่าเริ่มต้นของเอเจนต์รันไทม์
• มี reviewTimeoutMs
• ใช้บริบทเริ่มต้นแบบเบา
• ไม่มีเครื่องมือ
• ไม่เขียนอะไรโดยตรง
• ทำได้เพียงปล่อยข้อเสนอที่ผ่านตัวสแกนปกติและเส้นทาง การอนุมัติ/กักกัน

​

รูปแบบการใช้งาน

• “next time, do X”
• “from now on, prefer Y”
• “make sure to verify Z”
• “save this as a workflow”
• “this took a while; remember the process”
• “update the local skill for this”

## Workflow

- Verify the GIF URL resolves to `image/gif`.
- Confirm the file has multiple frames.
- Record source URL, license, and attribution.
- Store a local copy when the asset will ship with the product.
- Verify the local asset renders in the target UI before final reply.

The user asked about a GIF and I searched two websites. Then one was blocked by
Cloudflare. The final answer said to check attribution.

• มีรูปแบบเหมือนทรานสคริปต์
• ไม่ใช่คำสั่ง
• มีรายละเอียดเฉพาะครั้งที่เป็นเสียงรบกวน
• ไม่ได้บอกเอเจนต์ถัดไปว่าต้องทำอะไร

​

การดีบัก

openclaw plugins list --enabled

{ "action": "status" }

{ "action": "list_pending" }

{ "action": "list_quarantine" }

• skill-workshop: queued <skill>
• skill-workshop: applied <skill>
• skill-workshop: quarantined <skill>
• skill-workshop: heuristic capture skipped: ...
• skill-workshop: reviewer skipped: ...
• skill-workshop: reviewer found no update

​

สถานการณ์ QA

• qa/scenarios/plugins/skill-workshop-animated-gif-autocreate.md
• qa/scenarios/plugins/skill-workshop-pending-approval.md
• qa/scenarios/plugins/skill-workshop-reviewer-autonomous.md

pnpm openclaw qa suite \
  --scenario skill-workshop-animated-gif-autocreate \
  --scenario skill-workshop-pending-approval \
  --concurrency 1

pnpm openclaw qa suite \
  --scenario skill-workshop-reviewer-autonomous \
  --concurrency 1

​

เมื่อไม่ควรเปิดใช้งานการนำไปใช้อัตโนมัติ

• เวิร์กสเปซมีขั้นตอนที่ละเอียดอ่อน
• เอเจนต์กำลังทำงานกับอินพุตที่ไม่น่าเชื่อถือ
• Skills ถูกแชร์ในทีมขนาดใหญ่
• คุณยังปรับพรอมป์หรือกฎสแกนเนอร์อยู่
• โมเดลจัดการเนื้อหาเว็บ/อีเมลที่เป็นภัยบ่อยครั้ง

​

เอกสารที่เกี่ยวข้อง

• Skills
• Plugins
• การทดสอบ