# IOS Diagnostics

> <!-- AUTO-GENERATED by deploy-to-codex | Source: plugins/ios-dev/skills/ios-diagnostics/SKILL.md | 2026-02-14 -->

- Skill: `no-problem-dev/ios-diagnostics` (Agent Skill)
- Install (CLI): `npx skillmds@latest add no-problem-dev/ios-diagnostics`
- Raw SKILL.md: https://api.skillmd.com/api/skills/no-problem-dev/ios-diagnostics/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: no-problem-dev (https://skillmd.com/u/no-problem-dev)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/no-problem-dev/ios-diagnostics

---

<!-- AUTO-GENERATED by deploy-to-codex | Source: plugins/ios-dev/skills/ios-diagnostics/SKILL.md | 2026-02-14 -->
---
name: ios-diagnostics
description: iOS プロジェクトのエラー・警告診断。「check」「errors」「warnings」「diagnostics」「issues」「compile check」「lint」「エラーチェック」「コンパイルチェック」「警告チェック」などのキーワードで自動適用。Xcode MCP 利用可能時はライブ診断、不可時は CLI フォールバック。
---
# iOS 診断（ios-check 後継 + MCP 診断）

プロジェクトのエラー・警告を高速にチェックする。

## ワークフロー

> **Codex CLI Note:** 以下の MCP セクションは Codex CLI では利用できません。CLI フォールバック手順を使用してください。

### Step 0: MCP 可用性チェック

```
XcodeListWindows を試行
  → 成功: MCP 診断を使用
  → 失敗: CLI フォールバック
```

### MCP 利用可能な場合

#### Xcode Issue Navigator のエラー・警告一覧
```
XcodeListNavigatorIssues を呼び出し
→ Xcode が認識している全エラー・警告を一覧表示
```

#### 特定ファイルのライブ診断
```
XcodeRefreshCodeIssuesInFile(filePath: "/path/to/File.swift") を呼び出し
→ そのファイルのリアルタイム診断結果を取得
```

### CLI フォールバック（MCP 利用不可の場合）

#### 1. プロジェクト検出
```bash
# xcworkspace（.xcodeproj/project.xcworkspace は除外）
find . -maxdepth 2 -name "*.xcworkspace" -type d | grep -v ".xcodeproj/project.xcworkspace"
# xcodeproj
find . -maxdepth 2 -name "*.xcodeproj" -type d
```

#### 2. 高速スキーム検出
ワークスペース/プロジェクト名から推測。`xcodebuild -list` は最終手段。

#### 3. コンパイルチェック
```bash
xcodebuild \
  -workspace <name>.xcworkspace \
  -scheme <scheme> \
  -destination "platform=iOS Simulator,id=<id>" \
  -skipMacroValidation \
  -skipPackagePluginValidation \
  -skipPackageUpdates \
  build 2>&1 | grep -E "(error:|warning:)" | head -50
```

#### SPM プロジェクト
```bash
swift build 2>&1 | grep -E "(error:|warning:)"
```

## 出力フォーマット

```
## 診断結果

### エラー (N件)
<file>:<line>: error: <message>

### 警告 (N件)
<file>:<line>: warning: <message>

### 修正提案
<recommendations>
```

エラー・警告がない場合:
```
## 診断結果: 問題なし ✓
```