Private Docs

specialists — เรียกผู้เชี่ยวชาญตัวเดียว จบในคำถามเดียว

17 skill ที่ห่อ agent ของ dev-team ไว้ให้เรียกตรงได้โดยไม่ต้องเปิด run เต็ม — ตารางเลือกใช้, input ที่บังคับต้องมี, และเงื่อนไขที่ต้องเลิกใช้แล้วไปเปิด dev-team แทน

อัปเดต: 2026-08-06

specialists เป็น plugin ที่ไม่มี agent เป็นของตัวเอง — มันคือ 17 ทางลัดที่เรียก agent ของ dev-team ตัวเดิม ด้วย contract เดิมเป๊ะ ต่างกันแค่ “ใครเป็นคนเรียก” และ skill ต้องเตรียม input ที่ปกติมาจาก decision.yaml ให้แทน

ใช้เมื่อ: อยากได้คำตอบจากผู้เชี่ยวชาญ 1 เรื่อง จบในครั้งเดียว โดยไม่ต้องมี intake / gate / run directory


1. เลือกตัวไหน

กลุ่มตรวจ diff (หลังเขียนโค้ดแล้ว)

Skillตรวจอะไรต้องให้อะไร
/reviewerreview ทั่วไป — correctness + AC coverage (ใช้เมื่อไม่มีตัวเฉพาะ stack)repo path ที่มี diff จริง + review brief (objective + AC)
/dotnet-reviewerreview diff .NET backendrepo path ที่มี diff backend + review brief
/fe-reviewerreview diff frontendrepo path ที่มี diff frontend + review brief
/perf-auditorปัญหา performance — BE: EF N+1, unbounded query, sync-over-async · FE: bundle, re-render, lazy loadrepo path ที่มี diff (ไม่มี diff → บอกตรงๆ ว่าไม่มีอะไรให้ตรวจ)
/integration-checkercontract ที่เปลี่ยนข้ามขอบเขตระบบrepo path + บอกว่าเทียบสองฝั่งไหน เช่น “controller ↔ frontend client”
/style-enforcerformatting/naming ตาม convention ที่มีจริงrepo path + ชื่อ convention/คำสั่ง (.editorconfig / eslint / dotnet format) — ไม่ระบุ = ตอบ not_applicable

กลุ่มที่ปรึกษา (ก่อนลงมือ)

Skillตอบอะไรต้องให้อะไร
/counselคำถามตัดสินใจ 1 ข้อ → proceed / adjust / stop / need-evidenceคำถามตัดสินใจ + pointer อย่างน้อย 1 (run dir / branch / diff range / file path)
/solution-skepticท้าทายแผนก่อน implement — assumption, scope drift, falsificationrepo path + แผน: outcome ที่ต้องการ, approach ที่เลือก, assumption หลัก, risk ที่ประเมินเอง
/contract-designerร่าง scope contract — AC, forbidden changes, file whitelist, approach ที่เล็กที่สุดrepo path + outcome/ปัญหาที่ต้องการแก้ + constraint ที่รู้
/db-advisorตรวจการเปลี่ยน schema/data shape — compatibility, rollout, lock, recoveryrepo path + รายละเอียดการเปลี่ยน: table/column/index/constraint, ปริมาณข้อมูลคร่าวๆ, migration tool
/security-advisorตรวจ trust boundary จุดเดียวที่ระบุrepo path + scope ที่เจาะจง เช่น “endpoint login ใหม่” — ขอ audit ทั้ง repo = ปฏิเสธ
/test-charter-writertest charter ที่ map กับ AC — ทำก่อนเริ่ม implementrepo path + AC (มี draft จาก contract-designer ส่งต่อได้เลย)

กลุ่มสำรวจ + เขียนเอกสาร

Skillได้อะไรต้องให้อะไรเขียนไฟล์?
/repo-scoutตอบคำถาม repo 1 ข้อ — stack, คำสั่ง test, ขัดแย้งระหว่าง instruction กับโค้ดจริงrepo path + คำถาม/scope❌ อ่านได้ ≤ 5 ไฟล์ ห้ามขยายเอง
/api-doc-writerendpoint spec แบบ OpenAPI จาก controller จริงrepo path + controller/feature + path ปลายทางที่จะเขียน✅ 1 ไฟล์
/arch-doc-writerเอกสารสถาปัตยกรรม + mermaid + ADR ของสิ่งที่ตัดสินใจไปแล้วrepo path + module/decision + path ปลายทาง✅ 1 ไฟล์
/post-mortem-writerRCA ของ bug ที่แก้และ validate แล้วสรุป bug: อาการ, root cause จริง, fix ที่ file:line, หลักฐาน validate, ทำไมหลุดมาได้ + path ปลายทาง✅ 1 ไฟล์
/release-scribecommit message + PR description จาก diff จริง (conventional commits)repo path ที่มี diff (ระบุ staged / unstaged / commit range ได้)❌ ไม่ commit ไม่ push

2. กติกาที่ทั้ง 17 ตัวใช้ร่วมกัน

  1. เรียก agent ครั้งเดียวจบ — ไม่มี retry, ไม่มี follow-up call อัตโนมัติ
  2. Read-only ยกเว้น 3 ตัวที่เขียนเอกสาร (api-doc-writer, arch-doc-writer, post-mortem-writer) ซึ่งเขียนได้ 1 ไฟล์ที่ path ที่อนุมัติแล้วเท่านั้น · git ที่อนุญาตมีแค่ status / diff / log / show / rev-parse
  3. ห้าม delegate ต่อ และห้ามเรียก dev-team / qa-team / requirement-team / advisor-team เอง
  4. input ไม่ครบ = หยุดถาม Owner ไม่เดาแทน — โดยเฉพาะ AC และ path ปลายทาง
  5. ผลลัพธ์คืนเป็น YAML contract เดิมของ agent แล้วต่อท้ายด้วยป้าย “specialist finding — not a dev-team delivery verdict” เสมอ
  6. ไม่มีการบันทึกที่ไหน — ไม่มี run directory ไม่มี archive อยากได้ร่องรอย ต้องใช้ dev-team หรือ advisor-team

3. Model ที่วิ่งจริง

ตัวDispatch
16 ตัว (ทุกตัวยกเว้น counsel)ตาม session model ที่ Owner เปิดอยู่ · ระบุไม่ได้ (alias / สลับกลางคัน / headless) → ถอยไปใช้ frontmatter — ขึ้นได้อย่างเดียว ไม่เดาลง
/counselmax(opus, session model) ไม่ต่ำกว่า opus เด็ดขาด effort ตาม frontmatter (max)

ทุกตัวต้องระบุ model ที่ dispatch จริงในบรรทัดผลลัพธ์ — Owner จะได้เห็นว่ามันวิ่งบนอะไร


4. เมื่อไหร่ต้องเลิกใช้ specialist แล้วไปเปิด dev-team

หยุดทันทีเมื่อเจอเงื่อนไขเหล่านี้ — skill จะแนะนำให้เปลี่ยนเองด้วย

  • ต้องแก้ production code / เขียนไฟล์ / รันคำสั่งอะไรก็ตาม
  • ขึ้นกับ Task Contract, decision.yaml, หรือ run state ที่ยังไม่มี
  • scope เกิน “1 คำถาม 1 repo” (หลาย repo พร้อมกัน หรือต้องเอาไปเทียบกับ specialist ตัวอื่น)
  • ไม่มี AC/review brief ที่ชัดพอจะตัดสิน acceptance coverage
  • verdict ออกมา fail/blocked แล้ว Owner อยากให้แก้เลย → การแก้ต้องผ่าน dev-team
  • ต้องการ deep mode 3 เลนส์ หรือต้องเก็บผลลง archive ที่ค้นได้ → ใช้ /advisor-team
  • repo มี reviewer เฉพาะ stack ที่ตรงกว่า (.NET → /dotnet-reviewer, Angular → /fe-reviewer)