อ้างอิง

Schema ของ marketplace.json

ไฟล์ manifest ของตลาดกลางอยู่ที่ .claude-plugin/marketplace.json ในไดเรกทอรีราก repository

ฟิลด์ระดับบนสุด

ฟิลด์	จำเป็น	คำอธิบาย
$schema	ไม่	URL ของ JSON Schema สำหรับการตรวจสอบ
name	ใช่	ตัวระบุเฉพาะของตลาดกลาง
version	ไม่	เวอร์ชัน schema ของตลาดกลาง (semver)
metadata.description	ใช่	คำอธิบายตลาดกลางที่อ่านได้โดยมนุษย์
owner.name	ใช่	องค์กรหรือผู้ใช้ที่เป็นเจ้าของตลาดกลาง
owner.url	ไม่	URL ไปยังโปรไฟล์หรือเว็บไซต์ของเจ้าของ
owner.email	ไม่	อีเมลติดต่อ
plugins	ใช่	อาร์เรย์ของรายการ plugin

ฟิลด์รายการ Plugin

ฟิลด์	จำเป็น	คำอธิบาย
name	ใช่	ตัวระบุ plugin (ต้องตรงกับ plugin.json)
description	ใช่	คำอธิบายสั้นของ plugin
version	ใช่	สตริงเวอร์ชันแบบ Semantic
author.name	ใช่	ผู้เขียน plugin
source	ใช่	พาธหรือ URL ไปยัง plugin (ดู ประเภท Source)
category	ใช่	หมวดหมู่ plugin (เช่น productivity)
homepage	ไม่	URL ไปยังเอกสารหรือหน้าหลักของ plugin
license	ไม่	ตัวระบุใบอนุญาต SPDX
keywords	ไม่	อาร์เรย์ของคำค้นหา
tags	ไม่	อาร์เรย์ของแท็กสำหรับการกรอง
repository	ไม่	URL ของ repository

ประเภท Source ของ Plugin

ฟิลด์ source ใน marketplace.json รองรับหลายรูปแบบ:

ประเภท	ตัวอย่าง	คำอธิบาย
พาธสัมพัทธ์	./plugins/example-plugin	Plugin ใน repository เดียวกัน
GitHub shorthand	owner/repo	Plugin ที่รากของ repository
GitHub พร้อมพาธ	owner/repo/path/to/plugin	Plugin ในไดเรกทอรีย่อย
Git URL	https://github.com/owner/repo.git	Git repository
npm package	npm:@scope/package	npm package ที่เผยแพร่แล้ว

Schema ของ plugin.json

Plugin แต่ละตัวมีไฟล์ manifest ที่ .claude-plugin/plugin.json ภายในไดเรกทอรีของตัวเอง

ฟิลด์	จำเป็น	คำอธิบาย
name	ใช่	ตัวระบุ plugin
description	ใช่	สิ่งที่ plugin ทำ
version	ใช่	Semantic version
author.name	ใช่	ผู้เขียน plugin
author.url	ไม่	URL ไปยังโปรไฟล์หรือเว็บไซต์ของผู้เขียน
homepage	ไม่	URL เอกสาร
keywords	ไม่	คำค้นหา
license	ไม่	ตัวระบุใบอนุญาต SPDX
repository	ไม่	URL ของ repository

โครงสร้างไดเรกทอรี Plugin

plugins/example-plugin/
  .claude-plugin/
    plugin.json          # Plugin manifest (required)
  skills/
    skill-name/
      SKILL.md           # Skill definition (required per skill)
      references/        # Reference data files (optional)
  commands/
    command-name.md      # Command definition (one per command)
  agents/
    agent-name.md        # Agent definition (one per agent)
  README.md              # Plugin documentation (recommended)

ตัวแปรสภาพแวดล้อม

Plugin สามารถใช้ตัวแปรเหล่านี้ในไฟล์ skill และ command ของตัวเอง:

ตัวแปร	คำอธิบาย
$\{CLAUDE_PLUGIN_ROOT\}	พาธสัมบูรณ์ไปยังไดเรกทอรีรากของ plugin

การตรวจสอบ

ตรวจสอบ manifest ของตลาดกลางและ plugin ในเครื่องของคุณ:

claude plugin validate .

ซึ่งจะตรวจสอบ:

• ความสอดคล้องของ schema กับ marketplace.json
• ไดเรกทอรี plugin ที่อ้างอิงทั้งหมดมีอยู่จริง
• Plugin แต่ละตัวมี plugin.json ที่ถูกต้อง
• Skill มี frontmatter ของ SKILL.md ที่มีรูปแบบถูกต้อง
• Command มีฟิลด์ frontmatter ที่จำเป็น

การกำหนดค่าสำหรับทีม

การกำหนดค่า marketplace ล่วงหน้า

เพิ่มลงใน .claude/settings.json ใน repository ใดก็ได้:

{
  "extraKnownMarketplaces": [
    "f5-sales-demo/marketplace"
  ]
}

การเปิดใช้งาน plugin ล่วงหน้า

{
  "enabledPlugins": [
    "f5xc-docs-tools@f5-sales-demo-marketplace"
  ]
}

เคล็ดลับ

การ commit การตั้งค่าเหล่านี้ไปยัง repository ของคุณ จะทำให้สมาชิกในทีมทุกคนได้รับการกำหนดค่า marketplace และ plugin เดียวกันโดยอัตโนมัติ

การแก้ไขปัญหา

ไม่พบตลาดกลาง

ตรวจสอบว่าได้เพิ่ม marketplace แล้ว:

/plugin marketplace list

หากไม่พบ ให้เพิ่มอีกครั้ง:

/plugin marketplace add f5-sales-demo/marketplace

Plugin ไม่ทำงาน

• ยืนยันว่า plugin ถูกติดตั้งแล้ว: /plugin list
• ตรวจสอบว่าเวอร์ชัน Claude Code ของคุณรองรับ plugin (v1.0.33+)
• ตรวจสอบว่าเงื่อนไขการทริกเกอร์ของ skill ตรงกับบริบทปัจจุบันของคุณ

Skill ไม่ทำงานอัตโนมัติ

Skill จะทำงานตามฟิลด์ description ใน frontmatter ของ SKILL.md หาก skill ไม่ทำงานตามที่คาดไว้:

• ตรวจสอบว่า description อธิบายบริบทการทริกเกอร์ได้อย่างถูกต้อง
• ใช้คำสั่งโดยตรง (เช่น /f5xc-docs-tools:review-mdx) เป็นวิธีแก้ปัญหาชั่วคราว

ข้อผิดพลาดการ build หลังการตรวจสอบ

Plugin รายงานปัญหาแต่ไม่แก้ไขให้อัตโนมัติ ใช้การแก้ไขที่แนะนำด้วยตนเอง จากนั้นรันการตรวจสอบอีกครั้งเพื่อยืนยันการแก้ไข