cx-viewer 1.0.0

package/concepts/th/Tool-EnterPlanMode.md

@@ -0,0 +1,128 @@
+# EnterPlanMode
+
+## คำจำกัดความ
+
+สลับ Claude Code เข้าสู่โหมดวางแผน ใช้สำหรับสำรวจโค้ดเบสและออกแบบแผนก่อนการดำเนินงาน
+
+## พารามิเตอร์
+
+ไม่มีพารามิเตอร์
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- การพัฒนาฟีเจอร์ใหม่ — ต้องการการตัดสินใจด้านสถาปัตยกรรม
+- มีหลายแนวทางที่เป็นไปได้ — ต้องการให้ผู้ใช้เลือก
+- การแก้ไขโค้ดส่งผลต่อพฤติกรรมหรือโครงสร้างที่มีอยู่
+- การเปลี่ยนแปลงหลายไฟล์ — อาจเกี่ยวข้องกับ 2-3 ไฟล์ขึ้นไป
+- ข้อกำหนดไม่ชัดเจน — ต้องสำรวจก่อนเพื่อเข้าใจขอบเขต
+- ความต้องการของผู้ใช้สำคัญ — การดำเนินงานอาจมีหลายทิศทางที่สมเหตุสมผล
+
+**ไม่เหมาะสำหรับ:**
+- การแก้ไขบรรทัดเดียวหรือไม่กี่บรรทัด (พิมพ์ผิด, บักที่ชัดเจน)
+- ผู้ใช้ให้คำสั่งที่เฉพาะเจาะจงมากแล้ว
+- งานวิจัย/สำรวจล้วนๆ — ควรใช้ Task (ประเภท Explore)
+
+## พฤติกรรมในโหมดวางแผน
+
+หลังจากเข้าสู่โหมดวางแผน Claude Code จะ:
+1. ใช้เครื่องมือ Glob, Grep, Read เพื่อสำรวจโค้ดเบสอย่างลึกซึ้ง
+2. ทำความเข้าใจรูปแบบและสถาปัตยกรรมที่มีอยู่
+3. ออกแบบแผนการดำเนินงาน
+4. ส่งแผนให้ผู้ใช้อนุมัติ
+5. ใช้ AskUserQuestion หากต้องการคำชี้แจง
+6. ออกผ่าน ExitPlanMode เมื่อแผนพร้อม
+
+## ข้อควรระวัง
+
+- เครื่องมือนี้ต้องได้รับความยินยอมจากผู้ใช้เพื่อเข้าสู่โหมดวางแผน
+- หากไม่แน่ใจว่าต้องวางแผนหรือไม่ ให้เลือกวางแผน — การจัดแนวล่วงหน้าดีกว่าการทำงานซ้ำ
+
+## ข้อความต้นฉบับ
+
+<textarea readonly>Use this tool proactively when you're about to start a non-trivial implementation task. Getting user sign-off on your approach before writing code prevents wasted effort and ensures alignment. This tool transitions you into plan mode where you can explore the codebase and design an implementation approach for user approval.
+
+## When to Use This Tool
+
+**Prefer using EnterPlanMode** for implementation tasks unless they're simple. Use it when ANY of these conditions apply:
+
+1. **New Feature Implementation**: Adding meaningful new functionality
+   - Example: "Add a logout button" - where should it go? What should happen on click?
+   - Example: "Add form validation" - what rules? What error messages?
+
+2. **Multiple Valid Approaches**: The task can be solved in several different ways
+   - Example: "Add caching to the API" - could use Redis, in-memory, file-based, etc.
+   - Example: "Improve performance" - many optimization strategies possible
+
+3. **Code Modifications**: Changes that affect existing behavior or structure
+   - Example: "Update the login flow" - what exactly should change?
+   - Example: "Refactor this component" - what's the target architecture?
+
+4. **Architectural Decisions**: The task requires choosing between patterns or technologies
+   - Example: "Add real-time updates" - WebSockets vs SSE vs polling
+   - Example: "Implement state management" - Redux vs Context vs custom solution
+
+5. **Multi-File Changes**: The task will likely touch more than 2-3 files
+   - Example: "Refactor the authentication system"
+   - Example: "Add a new API endpoint with tests"
+
+6. **Unclear Requirements**: You need to explore before understanding the full scope
+   - Example: "Make the app faster" - need to profile and identify bottlenecks
+   - Example: "Fix the bug in checkout" - need to investigate root cause
+
+7. **User Preferences Matter**: The implementation could reasonably go multiple ways
+   - If you would use AskUserQuestion to clarify the approach, use EnterPlanMode instead
+   - Plan mode lets you explore first, then present options with context
+
+## When NOT to Use This Tool
+
+Only skip EnterPlanMode for simple tasks:
+- Single-line or few-line fixes (typos, obvious bugs, small tweaks)
+- Adding a single function with clear requirements
+- Tasks where the user has given very specific, detailed instructions
+- Pure research/exploration tasks (use the Agent tool with explore agent instead)
+
+## What Happens in Plan Mode
+
+In plan mode, you'll:
+1. Thoroughly explore the codebase using Glob, Grep, and Read tools
+2. Understand existing patterns and architecture
+3. Design an implementation approach
+4. Present your plan to the user for approval
+5. Use AskUserQuestion if you need to clarify approaches
+6. Exit plan mode with ExitPlanMode when ready to implement
+
+## Examples
+
+### GOOD - Use EnterPlanMode:
+User: "Add user authentication to the app"
+- Requires architectural decisions (session vs JWT, where to store tokens, middleware structure)
+
+User: "Optimize the database queries"
+- Multiple approaches possible, need to profile first, significant impact
+
+User: "Implement dark mode"
+- Architectural decision on theme system, affects many components
+
+User: "Add a delete button to the user profile"
+- Seems simple but involves: where to place it, confirmation dialog, API call, error handling, state updates
+
+User: "Update the error handling in the API"
+- Affects multiple files, user should approve the approach
+
+### BAD - Don't use EnterPlanMode:
+User: "Fix the typo in the README"
+- Straightforward, no planning needed
+
+User: "Add a console.log to debug this function"
+- Simple, obvious implementation
+
+User: "What files handle routing?"
+- Research task, not implementation planning
+
+## Important Notes
+
+- This tool REQUIRES user approval - they must consent to entering plan mode
+- If unsure whether to use it, err on the side of planning - it's better to get alignment upfront than to redo work
+- Users appreciate being consulted before significant changes are made to their codebase
+</textarea>

package/concepts/th/Tool-EnterWorktree.md

@@ -0,0 +1,56 @@
+# EnterWorktree
+
+## คำจำกัดความ
+
+Creates an isolated git worktree and switches the current session into it. Only used when the user explicitly asks to work in a worktree.
+
+## พารามิเตอร์
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| name | string | No | A name for the worktree. If not provided, a random name is generated. |
+
+## กรณีการใช้งาน
+
+**เหมาะสำหรับ:**
+- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree")
+
+**ไม่เหมาะสำหรับ:**
+- The user asks to create/switch branches — use git commands instead
+- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
+
+## หมายเหตุ
+
+- Must be in a git repository, or have WorktreeCreate/WorktreeRemove hooks configured
+- Must not already be in a worktree
+
+## ข้อความต้นฉบับ
+
+<textarea readonly>Use this tool ONLY when the user explicitly asks to work in a worktree. This tool creates an isolated git worktree and switches the current session into it.
+
+## When to Use
+
+- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree", "use a worktree")
+
+## When NOT to Use
+
+- The user asks to create a branch, switch branches, or work on a different branch — use git commands instead
+- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
+- Never use this tool unless the user explicitly mentions "worktree"
+
+## Requirements
+
+- Must be in a git repository, OR have WorktreeCreate/WorktreeRemove hooks configured in settings.json
+- Must not already be in a worktree
+
+## Behavior
+
+- In a git repository: creates a new git worktree inside `.claude/worktrees/` with a new branch based on HEAD
+- Outside a git repository: delegates to WorktreeCreate/WorktreeRemove hooks for VCS-agnostic isolation
+- Switches the session's working directory to the new worktree
+- On session exit, the user will be prompted to keep or remove the worktree
+
+## Parameters
+
+- `name` (optional): A name for the worktree. If not provided, a random name is generated.
+</textarea>

package/concepts/th/Tool-ExitPlanMode.md

@@ -0,0 +1,62 @@
+# ExitPlanMode
+
+## คำจำกัดความ
+
+ออกจากโหมดวางแผนและส่งแผนให้ผู้ใช้อนุมัติ เนื้อหาแผนจะถูกอ่านจากไฟล์แผนที่เขียนไว้ก่อนหน้า
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `allowedPrompts` | array | ไม่ | รายการคำอธิบายสิทธิ์ที่จำเป็นสำหรับแผนการดำเนินงาน |
+
+แต่ละองค์ประกอบในอาร์เรย์ `allowedPrompts`:
+
+| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `tool` | enum | ใช่ | เครื่องมือที่ใช้ได้ ปัจจุบันรองรับเฉพาะ `Bash` |
+| `prompt` | string | ใช่ | คำอธิบายเชิงความหมายของการดำเนินงาน (เช่น "run tests", "install dependencies") |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ในโหมดวางแผน เมื่อแผนเสร็จสมบูรณ์และพร้อมส่งให้ผู้ใช้อนุมัติ
+- ใช้เฉพาะสำหรับงานดำเนินการที่ต้องเขียนโค้ด
+
+**ไม่เหมาะสำหรับ:**
+- งานวิจัย/สำรวจล้วนๆ — ไม่จำเป็นต้องออกจากโหมดวางแผน
+- ต้องการถามผู้ใช้ว่า "แผนนี้โอเคไหม?" — นี่คือฟังก์ชันของเครื่องมือนี้เอง อย่าใช้ AskUserQuestion เพื่อถาม
+
+## ข้อควรระวัง
+
+- เครื่องมือนี้ไม่รับเนื้อหาแผนเป็นพารามิเตอร์ — มันอ่านจากไฟล์แผนที่เขียนไว้ก่อนหน้า
+- ผู้ใช้จะเห็นเนื้อหาของไฟล์แผนเพื่ออนุมัติ
+- อย่าใช้ AskUserQuestion ถามว่า "แผนโอเคไหม?" ก่อนเรียกเครื่องมือนี้ เพราะเป็นการซ้ำซ้อน
+- อย่ากล่าวถึง "แผน" ในคำถาม เพราะผู้ใช้ไม่สามารถเห็นเนื้อหาแผนก่อน ExitPlanMode
+
+## ข้อความต้นฉบับ
+
+<textarea readonly>Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
+
+## How This Tool Works
+- You should have already written your plan to the plan file specified in the plan mode system message
+- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
+- This tool simply signals that you're done planning and ready for the user to review and approve
+- The user will see the contents of your plan file when they review it
+
+## When to Use This Tool
+IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
+
+## Before Using This Tool
+Ensure your plan is complete and unambiguous:
+- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
+- Once your plan is finalized, use THIS tool to request approval
+
+**Important:** Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
+
+## Examples
+
+1. Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
+2. Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
+3. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.
+</textarea>

package/concepts/th/Tool-Glob.md

@@ -0,0 +1,39 @@
+# Glob
+
+## คำจำกัดความ
+
+เครื่องมือจับคู่รูปแบบชื่อไฟล์ที่รวดเร็ว รองรับโค้ดเบสทุกขนาด ส่งคืนพาธไฟล์ที่ตรงกันเรียงตามเวลาแก้ไข
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `pattern` | string | ใช่ | รูปแบบ glob (เช่น `**/*.js`, `src/**/*.ts`) |
+| `path` | string | ไม่ | ไดเรกทอรีค้นหา ค่าเริ่มต้นคือไดเรกทอรีทำงานปัจจุบัน อย่าส่ง "undefined" หรือ "null" |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ค้นหาไฟล์ตามรูปแบบชื่อ
+- ค้นหาไฟล์ทั้งหมดของประเภทเฉพาะ (เช่น ไฟล์ `.tsx` ทั้งหมด)
+- ระบุตำแหน่งไฟล์เมื่อค้นหาคำจำกัดความคลาสเฉพาะ (เช่น `class Foo`)
+- สามารถเรียก Glob หลายครั้งพร้อมกันในข้อความเดียว
+
+**ไม่เหมาะสำหรับ:**
+- ค้นหาเนื้อหาไฟล์ — ควรใช้ Grep
+- การสำรวจแบบเปิดที่ต้องค้นหาหลายรอบ — ควรใช้ Task (ประเภท Explore)
+
+## ข้อควรระวัง
+
+- รองรับไวยากรณ์ glob มาตรฐาน: `*` จับคู่ระดับเดียว, `**` จับคู่หลายระดับ, `{}` จับคู่หลายตัวเลือก
+- ผลลัพธ์เรียงตามเวลาแก้ไข
+- แนะนำให้ใช้มากกว่าคำสั่ง `find` ของ Bash
+
+## ข้อความต้นฉบับ
+
+<textarea readonly>- Fast file pattern matching tool that works with any codebase size
+- Supports glob patterns like "**/*.js" or "src/**/*.ts"
+- Returns matching file paths sorted by modification time
+- Use this tool when you need to find files by name patterns
+- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
+- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>

package/concepts/th/Tool-Grep.md

@@ -0,0 +1,57 @@
+# Grep
+
+## คำจำกัดความ
+
+เครื่องมือค้นหาเนื้อหาที่ทรงพลังโดยใช้ ripgrep รองรับนิพจน์ทั่วไป การกรองตามประเภทไฟล์ และโหมดผลลัพธ์หลายแบบ
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `pattern` | string | ใช่ | รูปแบบค้นหาด้วยนิพจน์ทั่วไป |
+| `path` | string | ไม่ | พาธค้นหา (ไฟล์หรือไดเรกทอรี) ค่าเริ่มต้นคือไดเรกทอรีทำงานปัจจุบัน |
+| `glob` | string | ไม่ | ตัวกรองชื่อไฟล์ (เช่น `*.js`, `*.{ts,tsx}`) |
+| `type` | string | ไม่ | ตัวกรองประเภทไฟล์ (เช่น `js`, `py`, `rust`) มีประสิทธิภาพมากกว่า glob |
+| `output_mode` | enum | ไม่ | โหมดผลลัพธ์: `files_with_matches` (ค่าเริ่มต้น), `content`, `count` |
+| `-i` | boolean | ไม่ | ค้นหาโดยไม่คำนึงถึงตัวพิมพ์ใหญ่-เล็ก |
+| `-n` | boolean | ไม่ | แสดงหมายเลขบรรทัด (เฉพาะโหมด content) ค่าเริ่มต้น true |
+| `-A` | number | ไม่ | จำนวนบรรทัดที่แสดงหลังการจับคู่ |
+| `-B` | number | ไม่ | จำนวนบรรทัดที่แสดงก่อนการจับคู่ |
+| `-C` / `context` | number | ไม่ | จำนวนบรรทัดที่แสดงก่อนและหลังการจับคู่ |
+| `head_limit` | number | ไม่ | จำกัดจำนวนรายการผลลัพธ์ ค่าเริ่มต้น 0 (ไม่จำกัด) |
+| `offset` | number | ไม่ | ข้ามผลลัพธ์ N รายการแรก |
+| `multiline` | boolean | ไม่ | เปิดใช้โหมดจับคู่หลายบรรทัด ค่าเริ่มต้น false |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ค้นหาสตริงหรือรูปแบบเฉพาะในโค้ดเบส
+- ค้นหาตำแหน่งการใช้งานของฟังก์ชัน/ตัวแปร
+- กรองผลลัพธ์การค้นหาตามประเภทไฟล์
+- นับจำนวนการจับคู่
+
+**ไม่เหมาะสำหรับ:**
+- ค้นหาไฟล์ตามชื่อ — ควรใช้ Glob
+- การสำรวจแบบเปิดที่ต้องค้นหาหลายรอบ — ควรใช้ Task (ประเภท Explore)
+
+## ข้อควรระวัง
+
+- ใช้ไวยากรณ์ ripgrep (ไม่ใช่ grep) อักขระพิเศษเช่นวงเล็บปีกกาต้องใช้ escape
+- โหมด `files_with_matches` ส่งคืนเฉพาะพาธไฟล์ มีประสิทธิภาพสูงสุด
+- โหมด `content` ส่งคืนเนื้อหาบรรทัดที่ตรงกัน รองรับบรรทัดบริบท
+- การจับคู่หลายบรรทัดต้องตั้งค่า `multiline: true`
+- ควรใช้เครื่องมือ Grep แทนคำสั่ง `grep` หรือ `rg` ใน Bash เสมอ
+
+## ข้อความต้นฉบับ
+
+<textarea readonly>A powerful search tool built on ripgrep
+
+  Usage:
+  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
+  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
+  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
+  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
+  - Use Agent tool for open-ended searches requiring multiple rounds
+  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
+  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
+</textarea>

package/concepts/th/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## คำจำกัดความ
+
+แทนที่ แทรก หรือลบเซลล์เฉพาะใน Jupyter notebook (ไฟล์ .ipynb)
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `notebook_path` | string | ใช่ | พาธแบบสัมบูรณ์ของไฟล์ notebook |
+| `new_source` | string | ใช่ | เนื้อหาใหม่ของเซลล์ |
+| `cell_id` | string | ไม่ | ID ของเซลล์ที่จะแก้ไข ในโหมดแทรก เซลล์ใหม่จะถูกแทรกหลัง ID นี้ |
+| `cell_type` | enum | ไม่ | ประเภทเซลล์: `code` หรือ `markdown` จำเป็นในโหมดแทรก |
+| `edit_mode` | enum | ไม่ | โหมดแก้ไข: `replace` (ค่าเริ่มต้น), `insert`, `delete` |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- แก้ไขเซลล์โค้ดหรือ markdown ใน Jupyter notebook
+- เพิ่มเซลล์ใหม่ใน notebook
+- ลบเซลล์ใน notebook
+
+## ข้อควรระวัง
+
+- `cell_number` เป็นดัชนีเริ่มจาก 0
+- โหมด `insert` แทรกเซลล์ใหม่ที่ตำแหน่งที่ระบุ
+- โหมด `delete` ลบเซลล์ที่ตำแหน่งที่ระบุ
+- พาธต้องเป็นแบบสัมบูรณ์
+
+## ข้อความต้นฉบับ
+
+<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>

package/concepts/th/Tool-Read.md

@@ -0,0 +1,56 @@
+# Read
+
+## คำจำกัดความ
+
+อ่านเนื้อหาไฟล์จากระบบไฟล์ในเครื่อง รองรับไฟล์ข้อความ รูปภาพ PDF และ Jupyter notebook
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `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>

package/concepts/th/Tool-SendMessage.md

@@ -0,0 +1,41 @@
+# SendMessage
+
+## คำจำกัดความ
+
+ส่งข้อความระหว่าง agent ภายในทีม ใช้สำหรับการสื่อสารโดยตรง การกระจายข้อความ และข้อความโปรโตคอล (คำขอ/การตอบกลับการปิดระบบ, การอนุมัติแผน)
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|-------------|--------|--------|----------|
+| `to` | string | ใช่ | ผู้รับ: ชื่อสมาชิกทีม หรือ `"*"` สำหรับกระจายถึงทุกคน |
+| `message` | string / object | ใช่ | ข้อความข้อความล้วนหรือออบเจกต์โปรโตคอลแบบมีโครงสร้าง |
+| `summary` | string | ไม่ | ตัวอย่างข้อความ 5-10 คำที่แสดงในหน้าจอ |
+
+## ประเภทข้อความ
+
+### ข้อความล้วน
+ข้อความโดยตรงระหว่างสมาชิกทีมสำหรับการประสานงาน อัปเดตสถานะ และหารือเกี่ยวกับงาน
+
+### คำขอปิดระบบ
+ขอให้สมาชิกปิดระบบอย่างเรียบร้อย: `{ type: "shutdown_request", reason: "..." }`
+
+### การตอบกลับการปิดระบบ
+สมาชิกอนุมัติหรือปฏิเสธการปิดระบบ: `{ type: "shutdown_response", approve: true/false }`
+
+### การตอบกลับการอนุมัติแผน
+อนุมัติหรือปฏิเสธแผนของสมาชิก: `{ type: "plan_approval_response", approve: true/false }`
+
+## กระจายข้อความ vs ส่งตรง
+
+- **ส่งตรง** (`to: "ชื่อ-สมาชิก"`): ส่งถึงสมาชิกเฉพาะราย — แนะนำสำหรับการสื่อสารส่วนใหญ่
+- **กระจาย** (`to: "*"`): ส่งถึงสมาชิกทุกคน — ใช้อย่างประหยัด เฉพาะประกาศสำคัญระดับทีมเท่านั้น
+
+## เครื่องมือที่เกี่ยวข้อง
+
+| เครื่องมือ | วัตถุประสงค์ |
+|-----------|-------------|
+| `TeamCreate` | สร้างทีมใหม่ |
+| `TeamDelete` | ลบทีมเมื่อเสร็จสิ้น |
+| `Agent` | สร้างสมาชิกที่เข้าร่วมทีม |
+| `TaskCreate` / `TaskUpdate` / `TaskList` | จัดการรายการงานที่แชร์ร่วมกัน |

package/concepts/th/Tool-Skill.md

@@ -0,0 +1,56 @@
+# Skill
+
+## คำจำกัดความ
+
+รันทักษะ (skill) ในการสนทนาหลัก ทักษะคือความสามารถเฉพาะทางที่ผู้ใช้สามารถเรียกใช้ผ่าน slash command (เช่น `/commit`, `/review-pr`)
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `skill` | string | ใช่ | ชื่อทักษะ (เช่น "commit", "review-pr", "pdf") |
+| `args` | string | ไม่ | อาร์กิวเมนต์ของทักษะ |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ผู้ใช้ป้อน slash command ในรูปแบบ `/<skill-name>`
+- คำร้องขอของผู้ใช้ตรงกับฟังก์ชันของทักษะที่ลงทะเบียนไว้
+
+**ไม่เหมาะสำหรับ:**
+- คำสั่ง CLI ในตัว (เช่น `/help`, `/clear`)
+- ทักษะที่กำลังทำงานอยู่แล้ว
+- ชื่อทักษะที่ไม่อยู่ในรายการทักษะที่ใช้ได้
+
+## ข้อควรระวัง
+
+- หลังจากถูกเรียก ทักษะจะขยายเป็น prompt ที่สมบูรณ์
+- รองรับชื่อแบบเต็ม (เช่น `ms-office-suite:pdf`)
+- รายการทักษะที่ใช้ได้จะอยู่ในข้อความ system-reminder
+- เมื่อเห็นแท็ก `<command-name>` แสดงว่าทักษะถูกโหลดแล้ว ควรดำเนินการโดยตรงโดยไม่ต้องเรียกเครื่องมือนี้อีก
+- อย่ากล่าวถึงทักษะโดยไม่ได้เรียกเครื่องมือจริง
+
+## ข้อความต้นฉบับ
+
+<textarea readonly>Execute a skill within the main conversation
+
+When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+
+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.
+
+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>

package/concepts/th/Tool-Task.md

@@ -0,0 +1,51 @@
+# Task
+
+> **หมายเหตุ:** ใน Claude Code เวอร์ชันใหม่ เครื่องมือนี้ได้เปลี่ยนชื่อเป็น **Agent** ดูเอกสาร [Tool-Agent](Tool-Agent)
+
+## คำจำกัดความ
+
+เริ่มต้น sub-agent (SubAgent) เพื่อจัดการงานหลายขั้นตอนที่ซับซ้อนอย่างอิสระ Sub-agent เป็นกระบวนการย่อยอิสระ แต่ละตัวมีชุดเครื่องมือและบริบทเฉพาะของตัวเอง
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `prompt` | string | ใช่ | คำอธิบายงานที่ sub-agent จะดำเนินการ |
+| `description` | string | ใช่ | สรุปสั้น 3-5 คำ |
+| `subagent_type` | string | ใช่ | ประเภท sub-agent กำหนดชุดเครื่องมือที่ใช้ได้ |
+| `model` | enum | ไม่ | ระบุโมเดล (sonnet / opus / haiku) ค่าเริ่มต้นสืบทอดจากพาเรนต์ |
+| `max_turns` | integer | ไม่ | จำนวนรอบ agentic สูงสุด |
+| `run_in_background` | boolean | ไม่ | รันในเบื้องหลังหรือไม่ งานเบื้องหลังส่งคืนพาธ output_file |
+| `resume` | string | ไม่ | ID ของ agent ที่จะกลับมาทำต่อ ดำเนินการต่อจากการรันครั้งก่อน |
+| `isolation` | enum | ไม่ | โหมดแยกส่วน `worktree` สร้าง git worktree ชั่วคราว |
+
+## ประเภท Sub-agent
+
+| ประเภท | วัตถุประสงค์ | เครื่องมือที่ใช้ได้ |
+|------|------|----------|
+| `Bash` | รันคำสั่ง การดำเนินการ git | Bash |
+| `general-purpose` | งานทั่วไปหลายขั้นตอน | เครื่องมือทั้งหมด |
+| `Explore` | สำรวจโค้ดเบสอย่างรวดเร็ว | ทั้งหมดยกเว้น Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | ออกแบบแผนการดำเนินงาน | ทั้งหมดยกเว้น Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | ถาม-ตอบเกี่ยวกับคู่มือการใช้ Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | ตั้งค่าแถบสถานะ | Read, Edit |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- งานซับซ้อนที่ต้องดำเนินการหลายขั้นตอนอย่างอิสระ
+- การสำรวจและวิจัยเชิงลึกของโค้ดเบส (ใช้ประเภท Explore)
+- งานคู่ขนานที่ต้องการสภาพแวดล้อมแยก
+- งานที่ใช้เวลานานที่ต้องรันในเบื้องหลัง
+
+**ไม่เหมาะสำหรับ:**
+- อ่านพาธไฟล์เฉพาะ — ใช้ Read หรือ Glob โดยตรง
+- ค้นหาใน 2-3 ไฟล์ที่รู้จัก — ใช้ Read โดยตรง
+- ค้นหาคำจำกัดความคลาสเฉพาะ — ใช้ Glob โดยตรง
+
+## ข้อควรระวัง
+
+- หลังจากเสร็จสิ้น sub-agent จะส่งคืนข้อความเดียว ผลลัพธ์ไม่ปรากฏให้ผู้ใช้เห็น agent หลักต้องถ่ายทอดให้
+- สามารถเริ่มการเรียก Task หลายรายการพร้อมกันในข้อความเดียวเพื่อเพิ่มประสิทธิภาพ
+- งานเบื้องหลังตรวจสอบความคืบหน้าผ่านเครื่องมือ TaskOutput
+- ประเภท Explore ช้ากว่าการเรียก Glob/Grep โดยตรง ใช้เฉพาะเมื่อการค้นหาง่ายๆ ไม่เพียงพอ