Agent Skills
› flutter/agent-plugins
flutter/agent-plugins
GitHub根据规范 API 设计指南审查代码，评估接口清晰度、安全性及易用性，并生成包含评分、关键问题和改进示例的结构化报告。
安装全部 Skills
npx skills add flutter/agent-plugins --all -g -y
集合内 Skills (39)
根据规范 API 设计指南审查代码，评估接口清晰度、安全性及易用性，并生成包含评分、关键问题和改进示例的结构化报告。
用户要求审查 API 代码
检查代码是否符合 API 设计原则
npx skills add flutter/agent-plugins --skill api-review -g -y
提供代码文档编写指南，涵盖docstrings、JSDoc等规范。旨在提升Dart、Python和TypeScript代码的清晰度与可维护性，指导用户撰写简洁一致且面向使用者的API文档及实现注释。
编写新代码时添加文档
改进现有代码文档
审查代码注释质量
npx skills add flutter/agent-plugins --skill code-documentation -g -y
提供多步骤迭代代码审查工作流，针对PR或本地变更生成高质量、可操作的反馈。通过收集变更、丰富上下文并基于正确性、效率等标准进行评估，确保审查精准且符合项目规范。
需要审查GitHub Pull Request
需要审查本地代码变更
npx skills add flutter/agent-plugins --skill code-review -g -y
通过严格提问和场景压力测试，验证计划与现有领域模型的一致性，修正术语冲突，并实时更新上下文文档和架构决策记录。
用户希望压力测试设计计划
需要统一项目术语和领域语言
需要更新或创建上下文文档
npx skills add flutter/agent-plugins --skill grill-with-docs -g -y
提供自然写作规范，通过禁用AI常用词、避免冗余句式及强制简洁表达，提升长文本可读性与人类作者风格。
撰写分析文档
编写PR或CL描述
编写技术文档
npx skills add flutter/agent-plugins --skill natural-writing -g -y
提供macOS/BSD环境下高效安全的CLI命令最佳实践，推荐rg和fd替代传统工具，涵盖代码搜索、文件查找及文本处理的一行脚本用法。
需要快速在代码库中搜索文本或文件
执行基于Unix的命令行文本处理任务
npx skills add flutter/agent-plugins --skill unix-cli-best-practices -g -y
提供Dart/Flutter单元测试的编写规范、文件结构组织及执行指南。指导使用package:test进行用例编写、Mock配置及测试运行，确保代码正确性并防止回归错误。
需要为函数或类编写单元测试
修复Bug后需补充回归测试
创建新逻辑时需验证其正确性
npx skills add flutter/agent-plugins --skill dart-add-unit-test -g -y
指导构建 Dart CLI 应用程序，涵盖项目初始化、参数解析、错误处理及跨平台脚本开发。提供标准目录结构、ArgParser/CommandRunner 用法、POSIX 退出码规范及 CI 格式化检查，适用于开发命令行工具。
创建新的 Dart 命令行工具
实现复杂的 CLI 子命令路由
优化 CLI 应用的错误处理和退出码
npx skills add flutter/agent-plugins --skill dart-build-cli-app -g -y
指导在 Dart/Flutter 项目中配置 coverage 包，通过自动化脚本或手动方式收集测试覆盖率数据并生成 LCOV 报告，同时说明如何忽略特定代码行。
需要生成测试覆盖率报告
配置 Dart 项目测试环境
npx skills add flutter/agent-plugins --skill dart-collect-coverage -g -y
针对 Dart 项目，通过静态分析工具定位并修复类型系统、空安全及错误处理相关的编译或运行时错误，确保代码符合语言规范。
Dart 代码出现静态分析错误或类型不匹配
需要修复空安全相关警告
解决异常处理不当导致的潜在运行时问题
npx skills add flutter/agent-plugins --skill dart-fix-runtime-errors -g -y
指导在 Dart 应用中通过依赖注入和 mockito 生成 Mock 对象，以隔离外部依赖进行单元测试。涵盖代码结构、依赖配置、Mock 生成及断言验证流程。
需要为 Dart 类编写单元测试
模拟 HTTP 客户端或数据库等外部依赖
使用 mockito 生成 Mock 对象
npx skills add flutter/agent-plugins --skill dart-generate-test-mocks -g -y
将Dart测试套件从旧版matcher迁移到现代checks断言库，提供依赖配置、语法转换及验证工作流。
迁移测试到checks
使用package:checks
现代化测试断言
npx skills add flutter/agent-plugins --skill dart-migrate-to-checks-package -g -y
解决Dart项目中因包版本不兼容导致的依赖冲突问题。指导用户通过审计、升级和手动调整pubspec.yaml约束来修复pub get失败，确保依赖解析成功及构建可复现。
pub get 失败
包版本冲突
npx skills add flutter/agent-plugins --skill dart-resolve-package-conflicts -g -y
用于执行Dart静态代码分析并自动修复机械式Lint问题。通过配置analysis_options.yaml管理规则，利用dart analyze识别警告与错误，结合dart fix应用自动修复，确保开发阶段及提交前的代码质量。
需要检查Dart代码中的类型错误或风格违规
希望自动修复可机械处理的Lint问题
npx skills add flutter/agent-plugins --skill dart-run-static-analysis -g -y
指导使用 package:ffigen 自动生成 Dart FFI 绑定，替代手动编写。规范了生成脚本位置、头文件管理、过滤器配置及输出路径，确保代码标准化与可维护性。
需要为 C/Objective-C/Swift 库生成 Dart FFI 绑定
替换手写的 dart:ffi 集成代码
npx skills add flutter/agent-plugins --skill dart-use-ffigen -g -y
提供 Dart 语言中模式匹配和 switch 表达式的最佳实践指南，涵盖策略选择、语法规范及核心实现细节。
使用 Dart 进行条件分支逻辑编写
需要解构数据或验证数据结构
npx skills add flutter/agent-plugins --skill dart-use-pattern-matching -g -y
辅助用户编写、重构和调试 Dart 3.12+ 的主构造函数语法，涵盖参数声明、初始化及精简语法迁移。
Dart主构造函数语法咨询
Dart类定义重构
npx skills add flutter/agent-plugins --skill dart-use-primary-constructors -g -y
提供 Dart API 文档和注释的编写规则与格式指南，遵循 Effective Dart 标准，规范公共 API 文档结构、语气及链接方式。
需要为 Dart 代码编写或更新 API 文档
要求遵循 Effective Dart 文档规范
npx skills add flutter/agent-plugins --skill dart-write-documentation -g -y
指导在 Flutter 项目中配置集成测试，通过 MCP 工具交互探索 UI 并生成自动化测试脚本。涵盖依赖安装、Widget 定位、用户流程模拟及断言编写，支持端到端测试验证。
添加 Flutter 集成测试
使用 MCP 探索应用 UI 组件
自动化用户操作流程
npx skills add flutter/agent-plugins --skill flutter-add-integration-test -g -y
为Flutter项目添加交互式组件预览，支持实时渲染、自定义配置及多场景测试，确保UI一致性与交互体验。
创建新的UI组件
更新现有屏幕界面
需要实时预览Widget设计效果
npx skills add flutter/agent-plugins --skill flutter-add-widget-preview -g -y
指导在Flutter项目中编写组件级Widget测试，涵盖环境配置、核心组件使用及验证UI渲染和用户交互的标准工作流。
需要为Flutter Widget编写单元测试
验证UI渲染结果是否正确
模拟用户点击或输入交互
npx skills add flutter/agent-plugins --skill flutter-add-widget-test -g -y
指导Flutter应用架构设计，采用UI、逻辑、数据分层及MVVM/Repository模式。提供项目结构规范与新功能实现工作流，旨在提升代码可维护性与扩展性。
需要为新Flutter项目搭建基础架构
对现有Flutter应用进行重构以增强可扩展性
遵循分层架构原则组织代码
npx skills add flutter/agent-plugins --skill flutter-apply-architecture-best-practices -g -y
指导Flutter开发实现响应式布局，涵盖空间测量、约束应用及多设备适配，确保UI在不同屏幕尺寸下表现一致。
需要适配不同屏幕尺寸
构建自适应UI布局
npx skills add flutter/agent-plugins --skill flutter-build-responsive-layout -g -y
解决Flutter布局错误（如溢出、无界约束），通过诊断特定异常并应用Expanded或Flexible等修复方案，确保UI正常渲染。
出现RenderFlex overflowed错误
出现Vertical viewport was given unbounded height错误
需要修复Flutter界面布局问题
npx skills add flutter/agent-plugins --skill flutter-fix-layout-issues -g -y
指导在Flutter中手动实现JSON序列化，通过定义含fromJson/toJson的模型类，使用dart:convert进行类型安全的编解码，并处理大负载后台解析。
需要手动将JSON映射为Dart数据模型
实现数据的序列化和反序列化逻辑
npx skills add flutter/agent-plugins --skill flutter-implement-json-serialization -g -y
指导在Flutter中配置go_router实现声明式路由，支持深度链接、浏览器历史记录及嵌套导航。涵盖应用初始化、平台URL拦截及ShellRoute配置，适用于Web和移动端复杂路由场景。
需要为Flutter应用配置URL-based导航
实现深度链接或处理浏览器历史
设置嵌套导航或底部导航栏路由
npx skills add flutter/agent-plugins --skill flutter-setup-declarative-routing -g -y
指导在Flutter项目中配置国际化支持，包括添加依赖、启用代码生成及配置本地化文件。
初始化Flutter项目时添加多语言支持
配置flutter_localizations和intl包
npx skills add flutter/agent-plugins --skill flutter-setup-localization -g -y
指导在Flutter中使用http包进行REST API通信，涵盖权限配置、请求执行、响应处理及后台JSON解析，确保网络操作稳定高效。
需要发起HTTP GET/POST请求
实现Flutter应用的网络层
处理API响应数据
npx skills add flutter/agent-plugins --skill flutter-use-http-package -g -y
指导为dart_skills_lint包添加新的验证规则及CLI开关，涵盖规则类创建、注册机制及单元测试编写。
需要新增代码校验规则
需要扩展CLI检查功能
npx skills add flutter/agent-plugins --skill add-dart-lint-validation-rule -g -y
用于在 PR 审查期间验证 dart_skills_lint 对下游生态系统的破坏性变更。通过临时指向本地下游仓库的提交哈希，运行测试以评估兼容性并确定是否需要向后兼容垫片，确保变更安全。
评估 PR 中的破坏性变更
验证迁移与 Changelog 的一致性
检查下游消费者兼容性
npx skills add flutter/agent-plugins --skill check-downstream-consumers -g -y
提供PR描述撰写指南与模板，指导AI在起草、提交或更新PR时生成结构化说明，确保包含摘要、动机、关联问题及测试方法，并强调身份验证。
用户要求起草PR描述
用户要求提交PR
用户要求更新PR描述
npx skills add flutter/agent-plugins --skill contributor-pr-description -g -y
用于在仓库中集成、更新 dart_skills_lint 依赖，包括修改 pubspec.yaml 中的 git 引用、同步锁文件、配置全局规则及生成提交 PR。
更新 dart_skills_lint 的 pinned commit ref
配置 dart_skills_lint 的全局规则和目录路径
管理依赖包哈希并生成 pull request
npx skills add flutter/agent-plugins --skill dart-skills-lint-integration -g -y
确保涉及md或dart代码的任务完成前执行格式、分析、复杂度、测试等强制检查，并规范Changelog更新及输出验证清单。
任务完成前检查
请求审查前验证
npx skills add flutter/agent-plugins --skill definition-of-done -g -y
用于运行技能评估、基准测试及性能对比。通过读取配置、调度子代理执行任务并验证输出，最后根据标准进行评分，以检验技能表现。
用户要求运行评估（evals）
测试技能性能
运行基准测试
对比基线与启用技能后的执行效果
npx skills add flutter/agent-plugins --skill run-evals -g -y
故意构造的无效 Skill，用于演示 CLI 诊断输出。通过触发名称、字段和路径三类规则错误，验证 linting 工具的报错机制及不同配置下的行为表现。
需要查看或验证 CLI linting 工具的报错输出
测试 Skill 校验规则在不同配置下的生效情况
npx skills add flutter/agent-plugins --skill NotInvalid -g -y
用于验证 dart_skills_lint 工具合规性的示例技能，确保 SKILL.md 格式符合默认规则。
验证 linter 配置
测试 skill 格式规范
npx skills add flutter/agent-plugins --skill valid -g -y
首次将 dart_skills_lint 集成到 Dart 项目中，包括添加依赖、创建配置文件及生成基线。
Dart项目首次配置技能验证
需要设置 lint 检查环境
npx skills add flutter/agent-plugins --skill dart-skills-lint-setup -g -y
使用 dart_skills_lint 工具对 AI Agent 技能进行验证，包括运行 Linter、分析失败原因、修复违规项以及编写自定义规则。
需要验证 AI Agent 技能的合规性
Linter 报告了技能文件违规错误
需要为技能检查编写自定义规则
npx skills add flutter/agent-plugins --skill dart-skills-lint-validation -g -y
指导在Dart/Flutter中通过Native Assets Hook系统编译打包C/C++代码为动态或静态库。提供本地编译与预编译下载两种方案，实现自动化构建、链接及树裁剪优化。
setup native assets
compile C/C++ source code
bundle dynamic libraries
build native C code
implement build.dart or link.dart hooks
npx skills add flutter/agent-plugins --skill dart-setup-ffi-assets -g -y
