跨平臺(tái)功能開發(fā)編排器基于 multi-platform-apps 插件的三階段多 Agent 工作流實(shí)戰(zhàn)指南【免費(fèi)下載鏈接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity項(xiàng)目地址: https://gitcode.com/GitHub_Trending/agents24/agents導(dǎo)讀本文剖析 GitHub 推薦項(xiàng)目精選 / agents24 / agents 倉庫中multi-platform-apps插件提供的一等公民能力——multi-platform斜杠命令。它是一個(gè)面向一次設(shè)計(jì)、多端交付的跨平臺(tái)功能開發(fā)編排器以 API-first 為綱先在架構(gòu)與 API 契約層對(duì)齊再并行推進(jìn) Web、iOS、Android、桌面端實(shí)現(xiàn)最后完成文檔、測(cè)試與優(yōu)化閉環(huán)。讀完本文你將掌握該命令的完整執(zhí)行協(xié)議3 個(gè)階段、7 個(gè)步驟、2 個(gè)強(qiáng)制檢查點(diǎn)、.multi-platform/狀態(tài)機(jī)工作機(jī)制、每個(gè)步驟調(diào)用的 Agent 職責(zé)以及如何將該工作流接入 Claude Code / Codex / Cursor / OpenCode 等多 harness 環(huán)境。一、命令定位與使用方式1.1 命令在插件體系中的位置multi-platform命令位于 plugins/multi-platform-apps/commands/multi-platform.md是該插件唯一的命令文件。它與插件目錄下的 6 個(gè)專業(yè) Agent 協(xié)同工作Agent 文件角色在多平臺(tái)工作流中的職責(zé)backend-architect.md后端架構(gòu)師Phase 1 Step 1API 契約與共享數(shù)據(jù)模型設(shè)計(jì)ui-ux-designer.mdUI/UX 設(shè)計(jì)師Phase 1 Step 2跨平臺(tái)設(shè)計(jì)系統(tǒng)與組件規(guī)范frontend-developer.md前端工程師Phase 2 Step 4a/4dWeb 與桌面端實(shí)現(xiàn)ios-developer.mdiOS 工程師Phase 2 Step 4bSwiftUI 原生實(shí)現(xiàn)mobile-developer.md移動(dòng)端工程師Phase 2 Step 4cKotlin/Compose 實(shí)現(xiàn)flutter-expert.mdFlutter 專家可選的統(tǒng)一代碼庫評(píng)估方案按倉庫 docs/usage.md 的說明插件安裝后斜杠命令以/plugin-name:command-name [arguments]的命名空間形式調(diào)用/multi-platform-apps:multi-platform被歸類在Development Features命令參考中。1.2 參數(shù)簽名命令 frontmatter 給出了完整的參數(shù)提示argument-hint: feature description [--platforms web,ios,android,desktop] [--shared-code evaluate|kotlin-multiplatform|typescript]三個(gè)組成部分feature description功能描述即$ARGUMENTS中位于 flags 之前的部分全文統(tǒng)稱$FEATURE--platforms目標(biāo)平臺(tái)列表默認(rèn)web,ios,androiddesktop為可選追加平臺(tái)--shared-code共享代碼策略可選evaluate評(píng)估、kotlin-multiplatform、typescript默認(rèn)evaluate。典型調(diào)用示例/multi-platform-apps:multi-platform real-time order tracking --platforms web,ios,android,desktop --shared-code kotlin-multiplatform1.3 輸出目錄約定整個(gè)工作流的全部產(chǎn)物統(tǒng)一落在運(yùn)行目錄下的.multi-platform/文件夾中編號(hào)即執(zhí)行順序.multi-platform/ ├── 01-api-contracts.md # Step 1 API 契約 ├── 02-design-system.md # Step 2 設(shè)計(jì)系統(tǒng) ├── 03-shared-architecture.md# Step 3 共享業(yè)務(wù)邏輯架構(gòu) ├── 04a-web.md # Step 4a Web 實(shí)現(xiàn) ├── 04b-ios.md # Step 4b iOS 實(shí)現(xiàn)按需 ├── 04c-android.md # Step 4c Android 實(shí)現(xiàn)按需 ├── 04d-desktop.md # Step 4d 桌面端實(shí)現(xiàn)按需 ├── 05-api-docs.md # Step 5 API 文檔與測(cè)試 ├── 06-testing.md # Step 6 跨平臺(tái)一致性測(cè)試 ├── 07-optimizations.md # Step 7 平臺(tái)級(jí)優(yōu)化 └── state.json # 會(huì)話狀態(tài)機(jī)這一設(shè)計(jì)背后是文件即記憶的原則每個(gè)步驟必須先落盤再進(jìn)入下一步后續(xù)步驟從文件讀取前序產(chǎn)物而不是依賴上下文窗口記憶——保證了長流程中信息不丟失也支持中途斷電后恢復(fù)。二、不可違反的行為鐵律命令開篇以 CRITICAL BEHAVIORAL RULES 明示 6 條硬性規(guī)則任何違反都視為執(zhí)行失敗嚴(yán)格按順序執(zhí)行不得跳過、重排或合并步驟先寫文件再繼續(xù)每一步必須在.multi-platform/下產(chǎn)出對(duì)應(yīng)文件后才能進(jìn)入下一步且只能從先前步驟的文件讀取信息在檢查點(diǎn)強(qiáng)制停下到達(dá)PHASE CHECKPOINT時(shí)必須用 AskUserQuestion 工具給出清晰選項(xiàng)并等待用戶明確批準(zhǔn)失敗即停機(jī)任一步驟失敗Agent 報(bào)錯(cuò)、測(cè)試失敗、依賴缺失必須立即停止向用戶展示錯(cuò)誤并詢問處理方式不得靜默繼續(xù)僅使用本地 Agent所有subagent_type只引用本插件內(nèi)置 Agent 或general-purpose不允許跨插件依賴禁止自主進(jìn)入 Plan 模式不得調(diào)用 EnterPlanMode——這條命令本身就是計(jì)劃直接執(zhí)行。這 6 條規(guī)則把可控性提到了與完成度同等的高度本質(zhì)是把一次不可逆的大規(guī)模開發(fā)拆解為可審查、可回滾、可恢復(fù)的確定性流水線。三、Pre-flight Checks會(huì)話恢復(fù)與狀態(tài)初始化3.1 已有會(huì)話檢查執(zhí)行前先檢查.multi-platform/state.json是否存在存在且status: in_progress讀取狀態(tài)展示當(dāng)前步驟向用戶二選一Found an in-progress multi-platform development session: Feature: [name from state] Current step: [step from state] 1. Resume from where we left off 2. Start fresh (archives existing session)存在且status: complete詢問是否歸檔后重新開始。這一機(jī)制讓中斷的工作流具備真正的可恢復(fù)性——所有進(jìn)度都持久化在state.json而非模型上下文。3.2 狀態(tài)機(jī)初始化創(chuàng)建.multi-platform/目錄與state.json初始模板如下{ feature: $ARGUMENTS, status: in_progress, platforms: [web, ios, android], shared_code: evaluate, current_step: 1, current_phase: 1, completed_steps: [], files_created: [], started_at: ISO_TIMESTAMP, last_updated: ISO_TIMESTAMP }隨后解析$ARGUMENTS中的--platforms與--shared-code兩個(gè) flag未指定時(shí)使用上述默認(rèn)值并從$ARGUMENTS中提取 flag 之前的文本作為$FEATURE。狀態(tài)機(jī)的字段演進(jìn)規(guī)律每個(gè)步驟完成后current_step遞增Step 3 完成后置為checkpoint-1Step 4 完成后置為checkpoint-2已完成的步驟號(hào)追加進(jìn)completed_steps全部完成后status置為complete并刷新last_updated。checkpoint-*字符串值實(shí)際上充當(dāng)了等待人工批準(zhǔn)的暫停標(biāo)志。四、Phase 1架構(gòu)與 API 設(shè)計(jì)Steps 1–3串行Phase 1 的定位是先對(duì)齊再動(dòng)手用一份 API 契約、一份設(shè)計(jì)系統(tǒng)、一份共享架構(gòu)文檔鎖定三端或多端實(shí)現(xiàn)的事實(shí)基礎(chǔ)。Step 1功能需求與 API 契約調(diào)用 Task 工具啟動(dòng)multi-platform-apps-backend-architect對(duì)應(yīng) backend-architect.md產(chǎn)出 OpenAPI 3.1 規(guī)范要求覆蓋使用正確 HTTP 方法與狀態(tài)碼的 RESTful 端點(diǎn)復(fù)雜數(shù)據(jù)查詢場(chǎng)景下的 GraphQL schema實(shí)時(shí)功能所需的 WebSocket 事件帶校驗(yàn)規(guī)則的請(qǐng)求/響應(yīng) schema認(rèn)證與授權(quán)要求限流rate limiting與緩存策略錯(cuò)誤響應(yīng)格式與錯(cuò)誤碼。同時(shí)要求定義所有平臺(tái)共同消費(fèi)的共享數(shù)據(jù)模型交付物包括完整 API 規(guī)范、共享數(shù)據(jù)模型、認(rèn)證流程設(shè)計(jì)、各平臺(tái)集成指南。從 backend-architect.md 的源碼可見該 Agent 的能力矩陣橫跨 REST/GraphQL/gRPC/WebSocket/SSE/Webhook、API 版本化與分頁策略、契約測(cè)試Pact 等、SDK 生成其核心行為特征是contract-first清晰定義接口邊界從第一天就內(nèi)建熔斷、重試、超時(shí)等韌性模式——與 Step 1 的要求完全吻合。產(chǎn)出保存為.multi-platform/01-api-contracts.md隨后更新state.jsoncurrent_step置 2Step 1 加入completed_steps。Step 2設(shè)計(jì)系統(tǒng)與 UI/UX 一致性讀取01-api-contracts.md調(diào)用ui-ux-designer對(duì)應(yīng) ui-ux-designer.md要求交付跨平臺(tái)設(shè)計(jì)系統(tǒng)各平臺(tái)組件規(guī)范Material Design、iOS HIG、FluentWeb 響應(yīng)式布局移動(dòng)優(yōu)先iOS 原生模式SwiftUI與 Android 原生模式Material You桌面端專項(xiàng)考量鍵盤快捷鍵、窗口管理可訪問性要求WCAG 2.2 Level AA深色/淺色主題規(guī)范動(dòng)畫與轉(zhuǎn)場(chǎng)指南。從 Agent 源碼看ui-ux-designer.md 具備原子設(shè)計(jì)方法論、design token 管理、Figma Variables/Style Dictionary、多品牌設(shè)計(jì)系統(tǒng)治理等能力其行為特征是系統(tǒng)性、可擴(kuò)展的設(shè)計(jì)方案而非一次性設(shè)計(jì)并用研究與測(cè)試數(shù)據(jù)驗(yàn)證設(shè)計(jì)決策。注意該 Agent 的 frontmatter 指定了model: sonnet屬于模型分層中的 Tier 3文檔、測(cè)試、調(diào)試類任務(wù)——詳見倉庫 ARCHITECTURE.md 的模型分層表。產(chǎn)出保存為.multi-platform/02-design-system.md。Step 3共享業(yè)務(wù)邏輯架構(gòu)同時(shí)讀取01-api-contracts.md與02-design-system.md調(diào)用general-purposeAgent 完成共享代碼架構(gòu)設(shè)計(jì)需定義核心領(lǐng)域模型與實(shí)體平臺(tái)無關(guān)業(yè)務(wù)規(guī)則與校驗(yàn)邏輯狀態(tài)管理模式MVI/Redux/BLoC緩存與離線策略錯(cuò)誤處理與重試策略平臺(tái)特定適配器模式。同時(shí)要求考慮共享方案選型移動(dòng)端用 Kotlin MultiplatformWeb/桌面用 TypeScript。交付物為共享代碼架構(gòu)文檔、平臺(tái)抽象層設(shè)計(jì)、狀態(tài)管理策略、離線/緩存方案與實(shí)施指南。產(chǎn)出保存為.multi-platform/03-shared-architecture.mdcurrent_step置為checkpoint-1。五、PHASE CHECKPOINT 1首次人工審查此處必須強(qiáng)制停下向用戶展示三份文檔的核心要點(diǎn)關(guān)鍵 API 端點(diǎn)、設(shè)計(jì)系統(tǒng)組件、共享邏輯方案并給出三選一Architecture and API design complete. Please review: - .multi-platform/01-api-contracts.md - .multi-platform/02-design-system.md - .multi-platform/03-shared-architecture.md 1. Approve — proceed to platform implementation 2. Request changes — tell me what to adjust 3. Pause — save progress and stop here只有用戶選擇選項(xiàng) 1 才能進(jìn)入 Phase 2選 2 則修訂后重新走檢查點(diǎn)選 3 則更新state.json狀態(tài)并停止。這是架構(gòu)先行理念的人機(jī)閉環(huán)——在投入并行開發(fā)之前先用人類判斷鎖死方向。六、Phase 2并行平臺(tái)實(shí)現(xiàn)Steps 4a–4d先讀取 Phase 1 的三份產(chǎn)物隨后僅針對(duì)state.json中列出的平臺(tái)用多個(gè) Task 調(diào)用并行發(fā)起實(shí)現(xiàn)任務(wù)。Step 4aWeb 實(shí)現(xiàn)React/Next.js調(diào)用multi-platform-apps-frontend-developer技術(shù)棧約定React 18 與 Next.js 14 App RouterTypeScript 類型安全TanStack Query 做 API 集成Zustand/Redux Toolkit 狀態(tài)管理Tailwind CSS 配合設(shè)計(jì)系統(tǒng) tokensPWA 能力按需 SSR/SSG 優(yōu)化Web Vitals 優(yōu)化LCP 2.5s、FID 100ms。對(duì)應(yīng) Agent frontend-developer.md 的能力覆蓋 React 19、Next.js 15、RSC、Server Actions、ISR、Core Web Vitals 與無障礙實(shí)現(xiàn)其行為特征是用戶體驗(yàn)與性能同等優(yōu)先從設(shè)計(jì)階段就考慮可訪問性。產(chǎn)出存為.multi-platform/04a-web.md。Step 4biOS 實(shí)現(xiàn)SwiftUI調(diào)用ios-developer約定SwiftUI iOS 17 特性Swift 5.9 與 async/awaitURLSession Combine 集成 APICore Data/SwiftData 持久化平臺(tái)特性Face ID、Haptics、Live Activities可測(cè)試的 MVVM 架構(gòu)。對(duì)應(yīng) Agent ios-developer.md 覆蓋 Swift 6、SwiftUI 5、UIKit 互操作、Core Data/CloudKit、App Store 合規(guī)與 ASO行為特征是嚴(yán)格遵循 Apple HIG編譯期安全優(yōu)先。產(chǎn)出存為.multi-platform/04b-ios.md。Step 4cAndroid 實(shí)現(xiàn)Kotlin/Compose調(diào)用multi-platform-apps-mobile-developer約定Jetpack Compose Material 3Kotlin coroutines 與 FlowRetrofit/Ktor 集成 APIRoom 本地?cái)?shù)據(jù)庫Hilt 依賴注入Material You 動(dòng)態(tài)主題平臺(tái)特性生物認(rèn)證、widgetsClean Architecture MVI。對(duì)應(yīng) Agent mobile-developer.md 的能力覆蓋 React Native / Flutter / 原生多路線Step 4c 中它扮演的是 Android 原生專家角色。產(chǎn)出存為.multi-platform/04c-android.md。Step 4d桌面端實(shí)現(xiàn)可選Electron/Tauri僅當(dāng)desktop出現(xiàn)在 platforms 列表時(shí)執(zhí)行仍調(diào)用multi-platform-apps-frontend-developer要求 Tauri 2.0 或 Electron并注入 Web 實(shí)現(xiàn)產(chǎn)物以最大化復(fù)用同時(shí)補(bǔ)充原生 OS 集成系統(tǒng)托盤、通知按需文件系統(tǒng)訪問自動(dòng)更新代碼簽名與公證配置鍵盤快捷鍵與菜單欄多窗口支持。產(chǎn)出存為.multi-platform/04d-desktop.md。全部平臺(tái)任務(wù)完成后current_step置為checkpoint-2。值得留意的是倉庫還內(nèi)置了 flutter-expert.md 這一統(tǒng)一代碼庫方案專家Flutter 3.x 覆蓋移動(dòng)/Web/桌面/嵌入式支持 Material 3 與 Cupertino 雙設(shè)計(jì)系統(tǒng)當(dāng)--shared-code評(píng)估結(jié)論偏向單代碼庫策略時(shí)它是 Step 3 架構(gòu)選型的自然備選。七、PHASE CHECKPOINT 2二次人工審查展示全部平臺(tái)實(shí)現(xiàn)摘要再次給出批準(zhǔn)/變更/暫停三選一未批準(zhǔn)不得進(jìn)入 Phase 3Platform implementations complete. Please review: - .multi-platform/04a-web.md - .multi-platform/04b-ios.md (if applicable) - .multi-platform/04c-android.md (if applicable) - .multi-platform/04d-desktop.md (if applicable) 1. Approve — proceed to integration and validation 2. Request changes — tell me what to adjust 3. Pause — save progress and stop here八、Phase 3集成與驗(yàn)證Steps 5–7Step 5API 文檔與測(cè)試讀取01-api-contracts.md與全部04*.md調(diào)用general-purpose技術(shù)寫作專家產(chǎn)出交互式 OpenAPI/Swagger 文檔各平臺(tái)集成指南各平臺(tái) SDK 示例認(rèn)證流程圖示限流與配額信息錯(cuò)誤處理最佳實(shí)踐API 版本化策略。并要求用平臺(tái)實(shí)現(xiàn)實(shí)測(cè)全部端點(diǎn)。產(chǎn)出存為.multi-platform/05-api-docs.md。Step 6跨平臺(tái)測(cè)試與功能一致性讀取全部04*.md與05-api-docs.md調(diào)用general-purposeQA 工程師驗(yàn)證功能測(cè)試矩陣各平臺(tái)行為一致UI 一致性核驗(yàn)遵循設(shè)計(jì)系統(tǒng)各平臺(tái)性能基準(zhǔn)可訪問性測(cè)試平臺(tái)專用工具網(wǎng)絡(luò)韌性測(cè)試離線、弱網(wǎng)數(shù)據(jù)同步校驗(yàn)平臺(tái)特定邊界場(chǎng)景端到端用戶旅程測(cè)試。交付功能一致性矩陣、各平臺(tái)測(cè)試結(jié)果、性能基準(zhǔn)、發(fā)現(xiàn)的平臺(tái)偏差與修復(fù)建議存為.multi-platform/06-testing.md。Step 7平臺(tái)專項(xiàng)優(yōu)化讀取06-testing.md與全部04*.md調(diào)用general-purpose性能工程師按平臺(tái)逐項(xiàng)優(yōu)化Web包體積、懶加載、CDN、SEOiOSApp 體積、啟動(dòng)時(shí)間、內(nèi)存、電量AndroidAPK 體積、啟動(dòng)時(shí)間、幀率、電量Desktop二進(jìn)制體積、資源占用、啟動(dòng)時(shí)間API響應(yīng)時(shí)間、緩存、壓縮。要求在維持功能一致性的前提下發(fā)揮平臺(tái)優(yōu)勢(shì)并記錄優(yōu)化技術(shù)與取舍。產(chǎn)出存為.multi-platform/07-optimizations.mdcurrent_step置為complete。九、完成與驗(yàn)收標(biāo)準(zhǔn)最后將state.json的status置為complete并刷新last_updated呈現(xiàn)最終摘要。命令內(nèi)置的 Success Criteria 可作為團(tuán)隊(duì)驗(yàn)收清單API 契約在實(shí)現(xiàn)前已定義并驗(yàn)證所有平臺(tái)達(dá)成功能一致差異 5%性能指標(biāo)滿足各平臺(tái)標(biāo)準(zhǔn)可訪問性達(dá)標(biāo)WCAG 2.2 AA 為最低要求跨平臺(tái)測(cè)試顯示行為一致所有平臺(tái)文檔完整適用場(chǎng)景下平臺(tái)間代碼復(fù)用率 40%。后續(xù)動(dòng)作建議逐平臺(tái)審查生成的代碼與文檔 → 運(yùn)行平臺(tái)專用測(cè)試套件 → 按平臺(tái)創(chuàng)建 PR → 用平臺(tái)專用流水線部署 → 上線后監(jiān)控跨平臺(tái)指標(biāo)。十、設(shè)計(jì)原理與最佳實(shí)踐總結(jié)10.1 與倉庫架構(gòu)規(guī)范的呼應(yīng)從 ARCHITECTURE.md 可以確認(rèn)本命令遵循倉庫的兩條核心約定一是插件為安裝單元命令/Agent/技能隨插件整體安裝/plugin install multi-platform-apps后即可使用二是源內(nèi)容可移植命令文件以純 Markdown 編寫由tools/adapters/下的適配器在生成期映射到各 harness 的原生格式如 Codex 的 TOML、OpenCode 的 command 目錄、Copilot 的 commands-as-skills、Antigravity 的插件格式因此本文描述的工作流在多個(gè) harness 中均可運(yùn)行只是調(diào)用語法隨平臺(tái)略有差異。10.2 可借鑒的三條工程實(shí)踐文件即狀態(tài)用state.json 編號(hào) markdown 產(chǎn)物替代上下文記憶使長流程可恢復(fù)、可審計(jì)、可中斷續(xù)跑人機(jī)檢查點(diǎn)兩個(gè)強(qiáng)制 PHASE CHECKPOINT 把大規(guī)模并行開發(fā)拆成架構(gòu)批準(zhǔn) → 實(shí)現(xiàn)批準(zhǔn) → 集成驗(yàn)證三個(gè)可逆階段把返工成本前置到最低點(diǎn)契約先行 并行收斂先鎖定 API 契約與設(shè)計(jì)系統(tǒng)再并行實(shí)現(xiàn)多端最后用一致性矩陣與性能優(yōu)化收口——這正是跨平臺(tái)交付減少返工、提高復(fù)用的關(guān)鍵路徑。10.3 使用前提與限制本命令依賴插件內(nèi)置的 6 個(gè) Agent 與general-purpose需保證所在 harness 支持 Task/subagent 機(jī)制產(chǎn)物目錄.multi-platform/為運(yùn)行時(shí)生成命令本身不修改倉庫內(nèi)容生成的代碼與文檔由用戶決定如何提交--platforms中列出的平臺(tái)會(huì)決定 4a–4d 的執(zhí)行分支--shared-code的三種取值會(huì)影響 Step 3 的架構(gòu)選型方向建議在調(diào)用前明確兩者。相關(guān)文件速查命令定義 multi-platform.md Agent 組 backend-architect.md、ui-ux-designer.md、frontend-developer.md、ios-developer.md、mobile-developer.md、flutter-expert.md 使用手冊(cè) docs/usage.md 架構(gòu)規(guī)范 ARCHITECTURE.md【免費(fèi)下載鏈接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity項(xiàng)目地址: https://gitcode.com/GitHub_Trending/agents24/agents創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考