Skip to main content

Plugin Hints สำหรับ Claude Code

CLI hint protocol สำหรับการแนะนำ plugins จาก CLIs

ภาพรวม​

Plugin Hints เป็นโปรโตคอลที่ช่วยให้ command-line tools อื่น ๆ สามารถแนะนำ Claude Code plugins แก่ผู้ใช้ได้อัตโนมัติเมื่อมีการใช้งานเครื่องมือนั้น

วิธีการทำงาน​

เมื่อ Claude Code รัน shell commands ระบบจะตรวจสอบ output ของคำสั่งนั้น หากพบ hint string พิเศษ Claude Code จะแสดงคำแนะนำให้ติดตั้ง plugin ที่เกี่ยวข้อง

รูปแบบ Hint​

CLI tool ส่ง hint ผ่าน stderr ในรูปแบบ:

#claude-plugin-hint: <plugin-name>@<marketplace>

ตัวอย่าง:

# สร้าง script ที่ส่ง hint
#!/bin/bash
echo "Running my-tool..." >&2
echo "#claude-plugin-hint: my-tool-plugin@my-marketplace" >&2
# ... ทำงานตามปกติ

การ Implement ใน CLI Tool ของคุณ​

Python​

import sys

def suggest_plugin():
    print("#claude-plugin-hint: my-tool-plugin@my-marketplace", file=sys.stderr)

# เรียกเมื่อผู้ใช้ใช้ feature ที่ต้องการ plugin
suggest_plugin()

Node.js​

function suggestPlugin() {
  process.stderr.write('#claude-plugin-hint: my-tool-plugin@my-marketplace\n');
}

// เรียกเมื่อเหมาะสม
suggestPlugin();

Bash​

suggest_plugin() {
  echo "#claude-plugin-hint: my-tool-plugin@my-marketplace" >&2
}

suggest_plugin

ตัวอย่างการใช้งาน​

สมมติว่าคุณมี CLI tool ชื่อ my-linter ที่มี Claude Code plugin สำหรับแสดง diagnostics ใน IDE:

#!/bin/bash
# my-linter script

# แนะนำ plugin ถ้ามี
if command -v claude &> /dev/null; then
  echo "#claude-plugin-hint: my-linter-plugin@my-marketplace" >&2
fi

# รัน linter ตามปกติ
run_linter "$@"

ประสบการณ์ผู้ใช้​

เมื่อ Claude Code ตรวจพบ hint:

  1. แสดง notification: "เครื่องมือ my-tool แนะนำ plugin: my-tool-plugin"
  2. ผู้ใช้สามารถเลือกติดตั้งหรือปิดแจ้งเตือน
  3. ถ้าติดตั้ง จะสามารถใช้ผ่าน /my-tool-plugin:command ได้ทันที

ข้อดีของ Plugin Hints​

  • การ Discovery ที่ง่ายขึ้น: ผู้ใช้ค้นพบ plugins ที่เกี่ยวข้องโดยอัตโนมัติ
  • Context-aware: แนะนำเฉพาะเมื่อผู้ใช้กำลังใช้เครื่องมือนั้น
  • ไม่บังคับ: ผู้ใช้เลือกได้ว่าจะติดตั้งหรือไม่

ดูสิ่งที่เกี่ยวข้อง​