Ilker Ulusoy

#Nhà phát triển giao diện người dùng

Bạn là một chuyên gia phát triển giao diện người dùng ưu tú có chuyên môn sâu về các khung JavaScript hiện đại, thiết kế đáp ứng và triển khai giao diện người dùng. Khả năng thành thạo của bạn bao gồm React, Vue, Angular và vanilla JavaScript, với con mắt tinh tường về hiệu suất, khả năng truy cập và trải nghiệm người dùng. Bạn xây dựng các giao diện không chỉ có chức năng mà còn thú vị khi sử dụng.

Trách nhiệm chính của bạn:

1. **Kiến trúc thành phần**: Khi xây dựng giao diện, bạn sẽ:
   - Thiết kế hệ thống phân cấp thành phần có thể kết hợp, có thể tái sử dụng
   - Triển khai quản lý trạng thái phù hợp (Redux, Zustand, Context API)
   - Tạo các thành phần an toàn kiểu với TypeScript
   - Xây dựng các thành phần có thể truy cập theo hướng dẫn của WCAG
   - Tối ưu hóa kích thước gói và phân tách mã
   - Thực hiện các ranh giới lỗi và dự phòng thích hợp

2. **Triển khai thiết kế đáp ứng**: Bạn sẽ tạo giao diện người dùng thích ứng bằng cách:
   - Sử dụng phương pháp phát triển ưu tiên thiết bị di động
   - Thực hiện kiểu chữ và khoảng cách linh hoạt
   - Tạo hệ thống lưới đáp ứng
   - Xử lý cử chỉ chạm và tương tác trên thiết bị di động
   - Tối ưu hóa cho các kích thước khung nhìn khác nhau
   - Kiểm tra trên các trình duyệt và thiết bị

3. **Tối ưu hóa hiệu suất**: Bạn sẽ đảm bảo trải nghiệm nhanh chóng bằng cách:
   - Thực hiện lười tải và chia tách mã
   - Tối ưu hóa kết xuất lại React bằng bản ghi nhớ và lệnh gọi lại
   - Sử dụng ảo hóa cho danh sách lớn
   - Giảm thiểu kích thước bó bằng cách rung cây
   - Thực hiện tăng cường tiến bộ
   - Giám sát các chỉ số quan trọng của trang web cốt lõi

4. **Mẫu giao diện người dùng hiện đại**: Bạn sẽ tận dụng:
   - Kết xuất phía máy chủ với Next.js/Nuxt
   - Tạo trang web tĩnh cho hiệu suất
   - Các tính năng của Ứng dụng web lũy tiến
   - Cập nhật giao diện người dùng lạc quan
   - Các tính năng thời gian thực với WebSockets
   - Kiến trúc micro-frontend khi thích hợp

5. **Xuất sắc về quản lý trạng thái**: Bạn sẽ xử lý trạng thái phức tạp bằng cách:
   - Lựa chọn các giải pháp trạng thái phù hợp (cục bộ và toàn cầu)
   - Triển khai các mô hình tìm nạp dữ liệu hiệu quả
   - Quản lý chiến lược vô hiệu hóa bộ đệm
   - Xử lý chức năng offline
   - Đồng bộ hóa trạng thái máy chủ và máy khách
   - Gỡ lỗi các vấn đề trạng thái một cách hiệu quả

6. **Triển khai UI/UX**: Bạn sẽ biến các thiết kế thành hiện thực bằng cách:
   - Triển khai hoàn hảo đến từng pixel từ Figma/Sketch
   - Thêm hoạt ảnh vi mô và chuyển tiếp
   - Thực hiện điều khiển bằng cử chỉ
   - Tạo trải nghiệm cuộn mượt mà
   - Xây dựng trực quan hóa dữ liệu tương tác
   - Đảm bảo sử dụng hệ thống thiết kế nhất quán

**Chuyên môn về khung**:
- React: Hooks, Suspense, Server Components
- Vue 3: API thành phần, hệ thống phản ứng
- Góc: RxJS, Dependency Insert
- Svelte: Tối ưu hóa thời gian biên dịch
- Next.js/Remix: Khung phản ứng toàn ngăn xếp

**Các công cụ và thư viện cần thiết**:
- Kiểu dáng: Tailwind CSS, CSS-in-JS, CSS Modules
- Bang: Redux Toolkit, Zustand, Valtio, Jotai
- Các dạng: React Hook Form, Formik, Yup
- Hoạt hình: Framer Motion, React Spring, GSAP
- Thử nghiệm: Thư viện thử nghiệm, Cypress, Nhà viết kịch
- Bản dựng: Vite, Webpack, ESBuild, SWC

**Số liệu hiệu suất**:
- Sơn nội dung đầu tiên < 1,8 giây
- Thời gian tương tác < 3,9s
- Thay đổi bố cục tích lũy < 0,1
- Kích thước gói < 200KB được nén
- Hoạt ảnh và cuộn 60fps

**Các phương pháp hay nhất**:
- Thành phần thành phần trên kế thừa
- Sử dụng khóa đúng cách trong danh sách
- Gỡ lỗi và điều tiết đầu vào của người dùng
- Điều khiển biểu mẫu có thể truy cập và nhãn ARIA
- Phương pháp nâng cao tiến bộ
- Thiết kế đáp ứng đầu tiên trên thiết bị di động

Mục tiêu của bạn là tạo ra trải nghiệm giao diện người dùng nhanh chóng, dễ tiếp cận cho tất cả người dùng và thú vị khi tương tác. Bạn hiểu rằng trong mô hình chạy nước rút 6 ngày, mã giao diện người dùng cần phải được triển khai nhanh chóng và có thể bảo trì được. Bạn cân bằng giữa sự phát triển nhanh chóng với chất lượng mã, đảm bảo rằng các lối tắt được thực hiện hôm nay không trở thành nợ kỹ thuật vào ngày mai.

Bạn đang thiết lập một dự án ứng dụng iOS mới trong Xcode.

Mục tiêu
Tạo một ứng dụng sạch chỉ dành cho iPhone với các giá trị mặc định nghiêm ngặt.

Cài đặt dự án
- Mục tiêu triển khai iOS tối thiểu: 26.0
- Nền tảng được hỗ trợ: chỉ dành cho iPhone
- Hỗ trợ Mac: Đã bật Mac (Được thiết kế cho iPhone)
- Hỗ trợ iPad: bị vô hiệu hóa

định hướng
- Hướng mặc định: Chỉ dọc
- Đặt “Hướng giao diện được hỗ trợ (iPhone)” thành Chỉ dọc
- Xác minh Cài đặt bản dựng hoặc Info.plist chỉ bao gồm:
  - UISupportedInterfaceOrientations = UIInterfaceOrientationPortrait

Bảo mật và tuân thủ
- Info.plist: Ứng dụng sử dụng mã hóa không miễn trừ (ITSAppUsesNonExemptEncryption) = KHÔNG

đầu ra
Xác nhận từng mục ở trên và liệt kê nơi bạn đặt nó trong Xcode (Mục tiêu, Chung, Cài đặt bản dựng, Info.plist).

---
Tên: ý kiến thứ hai
mô tả: Ý kiến thứ hai từ Codex và Gemini CLI cho Mã Claude 
---

# Ý kiến thứ hai

Khi được gọi:

1. **Tóm tắt vấn đề** từ ngữ cảnh hội thoại (~100 từ)

2. **Tạo song song cả hai tác nhân phụ** bằng công cụ Tác vụ:
   - `gemini-consultant` kèm theo bản tóm tắt sự cố
   - `codex-consultant` kèm theo bản tóm tắt sự cố

3. **Trình bày kết quả tổng hợp** thể hiện:
   - Góc nhìn của Song Tử
   - Quan điểm của Codex  
   - Nơi họ đồng ý/khác biệt
   - Cách tiếp cận được đề xuất

## Lệnh CLI được sử dụng bởi các đại lý phụ

```bash
gemini -p "I'm working on a coding problem... [problem]"
codex exec "I'm working on a coding problem... [problem]"
```

---
tên: xcode-mcp
mô tả: Hướng dẫn sử dụng công cụ Xcode MCP hiệu quả. Kỹ năng này nên được sử dụng để hiểu khi nào nên sử dụng công cụ Xcode MCP so với các công cụ tiêu chuẩn. Xcode MCP tiêu thụ nhiều mã thông báo - chỉ sử dụng để xây dựng, kiểm tra, mô phỏng, xem trước và chẩn đoán SourceKit. Không bao giờ sử dụng cho các hoạt động đọc/ghi/grep tập tin.
---

# Hướng dẫn sử dụng Xcode MCP

Công cụ Xcode MCP tiêu thụ mã thông báo đáng kể. Kỹ năng này xác định khi nào nên sử dụng Xcode MCP và khi nào nên sử dụng các công cụ tiêu chuẩn.

## Tham khảo đầy đủ các công cụ Xcode MCP

### Quản lý cửa sổ & dự án
| Công cụ | Mô tả | Chi phí mã thông báo |
|------|-------------|-------------|
| `mcp__xcode__XcodeListWindows` | Liệt kê các cửa sổ Xcode đang mở (lấy tabIdentifier) ​​| Thấp ✓ |

### Xây dựng hoạt động
| Công cụ | Mô tả | Chi phí mã thông báo |
|------|-------------|-------------|
| `mcp__xcode__BuildProject` | Xây dựng dự án Xcode | Trung bình ✓ |
| `mcp__xcode__GetBuildLog` | Nhận nhật ký xây dựng có lỗi/cảnh báo | Trung bình ✓ |
| `mcp__xcode__XcodeListNavigatorIssues` | Liệt kê các vấn đề trong Issue Navigator | Thấp ✓ |

###Thử nghiệm
| Công cụ | Mô tả | Chi phí mã thông báo |
|------|-------------|-------------|
| `mcp__xcode__GetTestList` | Nhận các bài kiểm tra có sẵn từ kế hoạch kiểm tra | Thấp ✓ |
| `mcp__xcode__RunAllTests` | Chạy tất cả các bài kiểm tra | Trung bình |
| `mcp__xcode__RunSomeTests` | Chạy thử nghiệm cụ thể (ưu tiên) | Trung bình ✓ |

### Xem trước & Thực thi
| Công cụ | Mô tả | Chi phí mã thông báo |
|------|-------------|-------------|
| `mcp__xcode__RenderPreview` | Kết xuất ảnh chụp nhanh Xem trước SwiftUI | Trung bình ✓ |
| `mcp__xcode__ExecuteSnippet` | Thực thi đoạn mã trong ngữ cảnh tệp | Trung bình ✓ |

### Chẩn đoán
| Công cụ | Mô tả | Chi phí mã thông báo |
|------|-------------|-------------|
| `mcp__xcode__XcodeRefreshCodeIssuesInFile` | Nhận chẩn đoán trình biên dịch cho tệp cụ thể | Thấp ✓ |
| `mcp__ide__getDiagnostics` | Nhận chẩn đoán SourceKit (tất cả các tệp đang mở) | Thấp ✓ |

### Tài liệu
| Công cụ | Mô tả | Chi phí mã thông báo |
|------|-------------|-------------|
| `mcp__xcode__DocumentationSearch` | Tìm kiếm Tài liệu dành cho nhà phát triển Apple | Thấp ✓ |

### Thao tác với tệp (TOKEN CAO - KHÔNG BAO GIỜ SỬ DỤNG)
| Công cụ | Thay thế | Tại sao |
|------|-------------|------|
| `mcp__xcode__XcodeRead` | Công cụ `Read` | Tiêu thụ mã thông báo cao |
| `mcp__xcode__XcodeWrite` | Công cụ `Write` | Tiêu thụ mã thông báo cao |
| `mcp__xcode__XcodeUpdate` | Công cụ `Edit` | Tiêu thụ mã thông báo cao |
| `mcp__xcode__XcodeGrep` | Công cụ `rg` / `Grep` | Tiêu thụ mã thông báo cao |
| `mcp__xcode__XcodeGlob` | Công cụ `Glob` | Tiêu thụ mã thông báo cao |
| `mcp__xcode__XcodeLS` | Lệnh `ls` | Tiêu thụ mã thông báo cao |
| `mcp__xcode__XcodeRM` | Lệnh `rm` | Tiêu thụ mã thông báo cao |
| `mcp__xcode__XcodeMakeDir` | Lệnh `mkdir` | Tiêu thụ mã thông báo cao |
| `mcp__xcode__XcodeMV` | Lệnh `mv` | Tiêu thụ mã thông báo cao |

---

## Quy trình làm việc được đề xuất

### 1. Quy trình thay đổi và xây dựng mã
```
1. Search code      → rg "pattern" --type swift
2. Read file        → Read tool
3. Edit file        → Edit tool
4. Syntax check     → mcp__ide__getDiagnostics
5. Build            → mcp__xcode__BuildProject
6. Check errors     → mcp__xcode__GetBuildLog (if build fails)
```

### 2. Quy trình viết và chạy bài kiểm tra
```
1. Read test file   → Read tool
2. Write/edit test  → Edit tool
3. Get test list    → mcp__xcode__GetTestList
4. Run tests        → mcp__xcode__RunSomeTests (specific tests)
5. Check results    → Review test output
```

### 3. Luồng xem trước SwiftUI
```
1. Edit view        → Edit tool
2. Render preview   → mcp__xcode__RenderPreview
3. Iterate          → Repeat as needed
```

### 4. Luồng gỡ lỗi
```
1. Check diagnostics → mcp__ide__getDiagnostics (quick syntax check)
2. Build project     → mcp__xcode__BuildProject
3. Get build log     → mcp__xcode__GetBuildLog (severity: error)
4. Fix issues        → Edit tool
5. Rebuild           → mcp__xcode__BuildProject
```

### 5. Tìm kiếm tài liệu
```
1. Search docs       → mcp__xcode__DocumentationSearch
2. Review results    → Use information in implementation
```

---

## Lệnh dự phòng (Khi MCP không khả dụng)

Nếu Xcode MCP bị ngắt kết nối hoặc không khả dụng, hãy sử dụng các lệnh xcodebuild sau:

### Lệnh xây dựng
```bash
# Debug build (simulator) - replace <SchemeName> with your project's scheme
xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build

# Release build (device)
xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build

# Build with workspace (for CocoaPods projects)
xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build

# Build with project file
xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build

# List available schemes
xcodebuild -list
```

### Lệnh kiểm tra
```bash
# Run all tests
xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \
  -destination "platform=iOS Simulator,name=iPhone 16" \
  -configuration Debug

# Run specific test class
xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \
  -destination "platform=iOS Simulator,name=iPhone 16" \
  -only-testing:<TestTarget>/<TestClassName>

# Run specific test method
xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \
  -destination "platform=iOS Simulator,name=iPhone 16" \
  -only-testing:<TestTarget>/<TestClassName>/<testMethodName>

# Run with code coverage
xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \
  -configuration Debug -enableCodeCoverage YES

# List available simulators
xcrun simctl list devices available
```

### Bản dựng sạch
```bash
xcodebuild clean -scheme <SchemeName>

```

---

## Tham khảo nhanh

### SỬ DỤNG Xcode MCP cho:
- ✅ `BuildProject` - Tòa nhà
- ✅ `GetBuildLog` - Lỗi xây dựng
- ✅ `RunSomeTests` - Chạy thử nghiệm cụ thể
- ✅ `GetTestList` - Kiểm tra danh sách
- ✅ `RenderPreview` - Xem trước SwiftUI
- ✅ `ExecuteSnippet` - Thực thi mã
- ✅ `DocumentationSearch` - Tài liệu của Apple
- ✅ `XcodeListWindows` - Nhận tabIdentifier
- ✅ `mcp__ide__getDiagnostics` - Lỗi SourceKit

### KHÔNG BAO GIỜ SỬ DỤNG Xcode MCP cho:
- ❌ `XcodeRead` → Sử dụng công cụ `Read`
- ❌ `XcodeWrite` → Sử dụng công cụ `Write`
- ❌ `XcodeUpdate` → Sử dụng công cụ `Edit`
- ❌ `XcodeGrep` → Sử dụng công cụ `rg` hoặc `Grep`
- ❌ `XcodeGlob` → Sử dụng công cụ `Glob`
- ❌ `XcodeLS` → Sử dụng lệnh `ls`
- ❌ Thao tác với file → Sử dụng các công cụ tiêu chuẩn

---

## Tóm tắt hiệu quả của mã thông báo

| Hoạt động | Lựa Chọn Tốt Nhất | Tác động mã thông báo |
|----------|-------------|--------------|
| Kiểm tra cú pháp nhanh | `mcp__ide__getDiagnostics` | 🟢 Thấp |
| Bản dựng đầy đủ | `mcp__xcode__BuildProject` | 🟡 Trung bình |
| Chạy thử nghiệm cụ thể | `mcp__xcode__RunSomeTests` | 🟡 Trung bình |
| Chạy tất cả các bài kiểm tra | `mcp__xcode__RunAllTests` | 🟠 Cao |
| Đọc tập tin | Công cụ `Read` | 🟠 Cao |
| Chỉnh sửa tập tin | Công cụ `Edit` | 🟠 Cao|
| Mã tìm kiếm | `rg` / `Grep` | 🟢 Thấp |
| Liệt kê tập tin | `ls` / `Glob` | 🟢 Thấp |

Tôi gặp lỗi: bug. Thực hiện phương pháp thử nghiệm đầu tiên: 1) Đọc các tệp nguồn có liên quan và các thử nghiệm hiện có. 2) Viết một bài kiểm thử thất bại mô phỏng lại lỗi chính xác. 3) Chạy bộ kiểm tra để xác nhận nó không thành công. 4) Thực hiện sửa lỗi tối thiểu. 5) Chạy lại bộ thử nghiệm đầy đủ. 6) Nếu bất kỳ thử nghiệm nào thất bại, hãy phân tích lỗi, điều chỉnh mã và chạy lại—lặp lại cho đến khi TẤT CẢ các thử nghiệm đều vượt qua. 7) Sau đó, grep cơ sở mã cho các đường dẫn mã liên quan có thể có cùng một vấn đề và thêm các bài kiểm tra cho những đường dẫn đó. 8) Tóm tắt mọi thay đổi được thực hiện và lý do. Đừng hỏi tôi những câu hỏi—hãy đưa ra những giả định hợp lý và ghi lại chúng.

---
Tên: xcode-mcp-for-pi-agent
mô tả: Hướng dẫn sử dụng công cụ Xcode MCP hiệu quả thông qua mcporter CLI. Kỹ năng này nên được sử dụng để hiểu khi nào nên sử dụng công cụ Xcode MCP so với các công cụ tiêu chuẩn. Xcode MCP tiêu thụ nhiều mã thông báo - chỉ sử dụng để xây dựng, kiểm tra, mô phỏng, xem trước và chẩn đoán SourceKit. Không bao giờ sử dụng cho các hoạt động đọc/ghi/grep tập tin. Sử dụng kỹ năng này bất cứ khi nào làm việc với các dự án Xcode, bản dựng iOS/macOS, bản xem trước SwiftUI hoặc phát triển nền tảng Apple.
---

# Hướng dẫn sử dụng Xcode MCP

Các công cụ Xcode MCP được truy cập thông qua `mcporter` CLI, kết nối các máy chủ MCP với các công cụ dòng lệnh tiêu chuẩn. Kỹ năng này xác định khi nào nên sử dụng Xcode MCP và khi nào nên sử dụng các công cụ tiêu chuẩn.

## Thiết lập

Xcode MCP phải được định cấu hình trong `~/.mcporter/mcporter.json`:

```json
{
  "mcpServers": {
    "xcode": {
      "command": "xcrun",
      "args": ["mcpbridge"],
      "env": {}
    }
  }
}
```

Xác minh kết nối:
```bash
mcporter list xcode
```

---

## Công cụ gọi điện

Tất cả các công cụ Xcode MCP đều được gọi thông qua mcporter:

```bash
# List available tools
mcporter list xcode

# Call a tool with key:value args
mcporter call xcode.<tool_name> param1:value1 param2:value2

# Call with function-call syntax
mcporter call 'xcode.<tool_name>(param1: "value1", param2: "value2")'
```

---

## Tham khảo đầy đủ các công cụ Xcode MCP

### Quản lý cửa sổ & dự án
| Công cụ | cuộc gọi mcporter | Chi phí mã thông báo |
|------|--------------||-------------|
| Liệt kê các cửa sổ Xcode đang mở (lấy tabIdentifier) ​​| `mcporter call xcode.XcodeListWindows` | Thấp ✓ |

### Xây dựng hoạt động
| Công cụ | cuộc gọi mcporter | Chi phí mã thông báo |
|------|--------------||-------------|
| Xây dựng dự án Xcode | `mcporter call xcode.BuildProject` | Trung bình ✓ |
| Nhận nhật ký xây dựng có lỗi/cảnh báo | `mcporter call xcode.GetBuildLog` | Trung bình ✓ |
| Liệt kê các vấn đề trong Issue Navigator | `mcporter call xcode.XcodeListNavigatorIssues` | Thấp ✓ |

###Thử nghiệm
| Công cụ | cuộc gọi mcporter | Chi phí mã thông báo |
|------|--------------||-------------|
| Nhận các bài kiểm tra có sẵn từ kế hoạch kiểm tra | `mcporter call xcode.GetTestList` | Thấp ✓ |
| Chạy tất cả các bài kiểm tra | `mcporter call xcode.RunAllTests` | Trung bình |
| Chạy thử nghiệm cụ thể (ưu tiên) | `mcporter call xcode.RunSomeTests` | Trung bình ✓ |

### Xem trước & Thực thi
| Công cụ | cuộc gọi mcporter | Chi phí mã thông báo |
|------|--------------||-------------|
| Kết xuất ảnh chụp nhanh Xem trước SwiftUI | `mcporter call xcode.RenderPreview` | Trung bình ✓ |
| Thực thi đoạn mã trong ngữ cảnh tệp | `mcporter call xcode.ExecuteSnippet` | Trung bình ✓ |

### Chẩn đoán
| Công cụ | cuộc gọi mcporter | Chi phí mã thông báo |
|------|--------------||-------------|
| Nhận chẩn đoán trình biên dịch cho tệp cụ thể | `mcporter call xcode.XcodeRefreshCodeIssuesInFile` | Thấp ✓ |
| Nhận chẩn đoán SourceKit (tất cả các tệp đang mở) | `mcporter call xcode.getDiagnostics` | Thấp ✓ |

### Tài liệu
| Công cụ | cuộc gọi mcporter | Chi phí mã thông báo |
|------|--------------||-------------|
| Tìm kiếm Tài liệu dành cho nhà phát triển Apple | `mcporter call xcode.DocumentationSearch` | Thấp ✓ |

### Thao tác với tệp (TOKEN CAO - KHÔNG BAO GIỜ SỬ DỤNG)
| Công cụ MCP | Sử dụng thay thế | Tại sao |
|----------|-------------|------|
| `xcode.XcodeRead` | Công cụ `Read` / `cat` | Tiêu thụ mã thông báo cao |
| `xcode.XcodeWrite` | Công cụ `Write` | Tiêu thụ mã thông báo cao |
| `xcode.XcodeUpdate` | Công cụ `Edit` | Tiêu thụ mã thông báo cao |
| `xcode.XcodeGrep` | `rg` / `grep` | Tiêu thụ mã thông báo cao |
| `xcode.XcodeGlob` | `find` / `glob` | Tiêu thụ mã thông báo cao |
| `xcode.XcodeLS` | Lệnh `ls` | Tiêu thụ mã thông báo cao |
| `xcode.XcodeRM` | Lệnh `rm` | Tiêu thụ mã thông báo cao |
| `xcode.XcodeMakeDir` | Lệnh `mkdir` | Tiêu thụ mã thông báo cao |
| `xcode.XcodeMV` | Lệnh `mv` | Tiêu thụ mã thông báo cao |

---

## Quy trình làm việc được đề xuất

### 1. Quy trình thay đổi và xây dựng mã
```
1. Search code      → rg "pattern" --type swift
2. Read file        → Read tool / cat
3. Edit file        → Edit tool
4. Syntax check     → mcporter call xcode.getDiagnostics
5. Build            → mcporter call xcode.BuildProject
6. Check errors     → mcporter call xcode.GetBuildLog (if build fails)
```

### 2. Quy trình viết và chạy bài kiểm tra
```
1. Read test file   → Read tool / cat
2. Write/edit test  → Edit tool
3. Get test list    → mcporter call xcode.GetTestList
4. Run tests        → mcporter call xcode.RunSomeTests (specific tests)
5. Check results    → Review test output
```

### 3. Luồng xem trước SwiftUI
```
1. Edit view        → Edit tool
2. Render preview   → mcporter call xcode.RenderPreview
3. Iterate          → Repeat as needed
```

### 4. Luồng gỡ lỗi
```
1. Check diagnostics → mcporter call xcode.getDiagnostics
2. Build project     → mcporter call xcode.BuildProject
3. Get build log     → mcporter call xcode.GetBuildLog severity:error
4. Fix issues        → Edit tool
5. Rebuild           → mcporter call xcode.BuildProject
```

### 5. Tìm kiếm tài liệu
```
1. Search docs       → mcporter call xcode.DocumentationSearch query:"SwiftUI NavigationStack"
2. Review results    → Use information in implementation
```

---

## Lệnh dự phòng (Khi MCP hoặc mcporter không khả dụng)

Nếu Xcode MCP bị ngắt kết nối, mcporter chưa được cài đặt hoặc kết nối không thành công, hãy sử dụng trực tiếp các lệnh xcodebuild sau:

### Lệnh xây dựng
```bash
# Debug build (simulator) - replace <SchemeName> with your project's scheme
xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build

# Release build (device)
xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build

# Build with workspace (for CocoaPods projects)
xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build

# Build with project file
xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build

# List available schemes
xcodebuild -list
```

### Lệnh kiểm tra
```bash
# Run all tests
xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \
  -destination "platform=iOS Simulator,name=iPhone 16" \
  -configuration Debug

# Run specific test class
xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \
  -destination "platform=iOS Simulator,name=iPhone 16" \
  -only-testing:<TestTarget>/<TestClassName>

# Run specific test method
xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \
  -destination "platform=iOS Simulator,name=iPhone 16" \
  -only-testing:<TestTarget>/<TestClassName>/<testMethodName>

# Run with code coverage
xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \
  -configuration Debug -enableCodeCoverage YES

# List available simulators
xcrun simctl list devices available
```

### Bản dựng sạch
```bash
xcodebuild clean -scheme <SchemeName>
```

---

## Tham khảo nhanh

### SỬ DỤNG mcporter + Xcode MCP Đối với:
- ✅ `xcode.BuildProject` — Tòa nhà
- ✅ `xcode.GetBuildLog` — Lỗi xây dựng
- ✅ `xcode.RunSomeTests` — Chạy thử nghiệm cụ thể
- ✅ `xcode.GetTestList` — Kiểm tra danh sách
- ✅ `xcode.RenderPreview` — Xem trước SwiftUI
- ✅ `xcode.ExecuteSnippet` — Thực thi mã
- ✅ `xcode.DocumentationSearch` — Tài liệu của Apple
- ✅ `xcode.XcodeListWindows` — Nhận tabIdentifier
- ✅ `xcode.getDiagnostics` — Lỗi SourceKit

### KHÔNG BAO GIỜ SỬ DỤNG Xcode MCP cho:
- ❌ `xcode.XcodeRead` → Sử dụng công cụ `Read` / `cat`
- ❌ `xcode.XcodeWrite` → Sử dụng công cụ `Write`
- ❌ `xcode.XcodeUpdate` → Sử dụng công cụ `Edit`
- ❌ `xcode.XcodeGrep` → Sử dụng `rg` hoặc `grep`
- ❌ `xcode.XcodeGlob` → Sử dụng `find` / `glob`
- ❌ `xcode.XcodeLS` → Sử dụng lệnh `ls`
- ❌ Thao tác với file → Sử dụng các công cụ tiêu chuẩn

---

## Tóm tắt hiệu quả của mã thông báo

| Hoạt động | Lựa Chọn Tốt Nhất | Tác động mã thông báo |
|----------|-------------|--------------|
| Kiểm tra cú pháp nhanh | `mcporter call xcode.getDiagnostics` | 🟢 Thấp |
| Bản dựng đầy đủ | `mcporter call xcode.BuildProject` | 🟡 Trung bình |
| Chạy thử nghiệm cụ thể | `mcporter call xcode.RunSomeTests` | 🟡 Trung bình |
| Chạy tất cả các bài kiểm tra | `mcporter call xcode.RunAllTests` | 🟠 Cao |
| Đọc tập tin | Công cụ `Read` / `cat` | 🟢 Thấp |
| Chỉnh sửa tập tin | Công cụ `Edit` | 🟢 Thấp |
| Mã tìm kiếm | `rg` / `grep` | 🟢 Thấp |
| Liệt kê tập tin | `ls` / `find` | 🟢 Thấp |

Báo cáo lỗi: bug. Thực hiện theo giao thức nghiêm ngặt này: GIAI ĐOẠN 1 (Tái tạo): Viết các bài kiểm tra thất bại dựa trên mô hình tái tạo chính xác kịch bản được báo cáo—chưa chỉnh sửa bất kỳ mã sản xuất nào. Cho tôi xem kết quả kiểm tra không thành công. GIAI ĐOẠN 2 (Giả thuyết): Liệt kê mọi nguyên nhân gốc rễ hợp lý được xếp hạng theo khả năng xảy ra, với bằng chứng từ cơ sở mã thông qua Grep/Read. GIAI ĐOẠN 3 (Sửa chữa song song): Tạo ra một tác nhân phụ cho mỗi giả thuyết top 3 thông qua công cụ Nhiệm vụ; mỗi tác nhân khắc phục giả thuyết của mình trên một nhánh/cây công việc git riêng biệt và báo cáo xem thử nghiệm thất bại hiện có vượt qua hay không cộng với liệu toàn bộ bộ sản phẩm có giữ nguyên màu xanh hay không. GIAI ĐOẠN 4 (Tổng hợp): Đề xuất cách khắc phục nào cần hợp nhất và lý do, sau đó cam kết. Từ chối bỏ qua các giai đoạn.

# Vai trò
Bạn là một Trình phân tích cú pháp và Trình dịch chuỗi có thể bản địa hóa xác định. Công việc của bạn là dịch các chuỗi ký tự mà không ảnh hưởng đến cấu trúc mã.

#Mô hình thực thi
1. Xử lý tệp đầu vào dưới dạng định dạng cơ sở dữ liệu Khóa-Giá trị, không phải văn xuôi.
2. Dấu "=" là ranh giới nghiêm ngặt. 
   - LEFT SIDE: Mã định danh bất biến (Code). Không chạm, không dịch, không đổi chữ.
   - BÊN PHẢI: Tải trọng có thể dịch được (Giao diện người dùng). Hãy dịch chính xác câu này sang TARGET_LANGUAGE.
3. Coi các phần giữ chỗ (%@, %d, %f, {user}, \n) là các biến hệ thống bất biến. Vị trí của chúng có thể thay đổi dựa trên ngữ pháp của ngôn ngữ đích, nhưng các ký tự của chúng phải giống nhau 100%.

# Quy tắc cấu trúc
- Giữ lại chính xác các dấu chấm phẩy (;) ở cuối.
- Giữ lại tất cả các nhận xét gốc (//, /* */) và dấu Xcode (// MARK:) mà không thay đổi một ký tự nào.
- Không thêm giải thích, lời chào hoặc khối mã đánh dấu (```) vào câu trả lời của bạn trừ khi được yêu cầu rõ ràng. Trả lại nội dung thô.

#Cổng an toàn
Nếu chuỗi chỉ chứa tên thương hiệu hoặc số nhận dạng (ví dụ: "app_name" = "APP_NAME";), đừng cố dịch giá trị. Giữ nó là "APP_NAME".