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