Agent Skills
› flutter/agent-plugins
flutter/agent-plugins
GitHub依据规范 API 设计原则审查代码，评估契约、易用性、安全性等维度，并生成包含评分、关键问题及改进示例的结构化报告。
Install All Skills
npx skills add flutter/agent-plugins --all -g -y
Skills in Collection (41)
依据规范 API 设计原则审查代码，评估契约、易用性、安全性等维度，并生成包含评分、关键问题及改进示例的结构化报告。
用户要求审查 API 代码
用户请求检查代码是否符合 API 设计规范
npx skills add flutter/agent-plugins --skill api-review -g -y
提供代码文档编写指南，涵盖Docstrings、JSDoc等规范。适用于Dart、Python、TypeScript的新增功能或现有文档优化，确保API清晰可维护。
编写新代码时添加注释
优化现有代码文档
为公共API补充说明
npx skills add flutter/agent-plugins --skill code-documentation -g -y
提供多步骤迭代式代码审查工作流，针对PR或本地变更生成高质量、可操作的反馈。通过收集变更、丰富上下文及多维度评估（正确性、效率等），确保审查精准有效，避免AI常见缺陷。
需要审查 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描述及代码注释等长文本场景。
撰写长篇分析文档
编写PR或CL描述
创建技术文档
编写代码注释
npx skills add flutter/agent-plugins --skill natural-writing -g -y
提供macOS/BSD环境下高效安全的命令行操作指南，涵盖rg/fd等高性能替代工具及原生命令用法，支持代码搜索、文件查找和文本处理。
需要快速搜索代码库
执行文件查找操作
进行文本处理或过滤
编写Shell脚本
npx skills add flutter/agent-plugins --skill unix-cli-best-practices -g -y
指导为Dart和Flutter应用编写及组织单元测试，涵盖文件结构、package:test使用、异步测试、Mockito集成及执行流程，确保代码正确性并防止回归。
需要为新逻辑或修复Bug编写单元测试时
询问Dart/Flutter测试框架用法或最佳实践时
npx skills add flutter/agent-plugins --skill dart-add-unit-test -g -y
指导构建 Dart CLI 应用的最佳实践，涵盖架构设计、参数解析、进程生命周期管理、子进程调用及测试分发。
构建命令行工具或脚本
配置 Dart CLI 项目结构
处理退出码与信号
npx skills add flutter/agent-plugins --skill dart-build-cli-app -g -y
指导如何在Dart和Flutter项目中配置coverage包，通过执行测试生成LCOV覆盖率报告，并支持忽略特定代码行的指令及手动收集高级覆盖数据。
需要生成代码覆盖率报告
配置Dart/Flutter测试环境
分析测试覆盖率数据
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和build_runner生成Mock对象，并实现单元测试中的Stubbing与Verification。
需要为外部依赖（如API或数据库）生成Mock对象
编写Dart单元测试时处理异步方法模拟
配置测试依赖和代码生成流程
npx skills add flutter/agent-plugins --skill dart-generate-test-mocks -g -y
指导将Dart测试套件从旧的package:matcher迁移至现代type-safe的package:checks断言库。涵盖依赖配置、文件定位、语法转换及验证流程，提升类型安全与IDE体验。
迁移测试到checks
使用package:checks
现代化测试断言
npx skills add flutter/agent-plugins --skill dart-migrate-to-checks-package -g -y
提供Dart项目依赖版本冲突的修复工作流，指导处理pub get失败、审计过时包及升级依赖。
pub get因版本不兼容失败
需要解决Dart包版本锁定问题
npx skills add flutter/agent-plugins --skill dart-resolve-package-conflicts -g -y
用于执行 Dart 静态代码分析并自动修复机械性 lint 问题，确保代码质量。涵盖配置分析器、抑制诊断信息及工作流操作。
检查 Dart 代码中的警告和错误
在提交代码前运行静态分析
自动应用 dart fix 修复 lint 问题
npx skills add flutter/agent-plugins --skill dart-run-static-analysis -g -y
指导如何在Dartdoc中通过{@example}指令注入外部代码示例，利用#hide、#region和#endif等标记过滤内容，以生成清晰可执行的文档。
编写Dart文档时引用外部代码片段
需要清理示例代码中的初始化或测试逻辑
npx skills add flutter/agent-plugins --skill dart-use-doc-examples -g -y
指导使用 package:ffigen 自动生成 Dart FFI 绑定，禁止手写。涵盖配置规范、目录结构、头文件过滤及验证流程，用于替代手动编写 dart:ffi 代码。
需要生成新的 FFI 绑定
扩展 C/Objective-C/Swift 集成
替换手写的 dart:ffi 设置
npx skills add flutter/agent-plugins --skill dart-use-ffigen -g -y
指导在Dart中安全进行跨平台文件路径操作，推荐package:path/file替代字符串处理，涵盖路径拼接、拆分、标准化及上下文转换的最佳实践。
编写或重构涉及文件路径的操作代码
替换原始字符串路径处理方式
处理跨平台路径兼容性
npx skills add flutter/agent-plugins --skill dart-use-path-package -g -y
指导在Dart 3中应用模式匹配、switch表达式和解构，用于重构复杂条件逻辑、解析JSON及处理代数数据类型，提升代码可读性与安全性。
重构复杂的if-else链
解析多态JSON或API响应
解构列表、URI路径或记录
对密封类执行穷举检查
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 文档编写的规范与格式指南，涵盖注释风格、语气、链接及验证规则。用于指导 Agent 为 Dart 代码生成符合 Effective Dart 标准的 /// 文档注释。
需要为 Dart 代码编写或更新 API 文档
生成 Dart 声明的 doc comments
遵循 Effective Dart 文档指南
npx skills add flutter/agent-plugins --skill dart-write-documentation -g -y
指导在Flutter项目中配置集成测试环境，利用MCP工具交互式探索UI状态，并编写基于flutter_test的端到端自动化测试脚本。
需要为Flutter应用添加集成测试
通过MCP工具探索或模拟用户界面交互流程
npx skills add flutter/agent-plugins --skill flutter-add-integration-test -g -y
指导在Flutter项目中为UI组件添加交互式预览，确保设计一致性与交互测试。涵盖注解使用、自定义配置及处理Web环境限制（如无原生API支持），适用于新组件创建或现有屏幕更新时的可视化验证。
创建新的Flutter UI组件
更新现有屏幕界面
需要可视化测试Widget布局
npx skills add flutter/agent-plugins --skill flutter-add-widget-preview -g -y
提供Flutter组件级测试的完整指南，涵盖环境配置、核心组件使用及标准工作流。指导开发者利用WidgetTester验证UI渲染正确性及用户交互响应，确保特定Widget按预期展示数据并处理事件。
需要编写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自适应布局指南，指导使用LayoutBuilder、MediaQuery等构建响应式UI。涵盖空间测量、Widget约束及多设备适配规范，确保应用在不同屏幕尺寸下表现良好。
需要创建适应不同屏幕尺寸的Flutter界面
解决移动端与桌面端/平板端的布局适配问题
优化Flutter应用在可调整窗口下的显示效果
npx skills add flutter/agent-plugins --skill flutter-build-responsive-layout -g -y
修复Flutter布局错误（如溢出、无界约束），提供诊断方法和针对特定错误的代码修复方案。
遇到Flutter布局报错
需要解决RenderFlex溢出
npx skills add flutter/agent-plugins --skill flutter-fix-layout-issues -g -y
指导在Flutter中手动实现JSON序列化，通过fromJson/toJson映射数据，强调类型安全及大解析负载下的Isolate优化。
需要为数据模型创建JSON序列化和反序列化方法
处理从网络获取的JSON数据并转换为Dart对象
npx skills add flutter/agent-plugins --skill flutter-implement-json-serialization -g -y
指导在Flutter中配置go_router实现声明式路由，支持深度链接和浏览器历史。涵盖应用初始化、平台深度链接拦截及嵌套导航配置，适用于Web或移动端开发。
Flutter应用需要URL-based导航
实现深度链接功能
配置嵌套路由结构
npx skills add flutter/agent-plugins --skill flutter-setup-declarative-routing -g -y
为 Flutter 项目初始化国际化支持，包括添加依赖、启用代码生成及配置 ARB 文件。
初始化 Flutter 项目的国际化功能
配置 flutter_localizations 和 intl 依赖
npx skills add flutter/agent-plugins --skill flutter-setup-localization -g -y
指导在Flutter中使用http包进行REST API通信，涵盖配置、请求执行、响应处理及后台JSON解析。
需要发起HTTP请求
实现REST 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
指导Agent使用Dart Native Assets钩子系统编译打包C/C++代码，实现本地构建或下载预编译库，支持链接树剪枝与哈希验证。
setup native assets
compile C/C++ source code
bundle dynamic libraries
build native C code
npx skills add flutter/agent-plugins --skill dart-setup-ffi-assets -g -y
