Xcode MCP उपयोग दिशानिर्देश

--- name: xcode-mcp description: कुशल Xcode MCP टूल उपयोग के लिए दिशानिर्देश। यह कौशल यह समझने के लिए उपयोग किया जाना चाहिए कि Xcode MCP टूल का उपयोग कब करें बनाम मानक टूल का। Xcode MCP बहुत सारे टोकन खपत करता है - केवल build, test, simulator, preview, और SourceKit diagnostics के लिए उपयोग करें। फ़ाइल read/write/grep ऑपरेशन के लिए कभी उपयोग न करें। --- # Xcode MCP उपयोग दिशानिर्देश Xcode MCP टूल महत्वपूर्ण टोकन खपत करते हैं। यह कौशल परिभाषित करता है कि Xcode MCP का उपयोग कब करें और मानक टूल को कब प्राथमिकता दें। ## संपूर्ण Xcode MCP टूल संदर्भ ### विंडो और प्रोजेक्ट प्रबंधन | टूल | विवरण | टोकन लागत | |------|-------------|------------| | `mcp__xcode__XcodeListWindows` | खुली Xcode विंडो सूचीबद्ध करें (tabIdentifier प्राप्त करें) | कम | ### बिल्ड ऑपरेशन | टूल | विवरण | टोकन लागत | |------|-------------|------------| | `mcp__xcode__BuildProject` | Xcode प्रोजेक्ट बनाएं | मध्यम | | `mcp__xcode__GetBuildLog` | त्रुटियों/चेतावनियों के साथ बिल्ड लॉग प्राप्त करें | मध्यम | | `mcp__xcode__XcodeListNavigatorIssues` | Issue Navigator में समस्याएं सूचीबद्ध करें | कम | ### परीक्षण | टूल | विवरण | टोकन लागत | |------|-------------|------------| | `mcp__xcode__GetTestList` | परीक्षण योजना से उपलब्ध परीक्षण प्राप्त करें | कम | | `mcp__xcode__RunAllTests` | सभी परीक्षण चलाएं | मध्यम | | `mcp__xcode__RunSomeTests` | विशिष्ट परीक्षण चलाएं (पसंदीदा) | मध्यम | ### पूर्वावलोकन और निष्पादन | टूल | विवरण | टोकन लागत | |------|-------------|------------| | `mcp__xcode__RenderPreview` | SwiftUI पूर्वावलोकन स्नैपशॉट प्रस्तुत करें | मध्यम | | `mcp__xcode__ExecuteSnippet` | फ़ाइल संदर्भ में कोड स्निपेट निष्पादित करें | मध्यम | ### निदान | टूल | विवरण | टोकन लागत | |------|-------------|------------| | `mcp__xcode__XcodeRefreshCodeIssuesInFile` | विशिष्ट फ़ाइल के लिए कंपाइलर निदान प्राप्त करें | कम | | `mcp__ide__getDiagnostics` | SourceKit निदान प्राप्त करें (सभी खुली फ़ाइलें) | कम | ### दस्तावेज़ीकरण | टूल | विवरण | टोकन लागत | |------|-------------|------------| | `mcp__xcode__DocumentationSearch` | Apple Developer Documentation खोजें | कम | ### फ़ाइल ऑपरेशन (उच्च टोकन - कभी उपयोग न करें) | टूल | विकल्प | कारण | |------|-------------|-----| | `mcp__xcode__XcodeRead` | `Read` टूल | उच्च टोकन खपत | | `mcp__xcode__XcodeWrite` | `Write` टूल | उच्च टोकन खपत | | `mcp__xcode__XcodeUpdate` | `Edit` टूल | उच्च टोकन खपत | | `mcp__xcode__XcodeGrep` | `rg` / `Grep` टूल | उच्च टोकन खपत | | `mcp__xcode__XcodeGlob` | `Glob` टूल | उच्च टोकन खपत | | `mcp__xcode__XcodeLS` | `ls` कमांड | उच्च टोकन खपत | | `mcp__xcode__XcodeRM` | `rm` कमांड | उच्च टोकन खपत | | `mcp__xcode__XcodeMakeDir` | `mkdir` कमांड | उच्च टोकन खपत | | `mcp__xcode__XcodeMV` | `mv` कमांड | उच्च टोकन खपत | --- ## अनुशंसित कार्यप्रवाह ### 1. कोड परिवर्तन और बिल्ड प्रवाह ``` 1. कोड खोजें -> rg "pattern" --type swift 2. फ़ाइल पढ़ें -> Read टूल 3. फ़ाइल संपादित करें -> Edit टूल 4. सिंटैक्स जांच -> mcp__ide__getDiagnostics 5. बिल्ड करें -> mcp__xcode__BuildProject 6. त्रुटियां जांचें -> mcp__xcode__GetBuildLog (यदि बिल्ड विफल हो) ``` ### 2. परीक्षण लेखन और चलाने का प्रवाह ``` 1. परीक्षण फ़ाइल पढ़ें -> Read टूल 2. परीक्षण लिखें/संपादित करें -> Edit टूल 3. परीक्षण सूची प्राप्त करें -> mcp__xcode__GetTestList 4. परीक्षण चलाएं -> mcp__xcode__RunSomeTests (विशिष्ट परीक्षण) 5. परिणाम जांचें -> परीक्षण आउटपुट की समीक्षा करें ``` ### 3. SwiftUI पूर्वावलोकन प्रवाह ``` 1. दृश्य संपादित करें -> Edit टूल 2. पूर्वावलोकन प्रस्तुत करें -> mcp__xcode__RenderPreview 3. पुनरावृत्ति करें -> आवश्यकता अनुसार दोहराएं ``` ### 4. डीबग प्रवाह ``` 1. निदान जांचें -> mcp__ide__getDiagnostics (त्वरित सिंटैक्स जांच) 2. प्रोजेक्ट बनाएं -> mcp__xcode__BuildProject 3. बिल्ड लॉग प्राप्त करें -> mcp__xcode__GetBuildLog (गंभीरता: त्रुटि) 4. समस्याएं ठीक करें -> Edit टूल 5. पुनः बिल्ड करें -> mcp__xcode__BuildProject ``` ### 5. दस्तावेज़ीकरण खोज ``` 1. दस्तावेज़ खोजें -> mcp__xcode__DocumentationSearch 2. परिणाम समीक्षा करें -> कार्यान्वयन में जानकारी का उपयोग करें ``` --- ## फॉलबैक कमांड (जब MCP अनुपलब्ध हो) यदि Xcode MCP डिस्कनेक्ट है या अनुपलब्ध है, तो इन xcodebuild कमांड का उपयोग करें: ### बिल्ड कमांड ```bash # डीबग बिल्ड (सिम्युलेटर) - <SchemeName> को अपने प्रोजेक्ट के स्कीम से बदलें xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # रिलीज़ बिल्ड (डिवाइस) xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # वर्कस्पेस के साथ बिल्ड करें (CocoaPods प्रोजेक्ट के लिए) xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # प्रोजेक्ट फ़ाइल के साथ बिल्ड करें xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # उपलब्ध स्कीम सूचीबद्ध करें xcodebuild -list ``` ### परीक्षण कमांड ```bash # सभी परीक्षण चलाएं xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # विशिष्ट परीक्षण क्लास चलाएं xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # विशिष्ट परीक्षण विधि चलाएं xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # कोड कवरेज के साथ चलाएं xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # उपलब्ध सिम्युलेटर सूचीबद्ध करें xcrun simctl list devices available ``` ### क्लीन बिल्ड ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## त्वरित संदर्भ ### Xcode MCP का उपयोग करें: - `BuildProject` - बिल्डिंग - `GetBuildLog` - बिल्ड त्रुटियां - `RunSomeTests` - विशिष्ट परीक्षण चलाना - `GetTestList` - परीक्षण सूचीबद्ध करना - `RenderPreview` - SwiftUI पूर्वावलोकन - `ExecuteSnippet` - कोड निष्पादन - `DocumentationSearch` - Apple दस्तावेज़ - `XcodeListWindows` - tabIdentifier प्राप्त करना - `mcp__ide__getDiagnostics` - SourceKit त्रुटियां ### Xcode MCP का कभी उपयोग न करें: - `XcodeRead` -> `Read` टूल का उपयोग करें - `XcodeWrite` -> `Write` टूल का उपयोग करें - `XcodeUpdate` -> `Edit` टूल का उपयोग करें - `XcodeGrep` -> `rg` या `Grep` टूल का उपयोग करें - `XcodeGlob` -> `Glob` टूल का उपयोग करें - `XcodeLS` -> `ls` कमांड का उपयोग करें - `XcodeRM` -> `rm` कमांड का उपयोग करें - `XcodeMakeDir` -> `mkdir` कमांड का उपयोग करें - `XcodeMV` -> `mv` कमांड का उपयोग करें - फ़ाइल ऑपरेशन -> मानक टूल का उपयोग करें --- ## टोकन दक्षता सारांश | ऑपरेशन | सर्वोत्तम विकल्प | टोकन प्रभाव | |-----------|-------------|--------------| | त्वरित सिंटैक्स जांच | `mcp__ide__getDiagnostics` | कम | | पूर्ण बिल्ड | `mcp__xcode__BuildProject` | मध्यम | | विशिष्ट परीक्षण चलाएं | `mcp__xcode__RunSomeTests` | मध्यम | | सभी परीक्षण चलाएं | `mcp__xcode__RunAllTests` | उच्च | | फ़ाइल पढ़ें | `Read` टूल | उच्च | | फ़ाइल संपादित करें | `Edit` टूल | उच्च | | कोड खोजें | `rg` / `Grep` | कम | | फ़ाइलें सूचीबद्ध करें | `ls` / `Glob` | कम |