Gumon Lore คืออะไร?

คลังความรู้กลางของทีม Gumon — เก็บ บทเรียน / pattern / วิธีแก้ปัญหา ที่ทีมเจอจากทุกโปรเจกต์ไว้ที่เดียว จุดเด่นคือมันทำงานกับ Claude Code อัตโนมัติ:

• 🔎 ตอนทำงาน — ทุกครั้งที่สั่งงาน Claude ระบบจะค้นบทเรียนที่เกี่ยวข้องมาแสดงให้ Claude อัตโนมัติ (เช่น กำลังจะทำ social login → บทเรียนและข้อควรระวังจากโปรเจกต์อื่นแสดงขึ้นทันที)
• 📝 ตอนเจอของใหม่ — บทเรียนที่คุณเจอจะถูกเก็บกลับเข้าคลังให้เพื่อนทีมโดยอัตโนมัติ (มีระบบกลั่น + กันข้อมูลลูกค้ารั่ว)
• 🌐 หน้าเว็บนี้ — ใช้ค้นบทเรียนด้วยตัวเองได้ (ค้นด้วยความหมาย ไทย/อังกฤษได้)

เริ่มใช้ครั้งแรก (ครั้งเดียวจบ)

npm install -g @anthropic-ai/claude-code   # ถ้ายังไม่มี claude CLI
claude   # แล้วพิมพ์ /login ให้เรียบร้อย (ครั้งเดียว)
git clone git@github.com:gumon-tech/gumon-lore-hub.git ~/dev/gumon-lore-hub
bash ~/dev/gumon-lore-hub/bin/lore-setup --token <วาง TOKEN ของคุณตรงนี้> --contributorcopy

bash ~/dev/gumon-lore-hub/bin/lore-doctorcopy

🔎 ค้นบทเรียนเองบนหน้าเว็บนี้

นอกจากที่ระบบส่งให้ Claude อัตโนมัติ คุณเปิดค้นเองได้ที่แท็บ 🔎 ค้นหา — มีประโยชน์มากตอน ยังไม่เริ่มเขียนโค้ด เช่นกำลังประเมินงาน คุยกับลูกค้า หรืออยากรู้ว่าทีมเคยเจอปัญหานี้มาก่อนไหม

• ค้นด้วยความหมาย ไม่ใช่คีย์เวิร์ด — พิมพ์เป็นประโยคได้เลย ไทยหรืออังกฤษก็ได้ ผลลัพธ์ไม่จำเป็นต้องมีคำที่คุณพิมพ์
  ดีกว่า: "กันเลขเอกสารซ้ำตอนมีคนกดพร้อมกัน" · แย่กว่า: "running number"
• กด Enter หรือปุ่มค้นหา — ได้สูงสุด 8 รายการ เรียงตามความใกล้เคียง
• แต่ละใบบอก ชนิด (pattern / gotcha / decision), tag (stack:* / area:*) และคะแนน sim — ต่ำกว่า ~0.83 มักไม่ตรงจริง อ่านผ่าน ๆ พอ
• คลิกที่หัวข้อ เพื่อกางเนื้อเต็มของบทเรียนนั้น
• ไม่เจอ = ทีมยังไม่เคยบันทึกเรื่องนี้ ⇒ พอคุณแก้ได้แล้วมันจะถูก capture เข้าคลังให้คนถัดไปเอง

แท็บ 📊 สถิติ ดูภาพรวมคลัง (มีกี่บทเรียน มาจากโปรเจกต์ไหน ใครใช้บ่อย)

โปรเจกต์ไหนเปิด Lore บ้าง?

เปิดเฉพาะ repo ที่อยู่ในลิสต์ของทีม — ลิสต์นี้อยู่ในคลัง (ไฟล์ .lore/pilot-repos.conf) ตัดสินครั้งเดียวใช้ร่วมกันทุกเครื่อง ไม่ต้องมาตั้งทีละคน

• งานส่วนตัว / งานนอกบริษัท = ไม่ถูกจับ ไม่ถูกส่งขึ้นคลัง โดยไม่ต้องตั้งค่าอะไรเลย
• เปิดโปรเจกต์ใหม่ให้ทั้งทีม — รันในโฟลเดอร์โปรเจกต์นั้น ครั้งเดียว ใครทำก็ได้:

  bash ~/dev/gumon-lore-hub/bin/lore-addcopy

  เพื่อนร่วมทีมไม่ต้องทำอะไร — ได้รับเองตอนเปิด session ถัดไป
• ไม่อยากให้จับ repo บางตัวเฉพาะเครื่องคุณ — ตั้ง LORE_PILOT_EXCLUDE=<ชื่อ repo> ใน ~/.claude/settings.json
• ระบบยึด ชื่อ repo (ไม่ใช่ path) ⇒ วางโปรเจกต์ไว้ที่ไหน ไดรฟ์อะไร ก็ทำงานเหมือนกันทุกเครื่อง

อะไรออกจากเครื่องคุณบ้าง (อ่านก่อนติดตั้ง)

• ห้องที่ไม่อยู่ในลิสต์ = ไม่มีอะไรออกจากเครื่องเลย ทั้ง prompt และบทสนทนา
• path บนเครื่องคุณถูกลบออกอัตโนมัติก่อนบันทึก (โฟลเดอร์โปรเจกต์ → <repo>, home → ~, ชื่อ user → <user>)
• Token ของคุณเก็บอยู่ในเครื่องคุณเท่านั้น (~/.claude/settings.json) — หนึ่ง token ต่อหนึ่งเครื่อง เพิกถอนเองได้ทุกเมื่อ

ระดับการใช้งาน (roles ตอนติดตั้ง)

คำถามพบบ่อย

Token หายหรือเปลี่ยนเครื่อง ต้องทำอย่างไร?

Login เข้า portal → Tokens ของฉัน → revoke ตัวเก่า → สร้างใหม่ → รัน lore-setup --token ใหม่

บทเรียนไม่แสดง ควรตรวจสอบอะไรบ้าง?

รัน bash ~/dev/gumon-lore-hub/bin/lore-doctor ในโฟลเดอร์ที่มีปัญหา — มันตอบให้ครบว่า เครื่องมือขาดอะไร · token ยังใช้ได้ไหม · ห้องนี้อยู่ในลิสต์โปรเจกต์ของทีมหรือเปล่า · เปิด session ใหม่หลังติดตั้งหรือยัง
สาเหตุที่พบบ่อยที่สุดคือ repo นั้นยังไม่อยู่ในลิสต์ทีม ⇒ ถ้าเป็นงานบริษัทให้รัน lore-add ในโฟลเดอร์นั้น

ใช้ Windows ได้ไหม?

ได้ — แต่ต้องรันคำสั่งทั้งหมดใน Git Bash (ไม่ใช่ PowerShell หรือ cmd) เพราะสคริปต์ทั้งชุดเป็น bash ทุกความสามารถใช้ได้เท่ากับ mac/Linux รวมถึงการเป็นเครื่องกลั่น

คลังอยู่คนละที่กับเพื่อนร่วมทีมได้ไหม?

ได้ ระบบไม่สนใจว่าคุณวางคลังหรือโปรเจกต์ไว้ที่ไหน — ใส่ --hub /path/ที่ต้องการ ตอน lore-setup ได้เลย

ข้อมูลลูกค้าจะรั่วเข้าคลังไหม?

มีด่านกรอง 2 ชั้น (AI ตรวจ 2 รอบ) — ของที่มีข้อมูลลูกค้าจะถูกกัก (quarantine) ไม่เข้าคลังจนกว่าคนจะรีวิว และคลังนี้เห็นได้เฉพาะพนักงาน Gumon เท่านั้น

สำหรับ admin: อนุมัติคน / เชิญคน / ปิดบัญชี

แท็บ 👥 Admin — คนสมัครใหม่จะขึ้นสถานะ pending กด "อนุมัติ" · เชิญคนใหม่ = ใส่ email แล้ว copy invite link ส่งให้ทาง chat · คนออกจากทีม = กด "ปิดใช้" (token ทั้งหมดของเขาถูกตัดทันที)