cc-viewer 1.6.182 → 1.6.183

package/concepts/th/Tool-PushNotification.md

@@ -0,0 +1,48 @@
+# PushNotification
+
+ส่งการแจ้งเตือนบนเดสก์ท็อปจากเซสชัน Claude Code ที่กำลังใช้งานอยู่ หาก Remote Control เชื่อมต่ออยู่ การแจ้งเตือนจะถูกส่งไปยังโทรศัพท์ของผู้ใช้ด้วย เพื่อดึงความสนใจของพวกเขากลับมายังเซสชันไม่ว่าจะทำอะไรอยู่ก็ตาม
+
+## เมื่อใดควรใช้
+
+- งานที่ใช้เวลานานเสร็จสิ้นแล้วในขณะที่ผู้ใช้อาจไม่ได้อยู่ที่เทอร์มินัล
+- การบิลด์ การรันเทสต์ หรือการดีพลอยเสร็จสมบูรณ์และผลลัพธ์พร้อมสำหรับการตรวจสอบ
+- ถึงจุดตัดสินใจที่ต้องการข้อมูลจากผู้ใช้ก่อนที่จะดำเนินการต่อ
+- เกิดข้อผิดพลาดหรือสิ่งที่ขัดขวางที่ไม่สามารถแก้ไขได้โดยอัตโนมัติ
+- ผู้ใช้ขอให้แจ้งเตือนอย่างชัดเจนเมื่องานหรือเงื่อนไขที่ระบุสำเร็จ
+
+## เมื่อใดไม่ควรใช้
+
+อย่าส่งการแจ้งเตือนสำหรับการอัปเดตความคืบหน้าตามปกติระหว่างงาน หรือเพื่อยืนยันว่าคุณตอบคำถามที่ผู้ใช้เพิ่งถามและกำลังรออยู่ อย่าแจ้งเตือนเมื่องานสั้นๆ เสร็จสิ้น หากผู้ใช้เพิ่งส่งมาและกำลังรอ การแจ้งเตือนไม่มีคุณค่าและทำลายความไว้วางใจสำหรับการแจ้งเตือนในอนาคต ควรเอนเอียงอย่างหนักไปทางไม่ส่ง
+
+## พารามิเตอร์
+
+- `message` (สตริง, จำเป็น): เนื้อหาการแจ้งเตือน เก็บไว้ต่ำกว่า 200 ตัวอักษร ระบบปฏิบัติการมือถือจะตัดสตริงที่ยาวกว่านั้น เริ่มต้นด้วยสิ่งที่ผู้ใช้จะดำเนินการ: "build failed: 2 auth tests" มีประโยชน์กว่า "task complete"
+- `status` (สตริง, จำเป็น): ตั้งเป็น `"proactive"` เสมอ นี่คือตัวระบุที่ตายตัวและไม่เปลี่ยนแปลง
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: แจ้งเตือนเมื่อการวิเคราะห์ที่ใช้เวลานานเสร็จสิ้น
+
+มีการร้องขอการตรวจสอบ dependency ทั้งรีโพสิทอรีซึ่งใช้เวลาหลายนาที ผู้ใช้ออกไปจากที่ทำงาน เมื่อรายงานพร้อมแล้ว:
+
+```
+message: "ตรวจสอบ dependency เสร็จ: พบ CVE ความเสี่ยงสูง 3 รายการใน lodash, axios, jsonwebtoken รายงาน: audit-report.txt"
+status: "proactive"
+```
+
+### ตัวอย่างที่ 2: ระบุจุดตัดสินใจระหว่างการทำงานอัตโนมัติ
+
+ระหว่างการ refactor หลายขั้นตอน พบว่าสองโมดูลมี interface ที่ขัดแย้งกันและไม่สามารถรวมกันได้โดยไม่มีการตัดสินใจด้านการออกแบบ:
+
+```
+message: "หยุด refactor แล้ว: AuthService และ UserService มี token interface ที่ขัดแย้งกัน ต้องการการตัดสินใจก่อนดำเนินการต่อ"
+status: "proactive"
+```
+
+## หมายเหตุ
+
+- เอนเอียงอย่างหนักไปทาง **ไม่** ส่ง การแจ้งเตือนขัดจังหวะผู้ใช้ไม่ว่าพวกเขากำลังทำอะไร ถือว่ามันเป็นต้นทุนที่ต้องได้รับการพิสูจน์ด้วยคุณค่าของข้อมูล
+- เริ่มต้นด้วยเนื้อหาที่ดำเนินการได้ คำแรกๆ ควรบอกผู้ใช้ว่าเกิดอะไรขึ้นและสิ่งที่ต้องทำหากมี ไม่ใช่ป้ายกำกับสถานะทั่วไป
+- เก็บ `message` ไว้ต่ำกว่า 200 ตัวอักษร ระบบปฏิบัติการมือถือจะตัดสตริงที่ยาวกว่า ซึ่งอาจตัดส่วนที่สำคัญที่สุดออกหากอยู่ท้าย
+- หากผลลัพธ์ระบุว่าไม่ได้ส่ง push เพราะ Remote Control ไม่ได้เชื่อมต่อ นั่นเป็นพฤติกรรมที่คาดหวัง ไม่จำเป็นต้องลองใหม่หรือดำเนินการเพิ่มเติม การแจ้งเตือนบนเดสก์ท็อปในเครื่องยังคงทำงานอยู่
+- หลีกเลี่ยงการส่งการแจ้งเตือนมากเกินไป หากส่งการแจ้งเตือนบ่อยๆ สำหรับเหตุการณ์เล็กน้อย ผู้ใช้จะเริ่มเพิกเฉยต่อมัน สงวนเครื่องมือนี้ไว้สำหรับช่วงเวลาที่มีโอกาสสูงที่ผู้ใช้ออกไปและต้องการทราบผลลัพธ์ตอนนี้

package/concepts/th/Tool-Read.md

@@ -1,56 +1,41 @@
 # Read
 
-## คำจำกัดความ
+โหลดเนื้อหาของไฟล์เดียวจาก filesystem ในเครื่อง รองรับข้อความธรรมดา, source code, รูปภาพ, PDF, และ Jupyter notebook ส่งผลลัพธ์พร้อมหมายเลขบรรทัดเริ่มจาก 1 ในสไตล์ `cat -n`
 
-อ่านเนื้อหาไฟล์จากระบบไฟล์ในเครื่อง รองรับไฟล์ข้อความ รูปภาพ PDF และ Jupyter notebook
+## เมื่อใดควรใช้
+
+- อ่านไฟล์ source ที่ path ที่ทราบก่อนแก้ไขหรือวิเคราะห์
+- ตรวจสอบไฟล์ configuration, lockfile, log, หรือ artifact ที่ generate
+- ดู screenshot หรือไดอะแกรมที่ผู้ใช้วางใน conversation
+- ดึงช่วงหน้าเฉพาะจาก PDF manual ที่ยาว
+- เปิด notebook `.ipynb` เพื่อ review code cell, markdown, และ output ของ cell พร้อมกัน
 
 ## พารามิเตอร์
 
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `file_path` | string | ใช่ | พาธแบบสัมบูรณ์ของไฟล์ |
-| `offset` | number | ไม่ | หมายเลขบรรทัดเริ่มต้น (สำหรับอ่านไฟล์ขนาดใหญ่แบบแบ่งส่วน) |
-| `limit` | number | ไม่ | จำนวนบรรทัดที่จะอ่าน (สำหรับอ่านไฟล์ขนาดใหญ่แบบแบ่งส่วน) |
-| `pages` | string | ไม่ | ช่วงหน้า PDF (เช่น "1-5", "3", "10-20") ใช้ได้เฉพาะกับ PDF |
-
-## สถานการณ์การใช้งาน
-
-**เหมาะสำหรับ:**
-- อ่านไฟล์โค้ด ไฟล์การตั้งค่า และไฟล์ข้อความอื่นๆ
-- ดูไฟล์รูปภาพ (Claude เป็นโมเดลมัลติโมดัล)
-- อ่านเอกสาร PDF
-- อ่าน Jupyter notebook (ส่งคืนเซลล์ทั้งหมดพร้อมผลลัพธ์)
-- อ่านหลายไฟล์พร้อมกันเพื่อรับบริบท
-
-**ไม่เหมาะสำหรับ:**
-- อ่านไดเรกทอรี — ควรใช้คำสั่ง `ls` ของ Bash
-- การสำรวจโค้ดเบสแบบเปิด — ควรใช้ Task (ประเภท Explore)
-
-## ข้อควรระวัง
-
-- พาธต้องเป็นแบบสัมบูรณ์ ไม่ใช่แบบสัมพัทธ์
-- ค่าเริ่มต้นอ่าน 2000 บรรทัดแรกของไฟล์
-- บรรทัดที่เกิน 2000 ตัวอักษรจะถูกตัดทอน
-- ผลลัพธ์ใช้รูปแบบ `cat -n` หมายเลขบรรทัดเริ่มจาก 1
-- PDF ขนาดใหญ่ (เกิน 10 หน้า) ต้องระบุพารามิเตอร์ `pages` สูงสุด 20 หน้าต่อครั้ง
-- การอ่านไฟล์ที่ไม่มีอยู่จะส่งคืนข้อผิดพลาด (ไม่ทำให้ล่ม)
-- สามารถเรียก Read หลายครั้งพร้อมกันในข้อความเดียว
-
-## ข้อความต้นฉบับ
-
-<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
-Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
-
-Usage:
-- The file_path parameter must be an absolute path, not a relative path
-- By default, it reads up to 2000 lines starting from the beginning of the file
-- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
-- Any lines longer than 2000 characters will be truncated
-- Results are returned using cat -n format, with line numbers starting at 1
-- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
-- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
-- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
-- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
-- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
-- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
-- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>
+- `file_path` (string, required): Absolute path ไปยังไฟล์เป้าหมาย Path แบบ relative จะถูกปฏิเสธ
+- `offset` (integer, optional): หมายเลขบรรทัดเริ่มจาก 1 ที่จะเริ่มอ่าน มีประโยชน์สำหรับไฟล์ขนาดใหญ่เมื่อใช้ร่วมกับ `limit`
+- `limit` (integer, optional): จำนวนบรรทัดสูงสุดที่จะส่งกลับเริ่มจาก `offset` ค่าเริ่มต้น 2000 บรรทัดจากด้านบนของไฟล์เมื่อละเว้น
+- `pages` (string, optional): ช่วงหน้าสำหรับไฟล์ PDF เช่น `"1-5"`, `"3"`, หรือ `"10-20"` จำเป็นสำหรับ PDF ที่ยาวกว่า 10 หน้า; สูงสุด 20 หน้าต่อการร้องขอ
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: อ่านไฟล์ขนาดเล็กทั้งหมด
+เรียก `Read` โดยตั้งเฉพาะ `file_path` เป็น `/Users/me/project/src/index.ts` จะส่งกลับถึง 2000 บรรทัดพร้อมหมายเลขบรรทัด ซึ่งมักเพียงพอสำหรับ context การแก้ไข
+
+### ตัวอย่างที่ 2: ดู log ยาวทีละหน้า
+ใช้ `offset: 5001` และ `limit: 500` บนไฟล์ log หลายพันบรรทัดเพื่อดึงหน้าต่างแคบโดยไม่สิ้นเปลือง token context
+
+### ตัวอย่างที่ 3: ดึงหน้า PDF เฉพาะ
+สำหรับ PDF 120 หน้าที่ `/tmp/spec.pdf` ให้ตั้ง `pages: "8-15"` เพื่อดึงเฉพาะบทที่ต้องการ การละเว้น `pages` ใน PDF ขนาดใหญ่จะทำให้เกิด error
+
+### ตัวอย่างที่ 4: ดูรูปภาพ
+ส่ง absolute path ของ PNG หรือ JPG screenshot รูปภาพจะถูก render แบบมองเห็นได้เพื่อให้ Claude Code สามารถ reason เกี่ยวกับมันโดยตรง
+
+## หมายเหตุ
+
+- ชอบ absolute path เสมอ หากผู้ใช้ให้มา ให้เชื่อใช้ตามนั้น
+- บรรทัดที่ยาวกว่า 2000 อักขระจะถูกตัด ให้ถือเนื้อหาที่ส่งกลับว่าอาจถูกตัดสำหรับข้อมูลที่กว้างมาก
+- อ่านหลายไฟล์ที่อิสระกัน? ออก `Read` หลายตัวในการตอบเดียวกันเพื่อให้รันขนานกัน
+- `Read` ไม่สามารถ list directory ใช้ `Bash` `ls` หรือ tool `Glob` แทน
+- อ่านไฟล์ที่มีอยู่แต่ว่างเปล่า จะส่ง system reminder แทน file byte ดังนั้นจัดการสัญญาณนี้อย่างชัดเจน
+- `Read` ที่สำเร็จจำเป็นก่อนใช้ `Edit` บนไฟล์เดียวกันใน session ปัจจุบัน

package/concepts/th/Tool-RemoteTrigger.md

@@ -0,0 +1,73 @@
+# RemoteTrigger
+
+เรียกใช้ API ทริกเกอร์ระยะไกลของ claude.ai เพื่อจัดการงานที่กำหนดเวลาไว้และการเรียกใช้ทริกเกอร์ตามต้องการ โทเค็น OAuth ได้รับการจัดการภายในโดยเครื่องมือและไม่เคยถูกเปิดเผยต่อโมเดลหรือเชลล์
+
+## เมื่อใดควรใช้
+
+- จัดการเอเจนต์ระยะไกล (ทริกเกอร์) บน claude.ai รวมถึงการแสดงรายการ ตรวจสอบ และอัปเดตทริกเกอร์ที่มีอยู่
+- สร้างงานอัตโนมัติแบบ cron ใหม่ที่รัน Claude agent ตามกำหนดการที่เกิดซ้ำ
+- เรียกใช้ทริกเกอร์ที่มีอยู่ตามต้องการโดยไม่ต้องรอการรันตามกำหนดการครั้งถัดไป
+- แสดงรายการหรือตรวจสอบทริกเกอร์ปัจจุบันทั้งหมดเพื่อดูการกำหนดค่าและสถานะ
+- อัปเดตการตั้งค่าทริกเกอร์ เช่น กำหนดการ เพย์โหลด หรือคำอธิบาย โดยไม่ต้องสร้างทริกเกอร์ใหม่
+
+## พารามิเตอร์
+
+- `action` (string, จำเป็น): การดำเนินการที่จะดำเนินการ — ค่าหนึ่งใน `list`, `get`, `create`, `update` หรือ `run`
+- `trigger_id` (string, จำเป็นสำหรับ `get`, `update` และ `run`): ตัวระบุของทริกเกอร์ที่จะดำเนินการ ต้องตรงกับรูปแบบ `^[\w-]+$` (เฉพาะอักขระคำและเครื่องหมายยัติภังค์เท่านั้น)
+- `body` (object, จำเป็นสำหรับ `create` และ `update`; ไม่บังคับสำหรับ `run`): เพย์โหลดของคำขอที่ส่งไปยัง API
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: แสดงรายการทริกเกอร์ทั้งหมด
+
+```json
+{
+  "action": "list"
+}
+```
+
+เรียก `GET /v1/code/triggers` และส่งคืนอาร์เรย์ JSON ของทริกเกอร์ทั้งหมดที่เชื่อมโยงกับบัญชีที่ผ่านการรับรองความถูกต้อง
+
+### ตัวอย่างที่ 2: สร้างทริกเกอร์ใหม่ที่รันทุกเช้าวันทำงาน
+
+```json
+{
+  "action": "create",
+  "body": {
+    "name": "weekday-morning-report",
+    "schedule": "0 8 * * 1-5",
+    "description": "สร้างสรุปรายวันทุกวันทำงานเวลา 08:00 UTC"
+  }
+}
+```
+
+เรียก `POST /v1/code/triggers` พร้อมเนื้อหาที่ให้มาและส่งคืนออบเจ็กต์ทริกเกอร์ที่สร้างใหม่ รวมถึง `trigger_id` ที่กำหนดไว้
+
+### ตัวอย่างที่ 3: เรียกใช้ทริกเกอร์ตามต้องการ
+
+```json
+{
+  "action": "run",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+เรียก `POST /v1/code/triggers/my-report-trigger/run` ทันที โดยข้ามเวลาที่กำหนดไว้
+
+### ตัวอย่างที่ 4: ดึงข้อมูลทริกเกอร์เดียว
+
+```json
+{
+  "action": "get",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+เรียก `GET /v1/code/triggers/my-report-trigger` และส่งคืนการกำหนดค่าทริกเกอร์แบบสมบูรณ์
+
+## หมายเหตุ
+
+- โทเค็น OAuth ถูกฉีดเข้าในกระบวนการโดยเครื่องมือ — อย่าคัดลอก วาง หรือบันทึกโทเค็นด้วยตนเองเด็ดขาด การทำเช่นนั้นก่อให้เกิดความเสี่ยงด้านความปลอดภัยและไม่จำเป็นเมื่อใช้เครื่องมือนี้
+- ควรใช้เครื่องมือนี้แทน `curl` แบบดิบหรือ HTTP client อื่น ๆ สำหรับการเรียก API ทริกเกอร์ทั้งหมด การใช้ HTTP โดยตรงจะข้ามการฉีดโทเค็นที่ปลอดภัยและอาจเปิดเผยข้อมูลประจำตัว
+- เครื่องมือส่งคืนการตอบสนอง JSON แบบดิบจาก API ผู้เรียกมีหน้าที่รับผิดชอบในการแยกวิเคราะห์การตอบสนองและจัดการรหัสสถานะข้อผิดพลาด
+- ค่า `trigger_id` ต้องตรงกับรูปแบบ `^[\w-]+$` — อนุญาตเฉพาะอักขระตัวอักษรและตัวเลข เครื่องหมายขีดล่าง และเครื่องหมายยัติภังค์เท่านั้น ช่องว่างหรืออักขระพิเศษจะทำให้คำขอล้มเหลว

package/concepts/th/Tool-ScheduleWakeup.md

@@ -0,0 +1,56 @@
+# ScheduleWakeup
+
+กำหนดเวลาว่าจะกลับมาทำงานอีกครั้งเมื่อใดในโหมดไดนามิก `/loop` เครื่องมือนี้ช่วยให้ Claude จัดการจังหวะการวนซ้ำของงานได้เอง โดยหยุดพักตามช่วงเวลาที่เลือก จากนั้นทริกเกอร์อีกครั้งด้วยพรอมต์ลูปเดิม
+
+## เมื่อใดควรใช้
+
+- เมื่อต้องการควบคุมจังหวะของงานไดนามิก `/loop` ด้วยตนเอง โดยช่วงเวลาการวนซ้ำขึ้นอยู่กับสถานะงานไม่ใช่นาฬิกาคงที่
+- เมื่อรอการสร้าง การปรับใช้ หรือการรันการทดสอบที่ใช้เวลานานให้เสร็จสิ้นก่อนตรวจสอบผลลัพธ์
+- เมื่อต้องการแทรกการรอแบบว่างเปล่าระหว่างการวนซ้ำ ในกรณีที่ไม่มีสัญญาณเฉพาะให้ตรวจสอบในขณะนี้
+- เมื่อรันลูปอัตโนมัติโดยไม่มีพรอมต์จากผู้ใช้ — ส่ง sentinel ตามตัวอักษร `<<autonomous-loop-dynamic>>` เป็น `prompt`
+- เมื่อต้องการโพลล์กระบวนการที่สถานะกำลังจะเปลี่ยนแปลงในเร็วๆ นี้ (ใช้ค่าหน่วงเวลาสั้นเพื่อรักษาแคชให้ยังอุ่นอยู่)
+
+## พารามิเตอร์
+
+- `delaySeconds` (ตัวเลข, จำเป็น): จำนวนวินาทีจนกว่าจะกลับมาทำงาน ระบบรันไทม์จะจำกัดค่าอัตโนมัติไว้ที่ `[60, 3600]` จึงไม่จำเป็นต้องจำกัดเองด้วยตนเอง
+- `reason` (สตริง, จำเป็น): ประโยคสั้นๆ หนึ่งประโยคที่อธิบายเหตุผลของค่าหน่วงเวลาที่เลือก แสดงให้ผู้ใช้เห็นและบันทึกในข้อมูลการวัดประสิทธิภาพ ควรเจาะจง — "กำลังตรวจสอบการสร้าง bun ที่ใช้เวลานาน" มีประโยชน์กว่า "กำลังรอ"
+- `prompt` (สตริง, จำเป็น): อินพุต `/loop` ที่จะทริกเกอร์เมื่อตื่นนอน ส่งสตริงเดิมในทุกรอบเพื่อให้การทริกเกอร์ครั้งต่อไปทำซ้ำงาน สำหรับลูปอัตโนมัติที่ไม่มีพรอมต์จากผู้ใช้ ให้ส่ง sentinel ตามตัวอักษร `<<autonomous-loop-dynamic>>`
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: ค่าหน่วงเวลาสั้นเพื่อตรวจสอบสัญญาณที่เปลี่ยนแปลงเร็วอีกครั้ง (รักษาแคชให้ยังอุ่นอยู่)
+
+เพิ่งเริ่มการสร้างและโดยปกติจะเสร็จสิ้นภายในสองถึงสามนาที
+
+```json
+{
+  "delaySeconds": 120,
+  "reason": "กำลังตรวจสอบการสร้าง bun ที่คาดว่าจะเสร็จใน ~2 นาที",
+  "prompt": "ตรวจสอบสถานะการสร้างและรายงานข้อผิดพลาด"
+}
+```
+
+120 วินาทีช่วยรักษาบริบทการสนทนาไว้ในแคชพรอมต์ของ Anthropic (TTL 5 นาที) ทำให้การตื่นนอนครั้งต่อไปเร็วขึ้นและประหยัดกว่า
+
+### ตัวอย่างที่ 2: การรอแบบว่างเปล่านานๆ (ยอมรับการพลาดแคช และกระจายต้นทุนไปยังการรอที่ยาวกว่า)
+
+การย้ายฐานข้อมูลกำลังดำเนินการและโดยปกติใช้เวลา 20–40 นาที
+
+```json
+{
+  "delaySeconds": 1200,
+  "reason": "การย้ายข้อมูลมักใช้เวลา 20–40 นาที; กลับมาตรวจสอบใน 20 นาที",
+  "prompt": "ตรวจสอบสถานะการย้ายข้อมูลและดำเนินการต่อหากเสร็จแล้ว"
+}
+```
+
+แคชจะเย็นเมื่อตื่นนอน แต่การรอ 20 นาทีนั้นชดเชยต้นทุนการพลาดแคชครั้งเดียวได้อย่างเพียงพอ การโพลล์ทุก 5 นาทีจะจ่ายต้นทุนการพลาดเดิม 4 ครั้งโดยไม่ได้ประโยชน์ใดๆ
+
+## หมายเหตุ
+
+- **TTL แคช 5 นาที**: แคชพรอมต์ของ Anthropic จะหมดอายุหลังจาก 300 วินาที ค่าหน่วงเวลาต่ำกว่า 300 วินาทีช่วยรักษาบริบทให้อุ่นอยู่ ค่าหน่วงเวลาเกิน 300 วินาทีจะทำให้เกิดการพลาดแคชเมื่อตื่นนอนครั้งต่อไป
+- **หลีกเลี่ยงค่าที่ 300 วินาทีพอดี**: นี่คือสถานการณ์ที่แย่ที่สุดจากทั้งสองโลก — คุณจ่ายต้นทุนการพลาดแคชโดยไม่ได้รับเวลารอที่ยาวกว่าอย่างมีนัยสำคัญ ลดลงเป็น 270 วินาที (รักษาแคชให้อุ่น) หรือยึดมั่นที่ 1200 วินาทีขึ้นไป (การพลาดครั้งเดียวซื้อเวลารอที่ยาวกว่ามาก)
+- **ค่าเริ่มต้นสำหรับการรอแบบว่างเปล่า**: เมื่อไม่มีสัญญาณเฉพาะให้ตรวจสอบ ให้ใช้ **1200–1800 วินาที** (20–30 นาที) ทำให้ลูปตรวจสอบเป็นระยะโดยไม่เผาแคชโดยเปล่าประโยชน์ 12 ครั้งต่อชั่วโมง
+- **การจำกัดอัตโนมัติ**: ระบบรันไทม์จำกัด `delaySeconds` ไว้ที่ `[60, 3600]` ค่าที่ต่ำกว่า 60 จะกลายเป็น 60 ค่าที่สูงกว่า 3600 จะกลายเป็น 3600 ไม่จำเป็นต้องจัดการขอบเขตเหล่านี้เอง
+- **ละเว้นการเรียกใช้เพื่อสิ้นสุดลูป**: หากต้องการหยุดการวนซ้ำ อย่าเรียกใช้ ScheduleWakeup เพียงแค่ละเว้นการเรียกใช้ก็สิ้นสุดลูป
+- **ส่ง `prompt` เดิมในทุกรอบ**: ฟิลด์ `prompt` ต้องมีคำสั่ง `/loop` เดิมในทุกการเรียกใช้ เพื่อให้การตื่นนอนครั้งต่อไปรู้ว่างานใดที่ต้องกลับมาทำต่อ

package/concepts/th/Tool-SendMessage.md

@@ -1,41 +1,68 @@
 # SendMessage
 
-## คำจำกัดความ
+ส่งข้อความจากสมาชิกทีมหนึ่งไปยังอีกคนหนึ่งภายในทีมที่ active หรือ broadcast ไปยัง teammate ทุกคนในคราวเดียว นี่เป็นช่องทางเดียวที่ teammate สามารถได้ยิน — สิ่งใดๆ ที่เขียนลงใน text output ปกติจะไม่มองเห็นสำหรับพวกเขา
 
-ส่งข้อความระหว่าง agent ภายในทีม ใช้สำหรับการสื่อสารโดยตรง การกระจายข้อความ และข้อความโปรโตคอล (คำขอ/การตอบกลับการปิดระบบ, การอนุมัติแผน)
+## เมื่อใดควรใช้
+
+- มอบหมายงานหรือส่งต่อ subproblem ให้ teammate ที่มีชื่อระหว่างการทำงานร่วมกันเป็นทีม
+- ขอสถานะ ผลลัพธ์ระหว่างทาง หรือ code review จาก agent อื่น
+- Broadcast การตัดสินใจ ข้อจำกัดร่วมกัน หรือประกาศการปิดระบบไปยังทั้งทีมผ่าน `*`
+- ตอบกลับ protocol prompt เช่นคำขอ shutdown หรือคำขอ plan approval จาก team leader
+- ปิดลูปที่จุดสิ้นสุดของงานที่มอบหมาย เพื่อให้ leader สามารถ mark รายการว่าเสร็จแล้ว
 
 ## พารามิเตอร์
 
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|-------------|--------|--------|----------|
-| `to` | string | ใช่ | ผู้รับ: ชื่อสมาชิกทีม หรือ `"*"` สำหรับกระจายถึงทุกคน |
-| `message` | string / object | ใช่ | ข้อความข้อความล้วนหรือออบเจกต์โปรโตคอลแบบมีโครงสร้าง |
-| `summary` | string | ไม่ | ตัวอย่างข้อความ 5-10 คำที่แสดงในหน้าจอ |
+- `to` (string, required): `name` ของ teammate เป้าหมายตามที่ลงทะเบียนในทีม หรือ `*` เพื่อ broadcast ไปยัง teammate ทุกคนในคราวเดียว
+- `message` (string หรือ object, required): ข้อความธรรมดาสำหรับการสื่อสารปกติ หรือ object ที่มีโครงสร้างสำหรับการตอบ protocol เช่น `shutdown_response` และ `plan_approval_response`
+- `summary` (string, optional): preview 5–10 คำที่แสดงใน team activity log สำหรับข้อความ plain-text จำเป็นสำหรับข้อความ string ยาว; ถูกละเลยเมื่อ `message` เป็น protocol object
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: ส่งต่องานโดยตรง
+
+```
+SendMessage(
+  to="db-lead",
+  message="Please audit prisma/schema.prisma and list any model missing createdAt/updatedAt timestamps. Reply when done.",
+  summary="Audit schema for missing timestamps"
+)
+```
 
-## ประเภทข้อความ
+### ตัวอย่างที่ 2: Broadcast ข้อจำกัดร่วมกัน
 
-### ข้อความล้วน
-ข้อความโดยตรงระหว่างสมาชิกทีมสำหรับการประสานงาน อัปเดตสถานะ และหารือเกี่ยวกับงาน
+```
+SendMessage(
+  to="*",
+  message="Reminder: do not touch files under legacy/ — that subtree is frozen until the migration PR lands.",
+  summary="Freeze legacy/ during migration"
+)
+```
 
-### คำขอปิดระบบ
-ขอให้สมาชิกปิดระบบอย่างเรียบร้อย: `{ type: "shutdown_request", reason: "..." }`
+### ตัวอย่างที่ 3: การตอบ protocol
 
-### การตอบกลับการปิดระบบ
-สมาชิกอนุมัติหรือปฏิเสธการปิดระบบ: `{ type: "shutdown_response", approve: true/false }`
+ตอบกลับคำขอ shutdown จาก leader โดยใช้ข้อความที่มีโครงสร้าง:
 
-### การตอบกลับการอนุมัติแผน
-อนุมัติหรือปฏิเสธแผนของสมาชิก: `{ type: "plan_approval_response", approve: true/false }`
+```
+SendMessage(
+  to="leader",
+  message={ "type": "shutdown_response", "ready": true, "final_report": "All assigned diff chunks committed on branch refactor-crew/db-lead." }
+)
+```
 
-## กระจายข้อความ vs ส่งตรง
+### ตัวอย่างที่ 4: การตอบ plan approval
 
-- **ส่งตรง** (`to: "ชื่อ-สมาชิก"`): ส่งถึงสมาชิกเฉพาะราย — แนะนำสำหรับการสื่อสารส่วนใหญ่
-- **กระจาย** (`to: "*"`): ส่งถึงสมาชิกทุกคน — ใช้อย่างประหยัด เฉพาะประกาศสำคัญระดับทีมเท่านั้น
+```
+SendMessage(
+  to="leader",
+  message={ "type": "plan_approval_response", "approved": true, "notes": "LGTM, but please split step 4 into migration + backfill." }
+)
+```
 
-## เครื่องมือที่เกี่ยวข้อง
+## หมายเหตุ
 
-| เครื่องมือ | วัตถุประสงค์ |
-|-----------|-------------|
-| `TeamCreate` | สร้างทีมใหม่ |
-| `TeamDelete` | ลบทีมเมื่อเสร็จสิ้น |
-| `Agent` | สร้างสมาชิกที่เข้าร่วมทีม |
-| `TaskCreate` / `TaskUpdate` / `TaskList` | จัดการรายการงานที่แชร์ร่วมกัน |
+- Assistant text output ปกติของคุณจะไม่ถูกส่งไปยัง teammate หากคุณต้องการให้ agent อื่นเห็นบางอย่าง มันต้องผ่าน `SendMessage` นี่คือความผิดพลาดที่พบบ่อยที่สุดใน team workflow
+- Broadcast (`to: "*"`) แพง — มันปลุก teammate ทุกคนและใช้ context ของพวกเขา สงวนไว้สำหรับประกาศที่ส่งผลกระทบต่อทุกคนจริงๆ ชอบการส่งแบบเฉพาะเจาะจง
+- รักษาข้อความให้กระชับและเน้นการกระทำ รวม path ของไฟล์ ข้อจำกัด และ format การตอบที่คาดหวังที่ผู้รับต้องการ; จำไว้ว่าพวกเขาไม่มีความจำร่วมกับคุณ
+- Protocol message object (`shutdown_response`, `plan_approval_response`) มีรูปร่างที่แน่นอน อย่ามี protocol field ผสมเข้าไปในข้อความ plain-text หรือกลับกัน
+- ข้อความเป็นแบบ asynchronous ผู้รับจะได้รับของคุณในรอบถัดไป; อย่าถือว่าพวกเขาได้อ่านหรือลงมือทำจนกว่าจะตอบกลับ
+- `summary` ที่เขียนดีทำให้ team activity log สแกนได้ง่ายสำหรับ leader — ถือเหมือนบรรทัด subject ของ commit

package/concepts/th/Tool-Skill.md

@@ -1,56 +1,47 @@
 # Skill
 
-## คำจำกัดความ
+Invoke skill ที่มีชื่อภายใน conversation ปัจจุบัน Skill คือชุดความสามารถที่จัดทำไว้ล่วงหน้า — ความรู้โดเมน, workflow, และบางครั้งการเข้าถึง tool — ที่ harness expose ไปยังผู้ช่วยผ่าน system reminder
 
-รันทักษะ (skill) ในการสนทนาหลัก ทักษะคือความสามารถเฉพาะทางที่ผู้ใช้สามารถเรียกใช้ผ่าน slash command (เช่น `/commit`, `/review-pr`)
+## เมื่อใดควรใช้
 
-## พารามิเตอร์
-
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `skill` | string | ใช่ | ชื่อทักษะ (เช่น "commit", "review-pr", "pdf") |
-| `args` | string | ไม่ | อาร์กิวเมนต์ของทักษะ |
+- ผู้ใช้พิมพ์ slash command เช่น `/review` หรือ `/init` — slash command คือ skill และต้องถูกรันผ่าน tool นี้
+- ผู้ใช้อธิบายงานที่ match เงื่อนไข trigger ของ skill ที่ advertise (เช่น ขอสแกน transcript หา permission prompt ที่ซ้ำกัน match `fewer-permission-prompts`)
+- เป้าหมายของ skill ตรงกับไฟล์ คำขอ หรือ context ของ conversation ในปัจจุบัน
+- Workflow เฉพาะทางที่ทำซ้ำได้มีเป็น skill และวิธีมาตรฐานดีกว่าวิธีเฉพาะหน้า
+- ผู้ใช้ถาม "มี skill อะไรบ้าง" — ระบุชื่อที่ advertise และ invoke เฉพาะเมื่อพวกเขายืนยัน
 
-## สถานการณ์การใช้งาน
+## พารามิเตอร์
 
-**เหมาะสำหรับ:**
-- ผู้ใช้ป้อน slash command ในรูปแบบ `/<skill-name>`
-- คำร้องขอของผู้ใช้ตรงกับฟังก์ชันของทักษะที่ลงทะเบียนไว้
+- `skill` (string, required): ชื่อที่แน่นอนของ skill ที่อยู่ใน system reminder available-skill ปัจจุบัน สำหรับ skill ที่เป็น plugin-namespaced ใช้ในรูปแบบเต็ม `plugin:skill` (เช่น `skill-creator:skill-creator`) อย่าใส่ slash นำหน้า
+- `args` (string, optional): argument แบบ free-form ที่ส่งไปยัง skill รูปแบบและความหมายถูกกำหนดโดย documentation ของ skill แต่ละตัว
 
-**ไม่เหมาะสำหรับ:**
-- คำสั่ง CLI ในตัว (เช่น `/help`, `/clear`)
-- ทักษะที่กำลังทำงานอยู่แล้ว
-- ชื่อทักษะที่ไม่อยู่ในรายการทักษะที่ใช้ได้
+## ตัวอย่าง
 
-## ข้อควรระวัง
+### ตัวอย่างที่ 1: รัน skill review บน branch ปัจจุบัน
 
-- หลังจากถูกเรียก ทักษะจะขยายเป็น prompt ที่สมบูรณ์
-- รองรับชื่อแบบเต็ม (เช่น `ms-office-suite:pdf`)
-- รายการทักษะที่ใช้ได้จะอยู่ในข้อความ system-reminder
-- เมื่อเห็นแท็ก `<command-name>` แสดงว่าทักษะถูกโหลดแล้ว ควรดำเนินการโดยตรงโดยไม่ต้องเรียกเครื่องมือนี้อีก
-- อย่ากล่าวถึงทักษะโดยไม่ได้เรียกเครื่องมือจริง
+```
+Skill(skill="review")
+```
 
-## ข้อความต้นฉบับ
+Skill `review` รวบรวมขั้นตอนสำหรับ review pull request กับ base branch ปัจจุบัน การ invoke จะโหลดกระบวนการ review ที่กำหนดโดย harness เข้าสู่ turn
 
-<textarea readonly>Execute a skill within the main conversation
+### ตัวอย่างที่ 2: Invoke skill ที่เป็น plugin-namespaced พร้อม argument
 
-When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+```
+Skill(
+  skill="skill-creator:skill-creator",
+  args="create a skill that summarizes git log for a given date range"
+)
+```
 
-When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
+Route คำขอผ่าน entry point ของ plugin `skill-creator` เพื่อให้ workflow การสร้าง skill เริ่มต้น
 
-How to invoke:
-- Use this tool with the skill name and optional arguments
-- Examples:
-  - `skill: "pdf"` - invoke the pdf skill
-  - `skill: "commit", args: "-m 'Fix bug'"` - invoke with arguments
-  - `skill: "review-pr", args: "123"` - invoke with arguments
-  - `skill: "ms-office-suite:pdf"` - invoke using fully qualified name
+## หมายเหตุ
 
-Important:
-- Available skills are listed in system-reminder messages in the conversation
-- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
-- NEVER mention a skill without actually calling this tool
-- Do not invoke a skill that is already running
-- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
-- If you see a <command-name> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
-</textarea>
+- Invoke เฉพาะ skill ที่มีชื่อปรากฏตามตัวอักษรใน system reminder available-skill หรือ skill ที่ผู้ใช้พิมพ์โดยตรงเป็น `/name` ในข้อความ อย่าเดาหรือคิด skill name จาก memory หรือ training data — หาก skill ไม่ได้ advertise อย่าเรียก tool นี้
+- เมื่อคำขอของผู้ใช้ match skill ที่ advertise การเรียก `Skill` เป็นข้อกำหนดที่ blocking: invoke มันก่อนสร้างการตอบอื่นๆ เกี่ยวกับงาน อย่าอธิบายสิ่งที่ skill จะทำ — รันมัน
+- อย่ากล่าวถึง skill ด้วยชื่อโดยไม่ invoke จริงๆ การประกาศ skill โดยไม่เรียก tool เป็นการหลอกลวง
+- อย่าใช้ `Skill` สำหรับ built-in CLI command เช่น `/help`, `/clear`, `/model`, หรือ `/exit` สิ่งเหล่านี้ถูกจัดการโดย harness โดยตรง
+- อย่า re-invoke skill ที่กำลังรันอยู่ใน turn ปัจจุบัน หากคุณเห็นแท็ก `<command-name>` ใน turn ปัจจุบัน skill ถูกโหลดแล้ว — ทำตามคำสั่งแทนการเรียก tool อีกครั้ง
+- หาก skill หลายตัวอาจใช้ได้ ให้เลือกตัวที่เฉพาะเจาะจงที่สุด สำหรับการเปลี่ยน configuration เช่น การเพิ่ม permission หรือ hook ชอบ `update-config` มากกว่าวิธีการตั้งค่าทั่วไป
+- การ execute skill อาจแนะนำ system reminder, tool, หรือข้อจำกัดใหม่สำหรับส่วนที่เหลือของ turn อ่าน conversation state อีกครั้งหลัง skill เสร็จก่อนดำเนินการต่อ