Thanawat Wongchai

Posted on Mar 19 • Originally published at apidog.com

วิธีแปลงเอไอเอเจนต์เดียวให้ทำงานใน 10 IDE

#ai #agents #automation #tooling

สรุปย่อ

แปลงไฟล์เอไอเอเจนต์หนึ่งไฟล์เป็น 10 IDEs ใน 3 ขั้นตอน: (1) แยก YAML frontmatter ด้วยฟังก์ชัน bash get_field(), get_body() และ to_kebab() (2) แปลงเป็นรูปแบบเฉพาะของเครื่องมือโดยใช้ convert.sh (Claude Code .md, Cursor .mdc, Aider CONVENTIONS.md, Windsurf .windsurfrules) (3) ติดตั้งไปยังพาธที่ถูกต้องด้วย install.sh เขียนครั้งเดียว แปลงอัตโนมัติ ใช้งานได้ทุกที่

ทดลองใช้ Apidog วันนี้

ไฟล์เอเจนต์หนึ่งไฟล์ สิบ IDEs เรียนรู้ว่าโปรเจกต์ The Agency แปลงไฟล์ Markdown ไฟล์เดียวให้ทำงานได้กับ Claude Code, Cursor, Aider, Windsurf, GitHub Copilot และเครื่องมืออื่นๆ อีก 6+ ตัวได้อย่างไร

คุณเขียนเอไอเอเจนต์ตัวหนึ่ง ตอนนี้คุณต้องการให้มันใช้งานได้ใน:

Claude Code (ไฟล์ .md ใน ~/.claude/agents/)
Cursor (ไฟล์ .mdc ใน .cursor/rules/)
Aider (ไฟล์ CONVENTIONS.md ไฟล์เดียวใน root ของโปรเจกต์)
Windsurf (ไฟล์ .windsurfrules ไฟล์เดียว)
GitHub Copilot (ไฟล์ .md ใน ~/.github/agents/)
และเครื่องมืออื่นๆ อีก 5+ ตัว

คุณจะเขียน 10 เวอร์ชันหรือไม่? ไม่ คุณเขียนครั้งเดียว แล้วแปลงโดยอัตโนมัติ

โปรเจกต์ The Agency แก้ปัญหานี้ด้วยสคริปต์ bash สองตัว:

convert.sh — แปลงไฟล์เอเจนต์เป็นรูปแบบเฉพาะของเครื่องมือ
install.sh — คัดลอกไฟล์ที่แปลงแล้วไปยังพาธที่ถูกต้อง

ในบทช่วยสอนนี้ คุณจะได้ทำวิศวกรรมย้อนกลับสคริปต์ทั้งสองตัวนี้ คุณจะได้เรียนรู้วิธีแยก YAML frontmatter, แยกเนื้อหาหลัก และสร้างไปป์ไลน์การแปลงสำหรับเครื่องมือใดๆ

💡 ไม่ว่าคุณจะปรับใช้เอเจนต์สำหรับเวิร์กโฟลว์การพัฒนา API ด้วยการรวม Apidog หรือสร้างเอเจนต์ทดสอบเฉพาะทาง ระบบการแปลงช่วยให้มั่นใจได้ว่าเอเจนต์เหล่านั้นจะทำงานได้ใน IDEs ที่ทีมของคุณเลือกใช้ทั้งหมด

รูปแบบของเอเจนต์

เอเจนต์ทุกตัวใน The Agency ใช้โครงสร้างเดียวกัน:

---
name: API Tester
description: "Specialized in API testing with Apidog, Postman, and automated validation"
color: purple
emoji: 🧪
vibe: Breaks APIs before users do.
---

# API Tester Agent Personality

You are **API Tester**, an expert in API validation...

## Identity & Memory
- Role: API testing specialist
- Personality: Thorough, skeptical, evidence-focused
...

ไฟล์มีสองส่วน:

Frontmatter — เมตาดาต้า YAML ที่อยู่ระหว่างตัวคั่น ---
Body — เนื้อหา Markdown หลังตัวคั่น --- ตัวที่สอง

การแปลงหมายถึง: แยกฟิลด์ frontmatter, แปลงเนื้อหาหลักเป็นรูปแบบเป้าหมาย, เขียนไปยังพาธที่ถูกต้อง

ขั้นตอนที่ 1: แยกวิเคราะห์ YAML Frontmatter

สร้าง parse-frontmatter.sh:

#!/usr/bin/env bash
#
# parse-frontmatter.sh — แยกฟิลด์ YAML frontmatter จากไฟล์เอเจนต์
#

set -euo pipefail

# แยกค่าฟิลด์เดียวจาก YAML frontmatter
# การใช้งาน: get_field <field> <file>
get_field() {
  local field="$1" file="$2"
  awk -v f="$field" '
    /^---$/ { fm++; next }
    fm == 1 && $0 ~ "^" f ": " {
      sub("^" f ": ", "");
      print;
      exit
    }
  ' "$file"
}

# ลบ frontmatter, ส่งคืนเฉพาะเนื้อหาหลัก
# การใช้งาน: get_body <file>
get_body() {
  awk 'BEGIN{fm=0} /^---$/{fm++; next} fm>=2{print}' "$1"
}

# แปลงชื่อเป็น kebab-case slug
# การใช้งาน: to_kebab "API Tester" → api-tester
to_kebab() {
  echo "$1" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g'
}

# ตัวอย่าง
if [[ "${1:-}" == "--demo" ]]; then
  AGENT_FILE="${2:-test-agent.md}"
  echo "ไฟล์: $AGENT_FILE"
  echo "ชื่อ: $(get_field 'name' "$AGENT_FILE")"
  echo "คำอธิบาย: $(get_field 'description' "$AGENT_FILE")"
  echo "สลัก: $(to_kebab "$(get_field 'name' "$AGENT_FILE")")"
  echo "---"
  echo "ตัวอย่างเนื้อหา:"
  get_body "$AGENT_FILE" | head -10
fi

ทดสอบ:

chmod +x parse-frontmatter.sh
./parse-frontmatter.sh --demo engineering-backend-architect.md

ผลลัพธ์:

ไฟล์: engineering-backend-architect.md
ชื่อ: Backend Architect
คำอธิบาย: สถาปนิกแบ็คเอนด์อาวุโสที่เชี่ยวชาญด้านการออกแบบระบบที่ปรับขนาดได้...
สลัก: backend-architect
---
ตัวอย่างเนื้อหา:
# บุคลิกของเอเจนต์ Backend Architect

คุณคือ **Backend Architect** สถาปนิกแบ็คเอนด์อาวุโส...

ขั้นตอนที่ 2: แปลงเป็นรูปแบบ Claude Code

Claude Code ใช้ไฟล์ .md ดิบ ไม่จำเป็นต้องแปลง — แค่คัดลอก:

convert_claude_code() {
  local agent_file="$1"
  local dest="$HOME/.claude/agents/"
  mkdir -p "$dest"
  cp "$agent_file" "$dest/"
  echo "  Claude Code: $(basename "$agent_file")"
}

ขั้นตอนที่ 3: แปลงเป็นรูปแบบ Cursor

Cursor ใช้ไฟล์ .mdc ที่มีฟิลด์ description ใน frontmatter:

convert_cursor() {
  local agent_file="$1"
  local name=$(get_field 'name' "$agent_file")
  local description=$(get_field 'description' "$agent_file")
  local slug=$(to_kebab "$name")
  local body=$(get_body "$agent_file")

  local output=".cursor/rules/agency-${slug}.mdc"
  mkdir -p "$(dirname "$output")"

  cat > "$output" << EOF
---
description: เอเจนต์ของ Agency: $description
---
$body
EOF

  echo "  Cursor: agency-${slug}.mdc"
}

ข้อมูลนำเข้า:

---
name: API Tester
description: Specialized in API testing...
---

# API Tester Agent...

ข้อมูลส่งออก (.mdc):

---
description: เอเจนต์ของ Agency: Specialized in API testing...
---

# API Tester Agent...

ขั้นตอนที่ 4: แปลงเป็นรูปแบบ Aider

Aider ใช้ไฟล์ CONVENTIONS.md ไฟล์เดียวที่มีเอเจนต์ทั้งหมด:

convert_aider() {
  local agent_file="$1"
  local output="CONVENTIONS.md"

  # เพิ่มด้วยตัวคั่น
  echo "" >> "$output"
  echo "---" >> "$output"
  echo "" >> "$output"
  cat "$agent_file" >> "$output"

  echo "  Aider: เพิ่มลงใน $output"
}

สร้างไฟล์ทั้งหมด:

build_aider() {
  local output="CONVENTIONS.md"
  echo "# เอเจนต์ของ Agency สำหรับ Aider" > "$output"
  echo "" >> "$output"
  echo "ไฟล์นี้มีเอเจนต์ของ Agency ทั้งหมดสำหรับการรวม Aider" >> "$output"
  echo "" >> "$output"

  for agent_file in engineering/*.md design/*.md testing/*.md; do
    convert_aider "$agent_file"
  done
}

ขั้นตอนที่ 5: แปลงเป็นรูปแบบ Windsurf

Windsurf ใช้ไฟล์ .windsurfrules ไฟล์เดียว (คล้ายกับ Aider):

convert_windsurf() {
  local agent_file="$1"
  local output=".windsurfrules"

  echo "" >> "$output"
  echo "---" >> "$output"
  echo "" >> "$output"
  cat "$agent_file" >> "$output"

  echo "  Windsurf: เพิ่มลงใน $output"
}

ขั้นตอนที่ 6: แปลงเป็นรูปแบบ Antigravity

Antigravity (Gemini) ใช้ไฟล์ SKILL.md ในไดเรกทอรีย่อย:

convert_antigravity() {
  local agent_file="$1"
  local name=$(get_field 'name' "$agent_file")
  local slug=$(to_kebab "$name")
  local output="integrations/antigravity/skills/agency-${slug}/SKILL.md"

  mkdir -p "$(dirname "$output")"

  cat > "$output" << EOF
# เอเจนต์ของ Agency: $name

$(get_body "$agent_file")
EOF

  echo "  Antigravity: agency-${slug}/SKILL.md"
}

ขั้นตอนที่ 7: แปลงเป็นรูปแบบ OpenClaw

OpenClaw ใช้สามไฟล์ต่อเอเจนต์ (SOUL.md, AGENTS.md, IDENTITY.md):

convert_openclaw() {
  local agent_file="$1"
  local name=$(get_field 'name' "$agent_file")
  local description=$(get_field 'description' "$agent_file")
  local slug=$(to_kebab "$name")
  local body=$(get_body "$agent_file")

  local output_dir="integrations/openclaw/agency-${slug}"
  mkdir -p "$output_dir"

  # SOUL.md - คำจำกัดความหลักของเอเจนต์
  cat > "$output_dir/SOUL.md" << EOF
# $name

$description

---

$body
EOF

  # AGENTS.md - ความสามารถของเอเจนต์
  cat > "$output_dir/AGENTS.md" << EOF
# ความสามารถของเอเจนต์: $name

- ความเชี่ยวชาญเฉพาะด้าน
- ผลลัพธ์ที่เน้นการส่งมอบ
- มีการกำหนดตัวชี้วัดความสำเร็จ

ดู SOUL.md สำหรับคำจำกัดความฉบับเต็ม
EOF

  # IDENTITY.md - ข้อมูลระบุตัวตนของเอเจนต์
  cat > "$output_dir/IDENTITY.md" << EOF
# ข้อมูลระบุตัวตน: $name

- ชื่อ: $name
- คำอธิบาย: $description
- แหล่งที่มา: The Agency (agency-agents repo)
EOF

  echo "  OpenClaw: agency-${slug}/"
}

ขั้นตอนที่ 8: สคริปต์ convert.sh ฉบับเต็ม

นี่คือสคริปต์การแปลงที่สมบูรณ์ (แบบง่าย):

#!/usr/bin/env bash
#
# convert.sh — แปลงเอเจนต์ของ Agency ทั้งหมดเป็นรูปแบบเฉพาะของเครื่องมือ
#

set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
OUT_DIR="$REPO_ROOT/integrations"

get_field() {
  local field="$1" file="$2"
  awk -v f="$field" '
    /^---$/ { fm++; next }
    fm == 1 && $0 ~ "^" f ": " { sub("^" f ": ", ""); print; exit }
  ' "$file"
}

get_body() {
  awk 'BEGIN{fm=0} /^---$/{fm++; next} fm>=2{print}' "$1"
}

to_kebab() {
  echo "$1" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g'
}

convert_claude_code() {
  local agent_file="$1"
  local dest="$OUT_DIR/claude-code/"
  mkdir -p "$dest"
  cp "$agent_file" "$dest/"
}

convert_cursor() {
  local agent_file="$1"
  local name=$(get_field 'name' "$agent_file")
  local slug=$(to_kebab "$name")
  local body=$(get_body "$agent_file")

  mkdir -p "$OUT_DIR/cursor/.cursor/rules/"
  cat > "$OUT_DIR/cursor/.cursor/rules/agency-${slug}.mdc" << EOF
---
description: เอเจนต์ของ Agency: $(get_field 'description' "$agent_file")
---
$body
EOF
}

convert_aider() {
  local output="$OUT_DIR/aider/CONVENTIONS.md"
  echo "" >> "$output"
  echo "---" >> "$output"
  cat "$agent_file" >> "$output"
}

convert_windsurf() {
  local output="$OUT_DIR/windsurf/.windsurfrules"
  echo "" >> "$output"
  echo "---" >> "$output"
  cat "$agent_file" >> "$output"
}

echo "กำลังแปลงเอเจนต์ของ Agency..."

AGENT_DIRS=(engineering design testing marketing sales)

for dir in "${AGENT_DIRS[@]}"; do
  for agent_file in "$REPO_ROOT/$dir"/*.md; do
    [[ -f "$agent_file" ]] || continue

    name=$(get_field 'name' "$agent_file")
    echo "กำลังประมวลผล: $name"

    convert_claude_code "$agent_file"
    convert_cursor "$agent_file"
  done
done

echo "# เอเจนต์ของ Agency สำหรับ Aider" > "$OUT_DIR/aider/CONVENTIONS.md"
for dir in "${AGENT_DIRS[@]}"; do
  for agent_file in "$REPO_ROOT/$dir"/*.md; do
    [[ -f "$agent_file" ]] || continue
    convert_aider "$agent_file"
  done
done

echo "# เอเจนต์ของ Agency สำหรับ Windsurf" > "$OUT_DIR/windsurf/.windsurfrules"
for dir in "${AGENT_DIRS[@]}"; do
  for agent_file in "$REPO_ROOT/$dir"/*.md; do
    [[ -f "$agent_file" ]] || continue
    convert_windsurf "$agent_file"
  done
done

echo "การแปลงเสร็จสมบูรณ์!"
echo "  Claude Code: $OUT_DIR/claude-code/"
echo "  Cursor: $OUT_DIR/cursor/.cursor/rules/"
echo "  Aider: $OUT_DIR/aider/CONVENTIONS.md"
echo "  Windsurf: $OUT_DIR/windsurf/.windsurfrules"

รันมัน:

chmod +x convert.sh
./convert.sh

ขั้นตอนที่ 9: ติดตั้งไปยังแต่ละเครื่องมือ

หลังการแปลง ให้คัดลอกไฟล์ไปยังพาธเฉพาะของเครื่องมือ:

#!/usr/bin/env bash
#
# install.sh — ติดตั้งเอเจนต์ที่แปลงแล้วไปยังเครื่องมือในเครื่องของคุณ
#

set -euo pipefail

# Claude Code
install_claude_code() {
  local src="$REPO_ROOT/integrations/claude-code/"
  local dest="$HOME/.claude/agents/"
  mkdir -p "$dest"
  cp "$src"/*.md "$dest/"
  echo "Claude Code: ติดตั้งเอเจนต์แล้ว $(find "$dest" -name '*.md' | wc -l) ตัว"
}

# Cursor
install_cursor() {
  local src="$REPO_ROOT/integrations/cursor/.cursor/rules/"
  local dest="./.cursor/rules/"
  mkdir -p "$dest"
  cp "$src"/*.mdc "$dest/"
  echo "Cursor: ติดตั้งกฎแล้ว $(find "$dest" -name '*.mdc' | wc -l) ข้อ"
}

# Aider
install_aider() {
  local src="$REPO_ROOT/integrations/aider/CONVENTIONS.md"
  local dest="./CONVENTIONS.md"
  cp "$src" "$dest"
  echo "Aider: ติดตั้ง CONVENTIONS.md แล้ว"
}

# Windsurf
install_windsurf() {
  local src="$REPO_ROOT/integrations/windsurf/.windsurfrules"
  local dest="./.windsurfrules"
  cp "$src" "$dest"
  echo "Windsurf: ติดตั้ง .windsurfrules แล้ว"
}

# ติดตั้งเครื่องมือที่ตรวจพบทั้งหมด
install_all() {
  if [[ -d "$HOME/.claude/agents/" ]]; then
    install_claude_code
  fi
  if command -v cursor &>/dev/null || [[ -d "./.cursor/" ]]; then
    install_cursor
  fi
  if command -v aider &>/dev/null; then
    install_aider
  fi
}

install_all

การเปรียบเทียบรูปแบบ

เครื่องมือ	รูปแบบ	ขอบเขต	การแปลง
Claude Code	`.md`	ทั่วทั้งผู้ใช้ (`~/.claude/agents/`)	คัดลอกตามเดิม
Cursor	`.mdc`	โปรเจกต์ (`.cursor/rules/`)	เพิ่ม description frontmatter
Aider	`CONVENTIONS.md`	root ของโปรเจกต์	รวมเอเจนต์ทั้งหมดเข้าด้วยกัน
Windsurf	`.windsurfrules`	root ของโปรเจกต์	รวมเอเจนต์ทั้งหมดเข้าด้วยกัน
GitHub Copilot	`.md`	ทั่วทั้งผู้ใช้ (`~/.github/agents/`)	คัดลอกตามเดิม
Antigravity	`SKILL.md`	ทั่วทั้งผู้ใช้ (`~/.gemini/antigravity/`)	ห่อในไดเรกทอรีสกิล
OpenClaw	`SOUL.md` + อื่นๆ	ทั่วทั้งผู้ใช้ (`~/.openclaw/`)	แบ่งเป็น 3 ไฟล์
Gemini CLI	ส่วนเสริม	ทั่วทั้งผู้ใช้ (`~/.gemini/extensions/`)	สร้าง manifest + skills
OpenCode	`.md`	โปรเจกต์ (`.opencode/agents/`)	คัดลอกตามเดิม
Qwen Code	`.md`	โปรเจกต์ (`.qwen/agents/`)	คัดลอกเป็น SubAgent

สร้างสคริปต์การแปลงของคุณเอง

เทมเพลตสำหรับการเพิ่มเครื่องมือใหม่:

#!/usr/bin/env bash

# 1. กำหนดฟังก์ชันการแปลง
convert_your_tool() {
  local agent_file="$1"
  local name=$(get_field 'name' "$agent_file")
  local description=$(get_field 'description' "$agent_file")
  local slug=$(to_kebab "$name")
  local body=$(get_body "$agent_file")

  # 2. สร้างพาธเอาต์พุต
  local output="path/to/your/tool/agency-${slug}.ext"
  mkdir -p "$(dirname "$output")"

  # 3. เขียนเนื้อหาที่แปลงแล้ว
  cat > "$output" << EOF
# รูปแบบเฉพาะของเครื่องมือของคุณ
# ใช้: $name, $description, $body
EOF

  echo "  YourTool: agency-${slug}.ext"
}

# 4. เพิ่มลงในลูปหลัก
for agent_file in engineering/*.md; do
  convert_your_tool "$agent_file"
done

สิ่งที่คุณสร้าง

ส่วนประกอบ	วัตถุประสงค์
`get_field()`	แยกค่า YAML frontmatter
`get_body()`	ลบ frontmatter, ส่งคืนเนื้อหา markdown
`to_kebab()`	แปลงชื่อเป็น slug ที่ปลอดภัยสำหรับ URL
`convert_cursor()`	แปลงเป็นรูปแบบ `.mdc`
`convert_aider()`	รวมเข้าเป็นไฟล์เดียว
`convert_windsurf()`	รวมเข้าเป็นไฟล์เดียว
`convert_antigravity()`	สร้างไดเรกทอรีสกิล
`convert_openclaw()`	แยกเป็น 3 ไฟล์ต่อเอเจนต์
`install.sh`	คัดลอกไปยังพาธเฉพาะของเครื่องมือ

ขั้นตอนถัดไป

ขยายสคริปต์:

เพิ่มการแปลงแบบขนานด้วย xargs -P หรือ GNU parallel
เพิ่มการตรวจสอบ (ตรวจสอบฟิลด์ frontmatter ที่จำเป็น)
เพิ่มโหมด dry-run (แฟล็ก --dry-run)

เพิ่มเครื่องมือเพิ่มเติม:

ส่วนเสริม VS Code
JetBrains IDEs
เครื่องมือภายในแบบกำหนดเอง

เพิ่มประสิทธิภาพสำหรับ repos ขนาดใหญ่:

แคช frontmatter ที่แยกวิเคราะห์แล้ว
ใช้ find กับ -print0 สำหรับการจัดการไฟล์ที่ปลอดภัย
เพิ่มแถบความคืบหน้าสำหรับเอเจนต์ 100+ ตัว

การแก้ไขปัญหาทั่วไป

สคริปต์การแปลงล้มเหลวด้วย "bad substitution":

ตรวจสอบให้แน่ใจว่าคุณกำลังรัน bash ไม่ใช่ sh: #!/usr/bin/env bash
ตรวจสอบเวอร์ชัน bash: bash --version (ควรเป็น 4.0+)
รันอย่างชัดเจนด้วย bash: bash convert.sh
มองหาการขึ้นบรรทัดใหม่ของ Windows: sed -i 's/\r$//' convert.sh

ฟิลด์ Frontmatter ไม่ถูกแยก:

ตรวจสอบว่ารูปแบบ YAML ใช้ : (โคลอน เว้นวรรค) ไม่ใช่แค่ :
ตรวจสอบช่องว่างพิเศษหน้าชื่อฟิลด์
ตรวจสอบให้แน่ใจว่าตัวคั่น frontmatter เป็น --- (3 ขีด) อย่างถูกต้อง
ทดสอบการแยกวิเคราะห์ด้วยตนเอง: ./parse-frontmatter.sh --demo agent.md

การสร้าง Slug สร้างชื่อที่เสีย:

ทดสอบฟังก์ชัน to_kebab() ด้วยกรณีสุดขีด
จัดการอักขระพิเศษ: to_kebab() { echo "$1" | iconv -f utf8 -t ascii//translit | ... }
เพิ่มค่าสำรองสำหรับ slug ที่ว่างเปล่า: [[ -z "$slug" ]] && slug="unknown-agent"
บันทึกชื่อเดิมสำหรับการดีบัก

กฎของ Cursor ไม่โหลด:

ตรวจสอบว่าไฟล์ .mdc มี frontmatter ที่ถูกต้องพร้อม description
ตรวจสอบการกำหนดค่า MCP ของ Cursor: .cursor/mcp.json
ตรวจสอบให้แน่ใจว่าไฟล์อยู่ใน .cursor/rules/ ไม่ใช่ .cursor/agents/
รีสตาร์ท Cursor หลังจากเพิ่มกฎใหม่

Aider CONVENTIONS.md มีขนาดใหญ่เกินไป:

แบ่งตามหมวดหมู่: CONVENTIONS-engineering.md, CONVENTIONS-design.md
ใช้การลบอัตโนมัติสำหรับเอเจนต์ที่เลิกใช้แล้ว
เพิ่มสารบัญที่ด้านบน
พิจารณาไฟล์ต่อเอเจนต์พร้อมคำสั่ง include

การเพิ่มประสิทธิภาพสำหรับงานแปลงขนาดใหญ่

การประมวลผลแบบขนาน:

สำหรับ repositories ที่มีเอเจนต์มากกว่า 100 ตัว ให้ใช้ GNU parallel:

#!/usr/bin/env bash
# convert-parallel.sh

export OUT_DIR="$REPO_ROOT/integrations"

# ส่งออกฟังก์ชันสำหรับการใช้งานแบบขนาน
export -f get_field get_body to_kebab convert_cursor convert_claude_code

# ค้นหาไฟล์เอเจนต์ทั้งหมดและประมวลผลแบบขนาน
find "$REPO_ROOT" -name "*.md" -type f | \
  parallel -j 8 --progress '
    name=$(get_field "name" {})
    slug=$(to_kebab "$name")
    echo "กำลังแปลง: $name"
    convert_cursor "{}"
    convert_claude_code "{}"
  '

echo "การแปลงแบบขนานเสร็จสมบูรณ์!"

การแปลงแบบเพิ่มขึ้น:

แปลงเฉพาะไฟล์ที่เปลี่ยนแปลง:

#!/usr/bin/env bash
# convert-incremental.sh

CACHE_FILE="$REPO_ROOT/.conversion-cache"

# โหลดสถานะก่อนหน้า
declare -A PREV_HASHES
if [[ -f "$CACHE_FILE" ]]; then
  while IFS='=' read -r file hash; do
    PREV_HASHES["$file"]="$hash"
  done < "$CACHE_FILE"
fi

# ประมวลผลแต่ละเอเจนต์
for agent_file in engineering/*.md; do
  CURRENT_HASH=$(md5sum "$agent_file" | cut -d' ' -f1)
  PREV_HASH="${PREV_HASHES[$agent_file]:-}"

  if [[ "$CURRENT_HASH" != "$PREV_HASH" ]]; then
    echo "เปลี่ยนแปลง: $agent_file"
    convert_cursor "$agent_file"
    convert_claude_code "$agent_file"
    NEW_HASHES["$agent_file"]="$CURRENT_HASH"
  else
    echo "ไม่เปลี่ยนแปลง: $agent_file"
  fi
done

# บันทึกแคช
for file in "${!NEW_HASHES[@]}"; do
  echo "$file=${NEW_HASHES[$file]}"
done > "$CACHE_FILE"

การติดตามความคืบหน้า:

เพิ่มแถบความคืบหน้าแบบเห็นภาพสำหรับการแปลงที่ใช้เวลานาน:

#!/usr/bin/env bash

total_files=$(find "$REPO_ROOT" -name "*.md" -type f | wc -l)
current=0

for agent_file in "$REPO_ROOT"/**/*.md; do
  ((current++))
  percent=$((current * 100 / total_files))

  # แถบความคืบหน้า
  filled=$((percent / 5))
  empty=$((20 - filled))
  bar=$(printf '%*s' "$filled" | tr ' ' '#')
  spaces=$(printf '%*s' "$empty" | tr ' ' ' ')

  name=$(get_field 'name' "$agent_file")
  echo -ne "\r[${bar}${spaces}] ${percent}% - $name"

  convert_cursor "$agent_file"
done

echo -ne "\n"

ข้อพิจารณาด้านความปลอดภัยสำหรับเอเจนต์ที่แชร์

การตรวจสอบแหล่งที่มาของเอเจนต์:

เมื่อดาวน์โหลดเอเจนต์จากแหล่งภายนอก:

#!/usr/bin/env bash
# validate-agent.sh

validate_agent() {
  local file="$1"

  # ตรวจสอบฟิลด์ frontmatter ที่จำเป็น
  local name=$(get_field 'name' "$file")
  local description=$(get_field 'description' "$file")

  if [[ -z "$name" ]]; then
    echo "ข้อผิดพลาด: ไม่มีฟิลด์ 'name' ใน $file"
    return 1
  fi

  if [[ -z "$description" ]]; then
    echo "คำเตือน: ไม่มีฟิลด์ 'description' ใน $file"
  fi

  # ตรวจสอบรูปแบบที่เป็นอันตรายในเนื้อหาหลัก
  local body=$(get_body "$file")

  if echo "$body" | grep -q 'rm -rf\|curl.*\|wget.*\|eval\|exec'; then
    echo "คำเตือน: รูปแบบที่อาจเป็นอันตรายใน $file"
    return 1
  fi

  echo "ถูกต้อง: $name"
  return 0
}

การแยกการทำงานของเอเจนต์ใน Sandbox:

สำหรับเอเจนต์ที่ไม่น่าเชื่อถือ ให้รันในสภาพแวดล้อมที่แยกต่างหาก:

ใช้ Docker containers สำหรับการทำงานของเอเจนต์
จำกัดการเข้าถึงระบบไฟล์ด้วย read-only mounts
จำกัดการเข้าถึงเครือข่ายไปยังโดเมนที่เฉพาะเจาะจง
บันทึกการกระทำทั้งหมดของเอเจนต์สำหรับการตรวจสอบ

ไฟล์เอเจนต์หนึ่งไฟล์ สิบ IDEs สคริปต์ bash สองตัว

นี่คือพลังของระบบอัตโนมัติในการแปลง เขียนครั้งเดียว แปลงอัตโนมัติ ติดตั้งได้ทุกที่

ถึงตาคุณแล้ว: เพิ่มการรองรับการแปลงสำหรับเครื่องมือ AI ที่คุณชื่นชอบ แชร์สคริปต์ ทำให้เอเจนต์สามารถเคลื่อนย้ายได้

ประเด็นสำคัญ

เขียนครั้งเดียว แปลงเป็น 10+ รูปแบบ — ไฟล์ Markdown ไฟล์เดียวที่มี YAML frontmatter แปลงเป็น Claude Code, Cursor, Aider, Windsurf และเครื่องมืออื่นๆ อีก 6+ ตัว
การแยกวิเคราะห์ Bash จัดการการแยก frontmatter — get_field() แยกค่า YAML, get_body() ลบ frontmatter, to_kebab() สร้าง slug ที่ปลอดภัยสำหรับ URL
รูปแบบเฉพาะของเครื่องมือต้องการการแปลงที่แตกต่างกัน — Claude Code คัดลอกตามเดิม, Cursor เพิ่ม description frontmatter, Aider/Windsurf รวมเอเจนต์ทั้งหมดเข้าด้วยกัน
สคริปต์ติดตั้งคัดลอกไปยังพาธที่ถูกต้อง — เครื่องมือทั่วทั้งผู้ใช้ใช้ ~/.claude/agents/, เครื่องมือโปรเจกต์ใช้ .cursor/rules/ หรือไฟล์ root ของโปรเจกต์
ขยายด้วยเทมเพลตสำหรับเครื่องมือใหม่ — กำหนดฟังก์ชัน convert_your_tool(), เพิ่มลงในลูปหลัก, บันทึกข้อกำหนดรูปแบบ

คำถามที่พบบ่อย

convert.sh คืออะไรและทำงานอย่างไร?

convert.sh คือสคริปต์ bash ที่แยกวิเคราะห์ YAML frontmatter จากไฟล์ Markdown ของเอเจนต์, ดึงเนื้อหาหลัก, และแปลงเอเจนต์แต่ละตัวเป็นรูปแบบเฉพาะของเครื่องมือ มันใช้ awk สำหรับการแยกวิเคราะห์, sed สำหรับการแปลง slug, และ heredocs สำหรับการสร้างเอาต์พุต

การแยกวิเคราะห์ frontmatter ใน bash ทำงานอย่างไร?

ฟังก์ชัน get_field() ใช้ awk เพื่อติดตามตัวคั่น frontmatter (---), ค้นหาบรรทัดที่ตรงกับชื่อฟิลด์, และดึงค่าออกมา get_body() จะพิมพ์บรรทัดทั้งหมดหลังจากตัวคั่น --- ตัวที่สอง

รองรับ IDEs และเครื่องมือใดบ้าง?

Claude Code (.md), Cursor (.mdc), Aider (CONVENTIONS.md), Windsurf (.windsurfrules), GitHub Copilot (.md), Antigravity (SKILL.md), OpenClaw (SOUL.md + 2 ไฟล์), ส่วนเสริม Gemini CLI, OpenCode, และ Qwen Code

ฉันจะเพิ่มการรองรับการแปลงสำหรับเครื่องมือใหม่ได้อย่างไร?

สร้างฟังก์ชัน convert_yourtool() ที่ดึงฟิลด์ frontmatter, แปลงเนื้อหาหลักเป็นรูปแบบของเครื่องมือของคุณ, และเขียนไปยังพาธที่ถูกต้อง เพิ่มการเรียกใช้ฟังก์ชันนั้นในลูปการแปลงหลัก

ฉันสามารถเรียกใช้การแปลงแบบขนานเพื่อให้ประมวลผลเร็วขึ้นได้หรือไม่?

ได้ ใช้ xargs -P หรือ GNU parallel เพื่อประมวลผลไฟล์เอเจนต์หลายไฟล์พร้อมกัน สำหรับเอเจนต์มากกว่า 100 ตัว การแปลงแบบขนานสามารถลดเวลาทำงานจากนาทีเป็นวินาที

ฉันจะตรวจสอบได้อย่างไรว่ามีฟิลด์ frontmatter อยู่?

เพิ่มการตรวจสอบในฟังก์ชันการแปลงของคุณ: [[ -z "$name" ]] && echo "Missing name field" && exit 1 เรียกใช้การตรวจสอบก่อนเขียนไฟล์เอาต์พุต

จะเกิดอะไรขึ้นหากการแปลงล้มเหลวสำหรับเอเจนต์บางตัว?

ใช้ set -euo pipefail เพื่อให้หยุดทำงานทันทีเมื่อเกิดข้อผิดพลาด เพิ่มการจัดการข้อผิดพลาดด้วย || continue เพื่อข้ามไฟล์ที่เสียหาย บันทึกข้อผิดพลาดไปยังไฟล์แยกต่างหากสำหรับการดีบัก

DEV Community