Development

对 HarmonyOS（鸿蒙）项目运行 DevEco Studio CodeLinter 静态代码检查，解读检查结果并提供修复建议。支持 ArkTS、TS、JS 文件，涵盖性能、安全、代码规范、正确性、跨设备适配、API 兼容性等规则集。当用户提到 codelinter、code linting、鸿蒙代码检查、鸿蒙应用质量、HarmonyOS 代码质量检查、静态代码分析、规范扫描、性能检查、安全扫描、代码审查、规则检查、lint 报告时使用。

覆盖鸿蒙/HarmonyOS/ArkTS 应用需求开发流程。在用户要落地新功能/新页面/新模块、PRD、端到端需求开发或鸿蒙应用开发时使用。不用于仅询问 API 语法用法、或未声明走完整链路的单文件 Bug 修复。用户意图模糊时先澄清是否需要端到端交付。

原生开发实施规划专家 - 基于跨端技术方案（tech-spec），生成端级细化实施计划，持久化到本地支持上下文恢复。 工作流程： 1. 上下文恢复：检测项目结构、已有计划和 tech-spec.md 2. 需求重述：引用 tech-spec 或独立分析（向后兼容） 3. 影响分析：有 tech-spec 时精简，聚焦当前端特有细节 4. 架构设计：有 tech-spec 时精简，聚焦端内实现架构 5. 变更流程：从 tech-spec 子任务出发，细化为端内文件级变更（保留端内流程图） 6. 分阶段拆解：按依赖关系拆分为可独立交付的阶段 7. 风险评估：有 tech-spec 时聚焦当前端特有风险 8. 等待确认：必须获得用户明确确认后才能开始编码 使用场景： - 有 tech-spec 时：基于跨端技术方案，细化单端实施计划 - 无 tech-spec 时：独立分析需求，生成完整实施计划（向后兼容） <example> user: "/native-plan 新增交易确认弹窗，iOS 端" assistant: "读取 tech-spec.md，基于跨端技术方案细化 iO...

原生开发编码实施专家 - 基于 tech-spec 和 plan 产物，按子任务依赖链自下而上编码，每个子任务完成后自动构建验证。 工作流程： 1. 上下文恢复：检查已有编码进度和 plan-{platform}.md 2. 依赖分析：解析子任务依赖 DAG，拓扑排序生成自下而上执行顺序 3. 知识库加载：加载平台规范、架构文档、项目知识库 4. 逐子任务编码：读取上下文 → 脑暴新增设计 → 编码实施 → 构建验证 → 记录进度 5. 完成总结：输出变更文件清单、脑暴决策记录、构建状态 使用场景： - plan 确认后，按计划逐步编码实施 - 编码中断后恢复，继续未完成的子任务 - 多端逐平台编码（每次聚焦一个平台） <example> user: "/native-coding" assistant: "读取 plan-{platform}.md，解析 6 个子任务，按依赖链排序后开始编码..." </example>

原生多平台构建错误修复专家 - 增量修复 Android/iOS/HarmonyOS/KMP 项目的编译错误 工作流程： 1. 检测构建系统：根据平台参数或特征文件自动识别 2. 执行构建并捕获错误：运行平台对应的构建命令 3. 解析和分组错误：按 bundle → 文件路径 → 依赖层次排序 4. 逐个修复：Read → Diagnose → Fix → Re-build → Next 循环 5. 护栏机制：满足停止条件时暂停并报告 6. 输出摘要：修复数、剩余错误、恢复建议 使用场景： - 编码完成后构建失败，需要逐个修复编译错误 - 依赖升级后出现类型不兼容或 API 变更 - 跨平台共享层修改引发多平台编译失败 <example> user: "/native-build-fix android" assistant: "检测到 Gradle 构建系统，执行 compileDebugKotlin，发现 3 个错误，开始逐个修复..." </example>

跨端技术方案分析专家 - 综合多端代码和知识库，产出全平台通用的技术方案，指导后续各端 plan 细化。 工作流程： 1. 需求澄清：brain-storm 式迭代问询，消除歧义 2. 现有流程分析：逐端读取代码/知识库，合并为统一业务流程全貌 3. 整体设计：目标架构图/交互图/数据流/前后台交互/技术选型 4. 子任务拆分：结合模块和代码，定义跨端通用契约和产出链 5. 三板斧：切流方案、监控方案、应急预案 6. 输出持久化：写入 tech-spec.md，等待用户确认 使用场景： - 多端功能开发前的整体技术方案设计 - 跨平台改动的统一架构规划 - 为各端 plan 提供通用技术输入 <example> user: "/native-analyse 新增用户资料编辑功能，支持三端" assistant: "综合 iOS/Android/HarmonyOS 各端代码和知识库，产出跨端统一技术方案..." </example>

HarmonyOS ArkTS 语言语法规范知识库，涵盖类型约束、类约束、函数约束、模块约束、声明式UI语法、状态管理等核心规则。When to use: 在实现任何 HarmonyOS ArkTS 代码时都必须使用本 Skill，包括 - 编写或生成 ArkTS 代码、 - 编写/修改 struct/@Component、 - 使用或接入组件、 - 查阅或校验 ArkTS 规范、 - 评审 ArkTS 代码、 - 排查与 ArkTS 约束相关的问题。 trigger：ArkTS、HarmonyOS、鸿蒙、struct、@Component、@State、@Prop、@Link、声明式UI、类型约束、核心约束。

HarmonyOS 知识搜索能力。通过 MCP 工具 harmonyos_knowledge_search（按后缀匹配）搜索鸿蒙官方文档和知识库。Use when: (1) 用户对鸿蒙问题进行提问，(2) 现有知识不足以支撑 HarmonyOS 功能开发，(3) 需要查询最新的 API 文档或最佳实践，(4) 遇到未知错误或问题需要查找解决方案。Triggers: 搜索、查询、文档、API文档、官方文档、不知道、不了解、怎么用、如何实现、帮助文档。

HarmonyOS ArkWeb Web组件能力集使用规范。包含 Web 组件、WebView 控制器、网页加载、JavaScript交互、Cookie管理等功能。Use when: (1) 加载网页，(2) WebView交互，(3) JS桥接，(4) 网页调试。Triggers: 网页、WebView、浏览器、HTML、JavaScript、Web组件、webview、@ohos.web.webview。

HarmonyOS TestKit 测试能力集使用规范。包含UI自动化测试、单元测试、测试驱动、组件查找和操作等功能。Use when: (1) 编写UI测试，(2) 自动化测试脚本，(3) 组件查找和操作，(4) 测试运行器。Triggers: 测试、UI测试、自动化、单元测试、uitest、Driver、testRunner。

HarmonyOS TelephonyKit 电话能力集使用规范。包含电话拨打、短信发送、SIM卡管理、网络状态监听等功能。Use when: (1) 拨打电话，(2) 发送短信，(3) 读取SIM卡信息，(4) 监听通话状态。Triggers: 电话、拨打、短信、SMS、SIM卡、通话、telephony、call、sms、sim、@ohos.telephony。

HarmonyOS 安全能力集使用规范。包含 CryptoArchitectureKit 加密解密、UserAuthenticationKit 用户认证（指纹、人脸）、UniversalKeystoreKit 密钥库等安全功能。Use when: (1) 数据加密解密，(2) 用户认证，(3) 指纹/人脸识别，(4) 密钥管理。Triggers: 加密、解密、指纹、人脸、认证、密码、密钥、crypto、cipher、userAuth、fingerprint、face。

HarmonyOS PerformanceAnalysisKit 性能分析能力集使用规范。包含 hilog 日志、hiAppEvent 事件、hidebug 调试、FaultLogger 故障日志、bytrace/hiTraceMeter 性能追踪等能力。Use when: (1) 日志输出，(2) 性能分析，(3) 故障排查，(4) 事件打点。Triggers: hilog、日志、性能、调试、debug、trace、FaultLogger、hiAppEvent、性能分析、打点。

HarmonyOS NetworkKit 网络能力集使用规范。包含 HTTP 请求、WebSocket、Socket 连接、网络状态检测、VPN 等网络相关能力。Use when: (1) 发送 HTTP 请求，(2) 实现 WebSocket 通信，(3) 检测网络状态，(4) 处理网络连接。Triggers: HTTP、fetch、axios、网络请求、WebSocket、Socket、网络状态、连接、VPN、@ohos.net.http。

HarmonyOS MediaKit、AudioKit、ImageKit、CameraKit 媒体能力集使用规范。包含音视频播放录制、图片处理、相机等功能。Use when: (1) 播放音视频，(2) 录制音视频，(3) 图片编解码，(4) 相机功能。Triggers: 音频、视频、播放器、录制、相机、图片处理、audio、media、camera、image、@ohos.multimedia。

HarmonyOS LocalizationKit 本地化能力集使用规范。包含 i18n 国际化、intl 格式化、resourceManager 资源管理等能力。Use when: (1) 多语言国际化，(2) 日期时间格式化，(3) 数字货币格式化，(4) 资源管理。Triggers: 国际化、多语言、i18n、intl、resourceManager、locale、本地化、翻译、格式化。

HarmonyOS IPCKit 进程间通信能力集使用规范。包含 RPC 远程过程调用、IPC 进程间通信、序列化反序列化等核心能力。Use when: (1) 跨进程通信，(2) IPC 数据传递，(3) 远程服务调用，(4) 进程间数据序列化。Triggers: IPC、RPC、跨进程、rpc、MessageSequence、RemoteObject、进程通信、Parcelable。

HarmonyOS InputKit 多模态输入能力集使用规范。包含 KeyEvent 按键事件、MouseEvent 鼠标事件、TouchEvent 触摸事件、inputDevice 输入设备管理等能力。Use when: (1) 处理键盘事件，(2) 处理鼠标事件，(3) 处理触摸事件，(4) 输入设备管理。Triggers: KeyEvent、MouseEvent、TouchEvent、键盘、鼠标、触摸、inputDevice、onKeyEvent、按键事件、手势识别。

HarmonyOS IMEKit 输入法能力集使用规范。包含 InputMethodExtensionAbility、inputMethod、inputMethodEngine 等输入法开发和调用能力。Use when: (1) 开发输入法应用，(2) 管理系统输入法，(3) 输入法设置，(4) 自定义键盘。Triggers: 输入法、InputMethod、IME、键盘、inputMethod、InputMethodExtensionAbility、软键盘、输入法切换。

HarmonyOS ArkGraphics2D 2D图形能力集使用规范。包含 drawing 绘制、effectKit 特效、colorSpaceManager 色彩空间、displaySync 显示同步等2D图形绘制能力。Use when: (1) 自定义绘制，(2) Canvas绘图，(3) 图像特效，(4) 颜色管理。Triggers: drawing、Canvas、绑定、graphic、effectKit、颜色空间、colorSpace、displaySync、2D图形、自定义渲染。

HarmonyOS FormKit 卡片能力集使用规范。包含 FormExtensionAbility、formProvider、formBindingData 等卡片开发核心能力。Use when: (1) 开发服务卡片，(2) 更新卡片数据，(3) 卡片生命周期管理，(4) 桌面小组件。Triggers: 卡片、FormExtensionAbility、formProvider、卡片服务、桌面小组件、Widget、formBindingData。

HarmonyOS CoreFileKit 文件能力集使用规范。包含文件读写、文件选择器、文件管理、云同步等文件操作能力。Use when: (1) 读写文件，(2) 选择文件/保存文件，(3) 文件管理，(4) 获取存储信息。Triggers: 文件操作、读写文件、文件选择、picker、fs、fileIo、存储、@ohos.file。

HarmonyOS DistributedServiceKit 分布式能力集使用规范。包含分布式设备管理、设备发现、跨设备协同、设备认证等功能。Use when: (1) 设备发现，(2) 跨设备协同，(3) 分布式数据同步，(4) 设备认证。Triggers: 分布式、跨设备、设备发现、协同、distributed、deviceManager、多设备。

HarmonyOS 设备能力集使用规范。包含 SensorServiceKit（传感器、振动）、LocationKit（定位）、NotificationKit（通知）、BackgroundTasksKit（后台任务）等设备相关能力。Use when: (1) 使用传感器，(2) 获取位置信息，(3) 发送通知，(4) 后台任务。Triggers: 传感器、振动、定位、GPS、通知、后台任务、sensor、vibrator、geolocation、notification、background。