ruflo 移动端 Agent 实战用 Claude Flow V3 定义 React Native 跨平台开发专家spec-mobile-react-native 全解析【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo本文以 spec-mobile-react-native.md 为蓝本系统拆解 Claude Flow V3 中mobile-dev这一 specialized 类型 Agent 的完整定义文件从前置元数据、触发机制、工具权限、路径约束、生命周期钩子到提示词正文逐段讲解每个字段的作用与取值含义并结合仓库中.claude/agents/目录的初始化与迁移源码说明这类 Agent 是如何被安装、识别和调度的。读完本文你将能够独立读懂乃至编写一个面向 iOS/Android 双端的 React Native 开发 Agent 定义并理解它在整个 Agent 体系中的定位。一、文档定位一份完整的移动端 Agent 定义在 Claude Flow V3 中Agent 通过v3/claude-flow/cli/.claude/agents/目录下的 Markdown 文件进行声明式定义每个文件由一段 YAML frontmatter声明触发条件、能力、约束、钩子等结构化元数据与一段 Markdown 提示词正文描述 Agent 的角色、职责与行为规范组成。spec-mobile-react-native.md即属于其中的specialized专项专家类型其仓库内存在两份一份位于 v3/claude-flow/cli/.claude/agents/specialized/mobile/spec-mobile-react-native.md带mobile子分类目录另一份位于 v3/claude-flow/cli/.claude/agents/specialized/spec-mobile-react-native.mdspecialized 根目录。两份内容一致均声明了 Agent 名mobile-devExpert agent for React Native mobile application development across iOS and Android、类型specialized、版本1.0.0、创建日期2025-07-25并带有color: teal的视觉标识。在 agent-types.md 的 87 种 Agent 类型清单中spec-mobile-react-native被明确列入Specialized1分类最佳用途标注为 Mobile development移动开发。这说明它是该体系下移动端专项能力的唯一代表与核心开发coder/reviewer/tester、V3 专项security-architect 等、Swarm 协调等类型并列。从源码结构看.claude/agents/是一个「分类/子分类/名称.md」的浅层树如 migrate-agent-detection.ts 所述path.join(cwd, .claude, agents)下按分类查找 Agent 文件specialized/mobile/即属于「分类specialized 子分类mobile」的目录层级。二、触发机制Agent 何时被选中triggers字段决定了mobile-dev在何种输入下被激活包含四类匹配规则触发维度配置值说明keywordsreact native、mobile app、ios app、android app、expo、native module用户消息中命中任一关键词即触发file_patterns**/*.jsx、**/*.tsx、**/App.js、**/ios/**/*.m、**/android/**/*.java、app.json工作区文件结构命中即触发task_patternscreate * mobile app、build * screen、implement * native module任务描述句式匹配domainsmobile、react-native、cross-platform领域标签归属这套设计覆盖了「对话意图 项目文件 任务句式 领域」四个维度无论用户说帮我做一个 iOS app还是仓库里出现了.tsx文件或任务描述含 implement * native module都会命中该 Agent。expo关键词与app.json文件模式配合可识别 Expo 托管的 RN 工程**/ios/**/*.m与**/android/**/*.java则用于捕捉原生代码改动。三、能力边界工具白名单与资源配额capabilities字段是 Agent 的行为权限核心mobile-dev的配置如下capabilities: allowed_tools: - Read - Write - Edit - MultiEdit - Bash - Grep - Glob restricted_tools: - WebSearch - Task # Focus on implementation max_file_operations: 100 max_execution_time: 600 memory_access: bothallowed_tools工具白名单放行 7 种工具覆盖读代码Read/Grep/Glob— 改代码Write/Edit/MultiEdit— 执行命令Bash的完整开发闭环restricted_tools工具黑名单禁用WebSearch与Task。注释 # Focus on implementation 明确意图——该 Agent 被设计为专注本地实现、不联网检索、不委派子任务资源配额max_file_operations: 100限制单次会话最大文件操作数max_execution_time: 600秒限制最长执行时长memory_access: both表示可读写短期与长期记忆。这种「白名单放行 黑名单禁用 配额兜底」的三层结构与 agent-capabilities.md 中描述的工具访问模式一脉相承如coder: Read, Write, Edit, MultiEdit, Glob, Grep, Bash是整个 Agent 体系统一遵循的能力约束范式。四、路径约束与文件类型安全边界的精细控制constraints字段将 Agent 的操作范围限定在移动端工程的可写区域constraints: allowed_paths: - src/** - app/** - components/** - screens/** - navigation/** - ios/** - android/** - assets/** forbidden_paths: - node_modules/** - .git/** - ios/build/** - android/build/** max_file_size: 5242880 # 5MB for assets allowed_file_types: - .js .jsx .ts .tsx .json - .m .h .java .kt值得关注的设计细节允许路径覆盖完整移动端拓扑src/app/components/screens/navigation对应 RN 应用层ios/**与android/**对应双端原生层assets/**允许处理静态资源禁止路径针对性地排除构建产物除通用的node_modules/**、.git/**外特别禁止ios/build/**与android/build/**——Xcode DerivedData 与 Gradle 构建输出不应被 Agent 直接修改大小上限 5MB注释 # 5MB for assets 说明该阈值是专门为资源文件图片、字体、媒体设定的防止 Agent 读取超大二进制文件类型白名单.m/.hObjective-C 原生、.java/.ktAndroid 原生、.js/.jsx/.ts/.tsxRN 逻辑层、.json配置——覆盖了跨平台开发涉及的全部语言面同时排除了.yaml、.md等与实现无关的类型。五、行为协议错误处理、确认点与自动回滚behavior字段定义了 Agent 的运行时行为约定behavior: error_handling: adaptive confirmation_required: - native module changes - platform-specific code - app permissions auto_rollback: true logging_level: debugadaptive 错误处理采用自适应策略即根据错误上下文动态调整修复路径而非一刀切的重试三个强制确认点native module changes原生模块改动、platform-specific code平台专属代码、app permissions应用权限——这三类改动对构建与上架影响面大Agent 必须征得用户确认后才能动手auto_rollback: true允许在失败时自动回滚改动降低破坏性操作风险debug 日志级别便于开发者追踪 Agent 的每一步决策。配套的communication字段则约定了输出风格技术化style: technical、批量更新update_frequency: batch、允许附带代码片段include_code_snippets: true、少用 emojiemoji_usage: minimal。六、协作与集成委派、上下文共享与优化参数integration与optimization字段描述了该 Agent 在多 Agent 体系中的协作关系integration: can_spawn: [] can_delegate_to: - test-unit - test-e2e requires_approval_from: [] shares_context_with: - dev-frontend - spec-mobile-ios - spec-mobile-android optimization: parallel_operations: true batch_size: 15 cache_results: true memory_limit: 1GBcan_spawn: []表示该 Agent 不主动派生子 Agentcan_delegate_to: [test-unit, test-e2e]表示可将单元测试、端到端测试任务委派给测试类 Agentshares_context_with声明了与前端开发 Agentdev-frontend、iOS 专项spec-mobile-ios、Android 专项spec-mobile-android共享上下文——注意后两个专项 Agent 在当前仓库中并未单独定义可以推断它们属于该体系规划中的移动端 Agent 家族成员mobile-dev是覆盖双端的聚合型角色优化参数并行操作、批大小 15、结果缓存、1GB 内存上限用于控制大规模文件操作时的资源消耗。七、生命周期钩子初始化、收尾与错误处理脚本hooks字段定义了 Agent 在执行前、执行后、出错时三段生命周期中要运行的 shell 脚本这也是全文最可运行的实操部分pre_execution执行前——环境探测echo React Native Developer initializing... echo Checking React Native setup... if [ -f package.json ]; then grep -E react-native|expo package.json | head -5 fi echo Detecting platform targets... [ -d ios ] echo iOS platform detected [ -d android ] echo Android platform detected [ -f app.json ] echo Expo project detected这段脚本实现了「工程类型判定」通过grep react-native|expo检查依赖通过ios/、android/目录是否存在判断原生工程通过app.json判断是否为 Expo 项目——一次探测即可确定后续的原生配置策略。post_execution执行后——结构盘点echo ✅ React Native development completed echo Project structure: find . -name *.js -o -name *.jsx -o -name *.tsx | grep -E (screens|components|navigation) | head -10 echo Remember to test on both platforms快速列出screens/components/navigation等核心目录下的源码文件并提醒双端都要测试。on_error出错时——三连修复命令echo ❌ React Native error: {{error_message}} echo Common fixes: echo - Clear metro cache: npx react-native start --reset-cache echo - Reinstall pods: cd ios pod install echo - Clean build: cd android ./gradlew clean注意{{error_message}}是错误信息模板变量三条修复命令分别针对 RN 开发中最常见的三类故障Metro 打包缓存、iOS CocoaPods 依赖、Android Gradle 构建。这组命令可直接作为 RN 开发者的排障速查表使用。八、提示词正文职责、最佳实践与组件模板frontmatter 之后是# React Native Mobile Developer提示词正文定义了角色的行为纲领五大核心职责开发 React Native 组件与页面Develop React Native components and screens实现导航与状态管理Implement navigation and state management处理平台专属代码与样式Handle platform-specific code and styling按需集成原生模块Integrate native modules when needed优化性能与内存使用Optimize performance and memory usage六条最佳实践使用函数组件与 Hooks、采用 React Navigation 导航、合理处理平台差异、优化图片与资源、在 iOS 与 Android 双端测试、遵循规范样式模式。组件模式示例原文完整保留是一个典型的函数式组件示范了本 Agent 期望的编码风格import React, { useState, useEffect } from react; import { View, Text, StyleSheet, Platform, TouchableOpacity } from react-native; const MyComponent ({ navigation }) { const [data, setData] useState(null); useEffect(() { // Component logic }, []); return ( View style{styles.container} Text style{styles.title}Title/Text TouchableOpacity style{styles.button} onPress{() navigation.navigate(NextScreen)} Text style{styles.buttonText}Continue/Text /TouchableOpacity /View ); }; const styles StyleSheet.create({ container: { flex: 1, padding: 16, backgroundColor: #fff, }, title: { fontSize: 24, fontWeight: bold, marginBottom: 20, ...Platform.select({ ios: { fontFamily: System }, android: { fontFamily: Roboto }, }), }, button: { backgroundColor: #007AFF, padding: 12, borderRadius: 8, }, buttonText: { color: #fff, fontSize: 16, textAlign: center, }, });这段代码包含了三处值得学习的平台适配手法Platform.select字体差异化iOS 用系统字体SystemAndroid 用Roboto同一 StyleSheet 对象内完成双端适配导航注入组件通过navigation.navigate(NextScreen)与 React Navigation 集成样式集中管理全部样式收敛在StyleSheet.create中保持渲染逻辑与样式分离。平台专属注意事项维度要点iOS安全区Safe areas、导航模式、权限管理Android返回键处理Back button handling、Material Design 规范性能长列表用FlatList、图片优化状态管理复杂应用使用 Context API 或 Redux九、配套示例触发与响应约定examples字段提供了两个端到端的行为样例用于校准 Agent 的响应预期触发输入预期响应create a login screen for React Native app创建包含表单校验、安全文本输入、双端导航集成的完整登录页implement push notifications in React Native使用 React Native Firebase 实现推送通知处理 iOS/Android 双端平台专属配置这两个示例界定了mobile-dev的能力下限不仅要写代码还要自带校验、安全、双端配置等工程化考量与 frontmatter 中confirmation_required: [app permissions]的设计形成呼应——推送通知恰好涉及应用权限会触发强制确认流程。十、Agent 如何进入你的工程初始化与调度机制理解了定义文件的全部字段后最后一个实操问题是这类 Agent 如何被安装到项目里仓库源码给出了清晰答案初始化复制在 executor.ts 中初始化流程会先确保目标项目存在.claude/agents目录然后遍历specialized等 agent 分类第 141 行附近定义了specialized: [specialized]分类映射将源目录下的 Agent 文件按分类复制到cwd/.claude/agents/category/并记录到result.created/result.addedAgents统计中组件开关init.ts 中options.components.agents对应初始化结果的 Agents: .claude/agents/ (N agents) 提示第 991 行将其作为默认勾选的初始化组件Agents, hint: Agent definitions in .claude/agents/识别约定Agent 文件统一存放于.claude/agents/浅层目录树分类/子分类/名称.md迁移与检测逻辑见 migrate-agent-detection.ts运行方式安装后可参考 agent-types.md 中的通用命令查看与唤起 Agent如npx claude-flow/clilatest agent spawn -t agent-type具体可用命令以当前 CLI 版本实际帮助输出为准。若想参考同目录下其他 Agent 的定义风格可对比阅读 dev-backend-api.mdbackend-devtype: development——它展示了一个 v2 能力的后端 Agent 定义与mobile-dev在 metadata、triggers、constraints 等字段上结构一致、取值不同可作为编写新 Agent 定义的对照模板。结语spec-mobile-react-native.md是一个结构完整、可直接投入使用的专项 Agent 定义它用 12 个 frontmatter 字段metadata / triggers / capabilities / constraints / behavior / communication / integration / optimization / hooks / examples 等将「React Native 跨平台开发专家」这一角色进行了声明式建模覆盖了触发、权限、约束、协作、排障的完整生命周期并用提示词正文固化了函数组件 React Navigation 平台适配 FlatList 优化等方法论。理解这份文件不仅意味着读懂了 Claude Flow V3 的 Agent 定义规范也为你编写自己的专项 Agent 提供了可复制的完整范式。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考