Plugin workshop kỹ năng

Documentation Index

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

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

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

• Memory lưu trữ dữ kiện, tùy chọn, thực thể, và ngữ cảnh trước đây.
• Skills lưu trữ các quy trình có thể tái sử dụng mà agent nên làm theo trong các tác vụ tương lai.
• Skill Workshop là cầu nối từ một lượt hữu ích đến một skill bền vững trong workspace với các kiểm tra an toàn và tùy chọn phê duyệt.

• cách xác thực tài nguyên GIF động có nguồn từ bên ngoài
• cách thay thế tài nguyên ảnh chụp màn hình và xác minh kích thước
• cách chạy một kịch bản QA riêng của repo
• cách gỡ lỗi một lỗi provider lặp lại
• cách sửa một ghi chú quy trình cục bộ đã lỗi thời

• dữ kiện như “người dùng thích màu xanh”
• bộ nhớ tự truyện rộng
• lưu trữ transcript thô
• bí mật, thông tin xác thực, hoặc văn bản prompt ẩn
• hướng dẫn dùng một lần sẽ không lặp lại

​

Trạng thái mặc định

• plugin được hỗ trợ đủ để kiểm thử opt-in và dogfooding
• lưu trữ đề xuất, ngưỡng reviewer, và heuristic capture có thể phát triển
• phê duyệt pending là chế độ khởi đầu được khuyến nghị
• auto apply dành cho thiết lập cá nhân/workspace đáng tin cậy, không dành cho môi trường chia sẻ hoặc thù địch có nhiều đầu vào

​

Bật

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

• công cụ skill_workshop khả dụng
• các chỉnh sửa có thể tái sử dụng rõ ràng được xếp hàng thành đề xuất pending
• các lượt reviewer dựa trên ngưỡng có thể đề xuất cập nhật skill
• không tệp skill nào được ghi cho đến khi một đề xuất pending được áp dụng

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

​

Cấu hình

// 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",
}

​

Đường dẫn capture

​

Đề xuất công cụ

​

Capture bằng 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

• tác vụ GIF động -> animated-gif-workflow
• tác vụ ảnh chụp màn hình hoặc tài nguyên -> screenshot-asset-workflow
• tác vụ QA hoặc kịch bản -> qa-scenario-workflow
• tác vụ GitHub PR -> github-pr-workflow
• dự phòng -> learned-workflows

​

Reviewer LLM

• văn bản transcript gần đây, giới hạn ở 12.000 ký tự cuối
• tối đa 12 skill workspace hiện có
• tối đa 2.000 ký tự từ mỗi skill hiện có
• hướng dẫn chỉ 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."
}

​

Vòng đời đề xuất

• id
• createdAt
• updatedAt
• workspaceDir
• agentId tùy chọn
• sessionId tùy chọn
• skillName
• title
• reason
• source: tool, agent_end, hoặc reviewer
• status
• change
• scanFindings tùy chọn
• quarantineReason tùy chọn

• pending - đang chờ phê duyệt
• applied - đã ghi vào <workspace>/skills
• rejected - bị operator/model từ chối
• quarantined - bị chặn bởi các phát hiện nghiêm trọng của scanner

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

​

Tham chiếu công cụ

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"
}

​

Ghi skill

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

• chuyển thành chữ thường
• các chuỗi không phải [a-z0-9_-] trở thành -
• các ký tự không phải chữ và số ở đầu/cuối bị loại bỏ
• độ dài tối đa là 80 ký tự
• tên cuối cùng phải khớp với [a-z0-9][a-z0-9_-]{1,79}

• nếu skill chưa tồn tại, Skill Workshop ghi một SKILL.md mới
• nếu đã tồn tại, Skill Workshop nối phần body vào ## Workflow

• nếu skill tồn tại, Skill Workshop nối vào mục được yêu cầu
• nếu skill không tồn tại, Skill Workshop tạo một skill tối thiểu rồi nối vào

• skill phải đã tồn tại
• oldText phải hiện diện chính xác
• chỉ kết quả khớp chính xác đầu tiên được thay thế

​

Mô hình an toàn

• giữ scanFindings
• giữ quarantineReason
• xuất hiện trong list_quarantine
• không thể được áp dụng qua apply

​

Hướng dẫn prompt

• quy trình, không phải sự kiện/tùy chọn
• các chỉnh sửa của người dùng
• các quy trình thành công không hiển nhiên
• các lỗi thường gặp lặp lại
• sửa skill cũ/mỏng/sai bằng append/replace
• lưu quy trình có thể tái sử dụng sau các vòng lặp công cụ dài hoặc bản sửa khó
• văn bản skill ngắn gọn theo lối mệnh lệnh
• không dump transcript

• chế độ pending: xếp hàng gợi ý; dùng apply sau khi có phê duyệt rõ ràng
• chế độ auto: áp dụng các cập nhật workspace-skill an toàn trừ khi apply: false chuyển sang xếp hàng

​

Chi phí và hành vi runtime

• dùng cùng ngữ cảnh provider/model đã cấu hình khi có sẵn
• fallback về mặc định agent runtime
• có reviewTimeoutMs
• dùng ngữ cảnh bootstrap nhẹ
• không có công cụ
• không ghi trực tiếp gì
• chỉ có thể phát ra một đề xuất đi qua bộ quét bình thường và đường dẫn phê duyệt/cách ly

​

Mẫu vận hành

• “lần sau, hãy làm X”
• “từ giờ trở đi, ưu tiên Y”
• “đảm bảo xác minh Z”
• “lưu điều này thành một workflow”
• “việc này mất một lúc; hãy nhớ quy trình”
• “cập nhật skill cục bộ cho việc này”

## 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.

• có dạng transcript
• không mang tính mệnh lệnh
• bao gồm chi tiết một lần gây nhiễu
• không cho agent tiếp theo biết phải làm gì

​

Gỡ lỗi

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

​

Kịch bản 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

​

Khi không nên bật tự động áp dụng

• workspace chứa các quy trình nhạy cảm
• agent đang làm việc trên đầu vào không đáng tin cậy
• skills được chia sẻ trên một nhóm rộng
• bạn vẫn đang tinh chỉnh prompt hoặc quy tắc quét
• model thường xuyên xử lý nội dung web/email đối địch

​

Tài liệu liên quan

• Skills
• Plugins
• Kiểm thử