Agent Skills
› flutter/agent-plugins
flutter/agent-plugins
GitHub根据规范 API 设计指南审查代码，评估契约优先、KISS/YAGNI、易用性、CQS、安全性和显式配置等原则，并生成包含评分、关键问题及改进建议的结构化报告。
Install All Skills
npx skills add flutter/agent-plugins --all -g -y
Skills in Collection (39)
根据规范 API 设计指南审查代码，评估契约优先、KISS/YAGNI、易用性、CQS、安全性和显式配置等原则，并生成包含评分、关键问题及改进建议的结构化报告。
用户请求进行 API 审查
检查代码是否符合 API 设计原则
npx skills add flutter/agent-plugins --skill api-review -g -y
提供代码文档编写指南，涵盖docstrings、JSDoc等规范。指导如何撰写清晰、一致的API文档和实现注释，提升代码可维护性。适用于Dart、Python或TypeScript项目的新代码编写、功能添加及现有文档优化。
编写新代码时生成文档字符串
为现有代码补充或改进说明文档
审查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替代传统grep/find，涵盖文件搜索、文本处理及代码导航的最佳实践。
需要快速在代码库中搜索文本或查找文件
编写或优化shell脚本与命令行操作
macOS环境下进行高效的文件遍历与内容检索
npx skills add flutter/agent-plugins --skill unix-cli-best-practices -g -y
提供 Dart/Flutter 单元测试的编写与组织规范，涵盖文件结构、使用 package:test 及 mockito 编写测试用例、执行命令及标准工作流，确保代码正确性。
需要为函数或类编写单元测试
修复 Bug 后需添加回归测试
npx skills add flutter/agent-plugins --skill dart-add-unit-test -g -y
提供Dart命令行应用开发指南，涵盖项目结构、参数解析、错误处理及编译分发。指导使用官方模板、args包构建健壮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 代码中的静态分析错误
需要解决 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迁移至现代type-safe的package:checks断言库，包含依赖配置、语法转换及验证流程。
迁移Dart测试到checks包
使用package:checks
现代化测试断言
npx skills add flutter/agent-plugins --skill dart-migrate-to-checks-package -g -y
Dart依赖管理技能，指导解决pub get失败、版本冲突及锁定问题。涵盖审计、升级策略、Caret语法使用及CI锁文件强制规范，确保项目依赖一致性与可重现构建。
pub get因版本不兼容失败
需要解决包版本冲突
审计过时依赖
npx skills add flutter/agent-plugins --skill dart-resolve-package-conflicts -g -y
用于执行Dart静态代码分析并自动修复机械性Lint问题，确保代码质量。
检查代码质量
提交前验证
自动修复Lint
npx skills add flutter/agent-plugins --skill dart-run-static-analysis -g -y
指导使用 package:ffigen 自动生成 Dart FFI 绑定，替代手动编写。规范了生成器位置、头文件管理、精确过滤、输出目录及许可证处理，旨在标准化 C/Objective-C/Swift 集成流程，提升代码质量与可维护性。
需要为 C 库或第三方原生库生成 Dart FFI 绑定
重构现有手写的 dart:ffi 代码以采用自动化工具
扩展或修改现有的原生语言集成层
npx skills add flutter/agent-plugins --skill dart-use-ffigen -g -y
指导在 Dart 中正确使用 switch 表达式、语句及各类模式匹配（如 Map、List、Record、密封类等），涵盖选择策略、语法规范与核心实现规则。
需要处理复杂条件分支或类型检查
使用 Dart 进行数据解构和验证
重构代码以利用模式匹配简化逻辑
npx skills add flutter/agent-plugins --skill dart-use-pattern-matching -g -y
协助用户编写、重构或调试 Dart 3.12+ 的主构造函数及新语法，包括简化的类头声明、参数类型区分及初始化逻辑。
Dart主构造函数语法迁移
Dart类定义代码重构
Dart构造函数调试
npx skills add flutter/agent-plugins --skill dart-use-primary-constructors -g -y
提供 Dart API 文档编写规范，指导生成符合 Effective Dart 标准的 /// 注释，涵盖结构、语气及反模式禁令。
需要为 Dart 代码编写或更新文档时
要求遵循 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组件
更新现有界面以进行可视化测试
npx skills add flutter/agent-plugins --skill flutter-add-widget-preview -g -y
提供Flutter组件级测试的实现指南，涵盖环境配置、核心组件使用及标准工作流。指导开发者利用WidgetTester验证UI渲染正确性及用户交互响应，确保特定组件按预期展示数据和响应事件。
需要编写Flutter Widget单元测试
验证UI组件渲染或交互逻辑
配置flutter_test测试环境
npx skills add flutter/agent-plugins --skill flutter-add-widget-test -g -y
提供Flutter应用架构指导，采用分层设计（UI、Logic、Data）和MVVM模式，规范项目结构与代码组织。适用于新项目搭建或重构以提升可扩展性。
需要为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布局错误（如溢出、无界约束），提供诊断和修复工作流，适用于前端UI开发。
遇到RenderFlex overflowed错误
出现Vertical viewport was given unbounded height错误
npx skills add flutter/agent-plugins --skill flutter-fix-layout-issues -g -y
指导在Flutter中手动实现JSON序列化，包括使用dart:convert创建fromJson/toJson模型类、处理HTTP响应及大负载后台解析。
需要手动映射JSON到Dart模型
实现数据模型的序列化逻辑
解析网络请求返回的JSON数据
npx skills add flutter/agent-plugins --skill flutter-implement-json-serialization -g -y
指导在Flutter中配置go_router实现声明式路由，支持深度链接和嵌套导航。涵盖应用初始化、URL策略设置及原生平台深度链接配置，适用于Web或需浏览器历史支持的移动应用开发。
Flutter应用需要深度链接功能
配置声明式路由方案
集成go_router包
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请求
调用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/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
