spk-doctor

name	spk-doctor
description	ตรวจสุขภาพ installation และ runtime ของ SPK บน host ที่รองรับแบบ read-only พร้อมระบุ failure และ repair command ที่ชัดเจน
argument-hint	[ไม่บังคับ: host, project path หรือ component]
user-invocable	true

SPK Doctor

วินิจฉัยชุด SPK ที่ติดตั้งโดยไม่เปลี่ยน project หรือ installation state

Workflow

1. หารากชุดติดตั้งจาก trusted host metadata หรือตัวแปรรากที่ host ให้ ปฏิเสธ root นอกตำแหน่งติดตั้งและห้ามเลือกไฟล์ชื่อเดียวกันใน project
2. หา scripts/spk-doctor.cjs ใต้ root แล้วรันด้วย Node โดยใช้ target project เป็น cwd ขอ structured output ถ้ารองรับ
3. ตรวจ diagnostics สำหรับ manifest discovery, skill/agent counts, hooks, MCP, runtime prerequisites, scaffold, permissions, host compatibility และ version drift
4. verify ซ้ำเฉพาะ check ที่ fail/ambiguous แบบ read-only ห้าม install, regenerate, rewrite config, auth หรือ restart
5. จัดระดับ ERROR, WARN, OK ให้ exact repair command ทุก failure แต่ห้าม execute

Evidence Receipt

คืน:

{
  "schema": "spk.doctor/v1",
  "status": "OK | DEGRADED | BROKEN",
  "host": "<detected host>",
  "install_root": "<resolved path>",
  "checks": [{"name": "<check>", "status": "OK | WARN | ERROR", "evidence": "<fact>"}],
  "repair_commands": ["<exact command + argv>"]
}

ข้อควรระวัง

• Doctor เป็น read-only ห้าม repair, install, auth หรือลบ
• ห้ามเปิดเผย env values, credential, token หรือ raw private sources
• Optional capability ที่หายเป็น WARN ไม่ใช่ ERROR
• ถ้า runtime script หายให้รายงาน installation corruption และ safe reinstall command แทนการ download หรือสร้างไฟล์เอง