Agent Skills
› flutter/agent-plugins
flutter/agent-plugins
GitHub根据规范 API 设计指南审查代码，评估契约优先、简洁性、易用性等原则，并生成包含评分、关键问题及改进示例的结构化报告。
安装全部 Skills
npx skills add flutter/agent-plugins --all -g -y
集合内 Skills (41)
根据规范 API 设计指南审查代码，评估契约优先、简洁性、易用性等原则，并生成包含评分、关键问题及改进示例的结构化报告。
用户请求进行 API 审查
用户要求检查代码是否符合 API 设计原则
npx skills add flutter/agent-plugins --skill api-review -g -y
提供代码文档编写指南，涵盖Docstrings、JSDoc等规范。指导用户以用户为中心、清晰简洁地撰写注释，提升API可读性与维护性，适用于Dart、Python和TypeScript项目。
编写新代码时添加文档
改进现有代码注释
npx skills add flutter/agent-plugins --skill code-documentation -g -y
提供多步骤迭代代码审查工作流，用于分析PR或本地变更。通过收集变更、丰富上下文及多维度评估（正确性、效率等），生成高质量、可执行的反馈，避免AI常见缺陷。
需要审查GitHub Pull Request的代码变更
需要审查本地Git提交或分支的修改
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描述及代码注释等长文本创作，旨在消除AI痕迹，提升内容的人类化表达质量。
撰写分析报告或技术文档
编写PR或CL描述
生成代码注释
npx skills add flutter/agent-plugins --skill natural-writing -g -y
提供macOS/BSD环境下高效安全的CLI工具使用规范，推荐rg和fd替代传统grep/find，涵盖代码搜索、文件查找及文本处理的最佳实践。
需要快速在代码库中搜索文本内容
需要在文件系统中查找特定文件或目录
编写shell脚本或one-liner处理文本数据
npx skills add flutter/agent-plugins --skill unix-cli-best-practices -g -y
指导为Dart和Flutter应用编写及组织单元测试，涵盖文件结构、package:test库使用、执行命令及标准工作流，确保代码正确性。
需要为函数或类编写单元测试
修复Bug后验证回归测试
创建新逻辑时添加测试用例
npx skills add flutter/agent-plugins --skill dart-add-unit-test -g -y
提供Dart CLI应用开发的架构规范，涵盖进程生命周期管理、参数解析、子进程调用及编译打包最佳实践。指导构建高效的命令行工具与脚本。
开发Dart命令行工具或脚本
配置CLI应用的参数解析与退出码
处理Dart CLI的子进程与信号
npx skills add flutter/agent-plugins --skill dart-build-cli-app -g -y
指导如何在Dart和Flutter项目中配置coverage包，执行测试并生成LCOV覆盖率报告。包含自动化脚本使用、手动收集方法及忽略指令配置，帮助开发者验证代码测试覆盖情况。
需要生成代码覆盖率报告
配置测试覆盖率工具
优化测试覆盖度
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对象以编写高质量的单元测试。
需要为Dart类编写单元测试
需要模拟API或数据库等外部依赖
npx skills add flutter/agent-plugins --skill dart-generate-test-mocks -g -y
指导将 Dart 测试套件从旧版 package:matcher 迁移至现代类型安全的 package: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问题，确保代码质量。
开发阶段检查代码规范
提交前验证代码质量
npx skills add flutter/agent-plugins --skill dart-run-static-analysis -g -y
指导如何在 Dartdoc 中使用 {@example} 指令注入外部代码示例，支持通过 #region/#endregion 提取代码块及 #hide 隐藏无关行，确保文档中的代码可被分析和执行。
编写或维护 Dart API 文档
优化代码示例的可读性和准确性
npx skills add flutter/agent-plugins --skill dart-use-doc-examples -g -y
指导使用 package:ffigen 自动生成 FFI 绑定，禁止手写。涵盖配置规范、文件路径约束、头文件过滤及验证流程，旨在标准化 Dart 与 C/Objective-C/Swift 的集成开发。
需要编写新的 FFI 绑定
扩展 C/Objective-C/Swift 集成
替换手写的 dart:ffi 代码
npx skills add flutter/agent-plugins --skill dart-use-ffigen -g -y
提供Dart语言中跨平台文件路径操作的最佳实践，指导使用package:path和package:file替代易错的字符串处理，涵盖路径拼接、分割、标准化及上下文转换。
编写或重构涉及文件路径的代码
需要处理跨平台路径兼容性
npx skills add flutter/agent-plugins --skill dart-use-path-package -g -y
指导在 Dart 3 中应用模式匹配、switch 表达式和解构，用于数据验证、ADT 处理及控制流简化。适用于重构复杂条件逻辑、解析多态 JSON 或解构集合/记录。
重构复杂的 if-else 链
解析多态 JSON 或 API 响应
解构 List、URI 路径或 String.split 结果
对 sealed class 进行穷尽性检查
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标准的///注释，涵盖结构、语气及链接规则。
需要为Dart代码编写或更新API文档时
要求遵循Effective Dart文档指南进行注释编写时
npx skills add flutter/agent-plugins --skill dart-write-documentation -g -y
指导配置 Flutter 集成测试环境，利用 MCP 工具交互探索 UI 状态，编写基于 integration_test 包的端到端自动化测试脚本，涵盖依赖安装、驱动扩展启用及测试执行规范。
添加 Flutter 应用集成测试
通过 MCP 探索 UI 组件和状态
自动化用户操作流程
npx skills add flutter/agent-plugins --skill flutter-add-integration-test -g -y
为Flutter项目添加交互式组件预览，支持通过@Preview注解实时渲染UI，配置主题、尺寸等参数，确保设计一致性与交互测试。
创建新的UI组件
更新现有屏幕界面
需要实时预览Widget效果
npx skills add flutter/agent-plugins --skill flutter-add-widget-preview -g -y
指导如何编写Flutter组件级测试，使用WidgetTester验证UI渲染和用户交互。涵盖环境配置、核心组件（Finder/Matcher）及标准测试工作流，确保小部件正确显示数据并响应事件。
需要为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
处理移动端与桌面端/平板的布局适配
npx skills add flutter/agent-plugins --skill flutter-build-responsive-layout -g -y
解决Flutter布局错误（如溢出、无界约束），提供诊断方法和修复工作流。
RenderFlex overflowed
Vertical viewport was given unbounded height
npx skills add flutter/agent-plugins --skill flutter-fix-layout-issues -g -y
指导在Flutter中手动实现JSON序列化，包括创建带fromJson/toJson的模型类、处理类型安全及大体积数据解析优化。
需要手动映射JSON键到Dart属性
实现简单的数据模型序列化
npx skills add flutter/agent-plugins --skill flutter-implement-json-serialization -g -y
指导在Flutter应用中配置go_router实现声明式路由，支持深度链接、浏览器历史记录及嵌套导航。涵盖初始化路由器、平台URL拦截及ShellRoute等核心工作流，适用于Web和移动端开发。
需要实现Flutter应用的路由配置
需要支持深度链接或URL导航
npx skills add flutter/agent-plugins --skill flutter-setup-declarative-routing -g -y
用于在Flutter项目中初始化国际化支持，包括添加依赖、配置生成标志及l10n.yaml文件。
新建Flutter项目需支持多语言
配置flutter_localizations和intl
npx skills add flutter/agent-plugins --skill flutter-setup-localization -g -y
指导在Flutter中使用http包进行REST API通信，涵盖配置、请求处理、后台解析及错误管理。
需要发送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
指导在Dart中通过Native Assets Hook系统编译打包C/C++源码为动态或静态库。涵盖本地编译、预编译库下载及链接树摇优化，实现跨平台原生代码集成。
setup native assets
compile C/C++ source code
bundle dynamic libraries
build native C code
link native assets
implement build.dart or link.dart hooks
integrate C/C++ interop in Dart/Flutter
npx skills add flutter/agent-plugins --skill dart-setup-ffi-assets -g -y
