thai-native / exports
AGENTS.md0 starsChanged 22 days agoMITView on GitHub
กฎสำหรับ AI เวลาเขียนภาษาไทย ทั้งงาน การเรียน และชีวิตประจำวัน (เด่นที่งานทีมเทค) ฉบับเต็มพร้อม script ตรวจภาษาและคลังคำอยู่ที่ https://github.com/Sophon-Kr/thai-native เขียนเหมือนคนไทยที่เขียนงานแบบนั้นเป็นประจำเขียนถึงผู้อ่านตรงหน้า (งานทีมเทค: คนในทีมที่ทำงานมาหลายปี) เข้าเรื่องเลย บอกสิ่งที่ผู้อ่านต้องรู้หรือต้องทำก่อน ประโยคสั้นยาวสลับกัน ใช้คำที่คนกลุ่มนั้นพูดกันจริง แล้วจบที่ขั้นต่อไป คงอังกฤษสำหรับศัพท์ที่ทีม dev ไทยพูดเป็นอังกฤษอยู่แล้ว ใช้คำไทยเมื่อมีคำที่ใช้กันทุกวัน งานทางการใส่ ไทย (อังกฤษ) ครั้งแรก ตารางด้านล่างคือค่าเริ่มต้น
In this repository6 other files it gives its agents.
- thai-configSkill
- thai-learnSkill
- thai-polishSkill
- thai-termSkill
- thai-translateSkill
- thai-writingSkill
The file
Files
<!-- generated by tools/build_exports.py from tools/export_src/ and the glossary; do not edit -->การเขียนภาษาไทย (thai-native)
กฎสำหรับ AI เวลาเขียนภาษาไทย ทั้งงาน การเรียน และชีวิตประจำวัน (เด่นที่งานทีมเทค) ฉบับเต็มพร้อม script ตรวจภาษาและคลังคำอยู่ที่ https://github.com/Sophon-Kr/thai-native
เสียง
เขียนเหมือนคนไทยที่เขียนงานแบบนั้นเป็นประจำเขียนถึงผู้อ่านตรงหน้า (งานทีมเทค: คนในทีมที่ทำงานมาหลายปี) เข้าเรื่องเลย บอกสิ่งที่ผู้อ่านต้องรู้หรือต้องทำก่อน ประโยคสั้นยาวสลับกัน ใช้คำที่คนกลุ่มนั้นพูดกันจริง แล้วจบที่ขั้นต่อไป
ขั้นตอน
- ดูก่อนว่าใครอ่าน ผ่านช่องทางไหน งานประเภทอะไร และอยากให้ผู้อ่านทำอะไร แล้วเลือกระดับภาษา: Jira/PR/แชตในทีม = ภาษาทีม, อีเมล/สไลด์/เอกสาร/บทความ = กึ่งทางการ, หนังสือทางการและงานวิชาการ = ทางการ, โพสต์แบรนด์ = เสียงแบรนด์, ถึงครอบครัวหรือเพื่อน = แบบพูด ผู้อ่านอาวุโสหรือคนนอกให้ขยับสุภาพขึ้นหนึ่งขั้น
- คิดเป็นประเด็น (ใครทำอะไร ทำไม ต่อไปทำอะไร) แล้วร่างเป็นไทยจากประเด็นโดยตรง ไม่ร่างอังกฤษแล้วแปล
- คำลงท้ายตามผู้เขียน (ครับ หรือ ค่ะ/คะ) ไม่เดาเพศจากชื่อ ไม่ปนกัน แชตใส่ท้ายข้อความ ข้อความยาวหรือถึงผู้ใหญ่เพิ่มที่คำขอได้ ไม่ใส่ทุกประโยค สไลด์ เอกสาร ticket และข้อความในแอปไม่ใส่ ใช้ นะคะ ไม่ใช่ นะค่ะ
- ไม่เติมข้อมูลที่ผู้ใช้ไม่ได้ให้ ถ้าจำเป็นใส่ [ ] ไว้ให้เติม
กฎหลัก
- ให้ผู้ทำขึ้นก่อน ใช้ ถูก/โดน กับเรื่องไม่ดีเท่านั้น (แอปถูก reject) เรื่องกลาง ๆ เขียนแบบกรรตุ: ทีม backend แก้ API แล้ว
- ใช้กริยาตรง ๆ ตัด ทำการ / มีการ / ดำเนินการ / ได้รับการ / การ…ของ… ที่ตัดได้ (deploy ขึ้น staging แล้ว)
- ละประธานที่ภาษาไทยไม่ต้องใช้ ไม่แปล you เป็น คุณ อัตโนมัติ เรียกคนตามความสัมพันธ์ (พี่ต้น, น้องมายด์, ทุกคน) หรือไม่ต้องเรียก
- ใส่คำเชื่อมเฉพาะจุดที่ตรรกะเปลี่ยน ในงานทีมใช้ แต่ / เลย / ก็ / พอ…ก็ ไม่ขึ้นทุกย่อหน้าด้วย อย่างไรก็ตาม / นอกจากนี้ / ดังนั้น และไม่ต่อ ซึ่ง หลายชั้น
- ใช้คำที่คนไทยพูดจริง: เช็กให้ชัวร์ว่า… (ไม่ใช่ ตรวจสอบให้แน่ใจว่า), ติดอะไรทักมาได้เลย (ไม่ใช่ อย่าลังเลที่จะติดต่อ), ขอบคุณที่ช่วยดู (ไม่ใช่ ขอบคุณสำหรับความช่วยเหลือของคุณ)
- คุมระดับภาษาให้คงที่ ขอโทษให้พอดีกับเรื่อง เรื่องเล็กขอโทษสั้น ๆ แล้วบอกว่าแก้อะไร
- เปิดด้วยเรื่องหลัก ปิดด้วยสิ่งที่ต้องทำต่อ ไม่เปิดด้วย ในยุคปัจจุบัน… ไม่ปิดด้วย หวังว่าจะเป็นประโยชน์
- บอกผลจริงแทน buzzword (ยกระดับ, ขับเคลื่อน, ตอบโจทย์, อย่างมีประสิทธิภาพ, ไร้รอยต่อ)
- format ตามงาน: แชตไม่มี header และป้ายตัวหนา, สไลด์หัวข้อสั้นมีตัวเลข ไม่มีคำลงท้าย, ไม่ใช้ขีดยาว (—) และไม่ใส่จุดท้ายประโยคไทย
- เลขอารบิก เว้นวรรคหน้าและหลังคำอังกฤษและตัวเลขกลางข้อความไทย วันที่แบบ 23 ต.ค. 2569 เวลาแบบ 14.00 น. ทับศัพท์สะกดตามราชบัณฑิตฯ (อีเมล, ลิงก์, แอป, อัปเดต)
ศัพท์เทคนิค
คงอังกฤษสำหรับศัพท์ที่ทีม dev ไทยพูดเป็นอังกฤษอยู่แล้ว ใช้คำไทยเมื่อมีคำที่ใช้กันทุกวัน งานทางการใส่ ไทย (อังกฤษ) ครั้งแรก ตารางด้านล่างคือค่าเริ่มต้น
งานนอกทีมเทค
- รายงาน ข้อเสนอ เอกสาร HR การเงิน: ข้อสรุปหรือคำขอก่อน ตัวเลขมีตัวเทียบ (เป้า เดือนก่อน) เงินหน่วยเดียวทั้งฉบับ บอกว่ารวม VAT หรือยัง ทวงเงินไม่ขู่ หนังสือเตือนเขียนข้อเท็จจริงที่ตรวจได้ ไม่ตัดสินนิสัย
- งานวิชาการ: ภาษาเขียน ไม่มีคำลงท้าย ใช้ ผู้วิจัย แทน ผม อ้างอิงผู้แต่งไทยด้วยชื่อ + นามสกุล (สมศรี ทองคำ, 2565) ศัพท์ไทย (อังกฤษ) ครั้งแรก ไม่แต่งแหล่งอ้างอิง
- โพสต์และโฆษณา: บรรทัดแรกบอกของ ราคา หรือวันที่ อีโมจิ 0–3 ต่อโพสต์ แฮชแท็กน้อย ไม่ใช้ ห้ามพลาด! มาดูกันเลย! ไม่อ้างเกินที่พิสูจน์ได้
- บทความและข่าวประชาสัมพันธ์: พาดหัวมีผู้ทำ กริยา ตัวเลข ย่อหน้าแรกตอบ ใคร ทำอะไร ที่ไหน เมื่อไร อ้างคำพูดแบบ ชื่อ ตำแหน่ง กล่าวว่า “…”
- ถึงครอบครัว ผู้ใหญ่ เพื่อน: เรียกตามความสัมพันธ์ (แม่ ป้า อาจารย์) เขียนแบบพูด ไม่ใช้ เรียน… ที่เคารพ กับพ่อแม่ แสดงความเสียใจสั้น ไม่ถามสาเหตุ ไม่มีอีโมจิ กับพระใช้ นิมนต์ ถวาย ฉัน
- สมัครงาน เรซูเม่ ลาออก: bullet ขึ้นด้วยกริยาและมีตัวเลข ไม่มี ผม/ดิฉัน ใน bullet ไม่แต่งผลงาน ปฏิเสธหรือลาออกไม่ตำหนิใคร
ก่อนส่ง
- ประโยคแรกบอกเรื่องหลักแล้วหรือยัง
- มี คุณ / มัน / เรา ที่ตัดได้ไหม
- มี ถูก…โดย / ได้รับการ / ทำการ / มีการ ที่เขียนเป็นกริยาตรง ๆ ได้ไหม
- คำเชื่อมหัวประโยคและ ซึ่ง เหลือเฉพาะที่จำเป็นไหม
- คำลงท้าย ระดับภาษา และ format ตรงกับงานไหม
- ตอนจบเป็นสิ่งที่ต้องทำต่อ ไม่ใช่สรุปซ้ำหรือคำอวยพร
| คำ | งานทีม | งานทางการ |
| pull request | pull request | เหมือนกัน |
| commit | commit | เหมือนกัน |
| merge | merge | เหมือนกัน |
| branch | branch | เหมือนกัน |
| conflict | conflict | เหมือนกัน |
| review | review | ตรวจสอบ (review) |
| approve | approve | อนุมัติ |
| comment | comment | ความคิดเห็น (comment) |
| deploy | deploy | นำขึ้นระบบจริง (deploy) |
| release | release | ออกเวอร์ชันใหม่ |
| rollback | rollback | ย้อนกลับเวอร์ชัน (rollback) |
| staging | staging | เหมือนกัน |
| production | production | ระบบจริง (production) |
| incident | incident | เหตุขัดข้อง (incident) |
| server | เซิร์ฟเวอร์ | เหมือนกัน |
| database | ฐานข้อมูล | เหมือนกัน |
| bug | บั๊ก | เหมือนกัน |
| test | test | ทดสอบ |
| QA | QA | เหมือนกัน |
| reproduce | reproduce | ทำให้เกิดซ้ำ |
| crash | crash | หยุดทำงาน (crash) |
| edge case | edge case | กรณีพิเศษ (edge case) |
| sprint | sprint | เหมือนกัน |
| backlog | backlog | เหมือนกัน |
| ticket | ticket | เหมือนกัน |
| issue | issue | เหมือนกัน |
| story | story | เหมือนกัน |
| epic | epic | เหมือนกัน |
| standup | standup | เหมือนกัน |
| retrospective | retrospective | เหมือนกัน |
| refinement | refinement | เหมือนกัน |
| blocker | blocker | เหมือนกัน |
| feedback | feedback | ความคิดเห็น |
| meeting | ประชุม | เหมือนกัน |
| deadline | เดดไลน์ | กำหนดส่ง |
| sync | sync | ประชุมติดตามงาน |
| follow up | follow up | ติดตาม |
| align | align | ทำความเข้าใจให้ตรงกัน |
| escalate | escalate | ยกระดับปัญหา (escalate) |
| action item | action item | สิ่งที่ต้องทำต่อ (action item) |
| อีเมล | เหมือนกัน | |
| link | ลิงก์ | เหมือนกัน |
| app | แอป | เหมือนกัน |
| update | อัปเดต | เหมือนกัน |
| login | login | เข้าสู่ระบบ |
| check | เช็ก | ตรวจ |
| version | เวอร์ชัน | เหมือนกัน |
| function | ฟังก์ชัน | เหมือนกัน |
| project | โปรเจกต์ | โครงการ |
| feature | ฟีเจอร์ | เหมือนกัน |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.