Agent Skills
› flutter/agent-plugins
flutter/agent-plugins
GitHub根据规范 API 设计指南审查代码，评估契约优先、KISS、安全性等原则，并生成包含评分、关键问题和改进示例的结构化报告。
Install All Skills
npx skills add flutter/agent-plugins --all -g -y
Skills in Collection (41)
根据规范 API 设计指南审查代码，评估契约优先、KISS、安全性等原则，并生成包含评分、关键问题和改进示例的结构化报告。
用户请求审查 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
通过严格提问和压力测试计划，与现有领域模型对齐术语，并实时更新 CONTEXT.md 和 ADR 文档。
用户希望验证设计计划的一致性
需要梳理和统一项目领域术语
需要同步更新架构决策记录
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脚本处理文本或遍历目录
优化macOS下的CLI工具使用效率
npx skills add flutter/agent-plugins --skill unix-cli-best-practices -g -y
提供 Dart/Flutter 单元测试的编写规范、文件结构及执行流程。指导使用 package:test 和 mockito 构建测试套件，涵盖异步处理、依赖注入及回归测试，确保代码正确性。
需要为 Dart 或 Flutter 代码编写单元测试
修复 Bug 后需要添加回归测试用例
询问如何组织测试文件或运行测试命令
npx skills add flutter/agent-plugins --skill dart-add-unit-test -g -y
提供Dart CLI应用开发指南，涵盖架构模式、参数解析、退出码处理、子进程管理及测试等最佳实践。
构建Dart命令行工具
实现CLI脚本
配置pubspec.yaml
处理命令行参数
npx skills add flutter/agent-plugins --skill dart-build-cli-app -g -y
指导在Dart和Flutter项目中配置coverage包，执行测试并生成LCOV覆盖率报告。包含自动与手动收集流程、忽略指令及验证步骤。
需要生成代码覆盖率报告
配置Dart或Flutter项目的测试覆盖工具
处理coverage包的依赖和脚本
npx skills add flutter/agent-plugins --skill dart-collect-coverage -g -y
用于解决 Dart 项目中的静态分析和运行时错误。通过类型系统、空安全及错误处理指南，结合分析器与 LSP 定位问题行并应用修复，最终验证解决情况。
Dart 代码出现静态分析错误
需要修复 Dart 运行时错误或类型不匹配
npx skills add flutter/agent-plugins --skill dart-fix-runtime-errors -g -y
指导在 Dart 项目中通过依赖注入和 Mockito 生成 Mock 对象，以隔离外部依赖进行单元测试。涵盖代码结构、依赖配置、Mock 生成及测试实现流程。
需要为 Dart 类编写单元测试
使用 Mockito 生成外部依赖的模拟对象
处理异步方法的 Mock 存根
npx skills add flutter/agent-plugins --skill dart-generate-test-mocks -g -y
指导将Dart测试套件从旧的package:matcher迁移到现代、类型安全的package:checks断言库。包含依赖配置、文件识别、语法转换及验证步骤，旨在提升静态类型安全和IDE体验。
迁移Dart测试到checks包
使用package:checks
现代化测试断言
npx skills add flutter/agent-plugins --skill dart-migrate-to-checks-package -g -y
解决 Dart 项目中因包版本冲突导致 pub get 失败的问题。涵盖依赖审计、升级及版本约束调整，确保依赖解析成功并维持构建一致性。
pub get 因版本冲突失败
需要审计过期的 Dart 依赖
需要升级 Dart 包版本
npx skills add flutter/agent-plugins --skill dart-resolve-package-conflicts -g -y
执行Dart静态分析以识别警告和错误，并使用自动修复工具解决机械性Lint问题。用于开发期间确保代码质量及提交前检查。
需要检查Dart代码质量和潜在错误时
提交代码前进行静态分析扫描时
需要自动修复格式或Lint问题时
npx skills add flutter/agent-plugins --skill dart-run-static-analysis -g -y
指导如何在Dartdoc中通过{@example}指令注入外部代码示例，利用#hide、#region和#endregion标签过滤展示内容，确保文档示例可分析、Lint和执行。
编写 Dart 包文档
优化 API 文档中的代码示例展示
清理文档中的冗余或敏感代码
npx skills add flutter/agent-plugins --skill dart-use-doc-examples -g -y
指导使用 package:ffigen 自动生成 Dart FFI 绑定，禁止手写。涵盖配置规范、文件路径约束、头文件过滤及符号树摇动设置，确保集成 C/ObjC/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 替代原生字符串处理，涵盖路径拼接、分割、规范化及上下文转换，避免跨平台兼容性问题。
编写涉及文件路径拼接或分割的代码
重构使用字符串操作处理路径的旧代码
需要跨平台（Windows/POSIX）兼容的路径逻辑
npx skills add flutter/agent-plugins --skill dart-use-path-package -g -y
指导在Dart中应用模式匹配、switch表达式和解构，用于重构复杂逻辑、验证JSON及处理代数数据类型。
重构复杂的if-else链
解析多态JSON或API响应
解构列表、URI路径或Map
对密封类执行穷举检查
npx skills add flutter/agent-plugins --skill dart-use-pattern-matching -g -y
协助用户编写、重构和调试 Dart 3.13+ 的主构造函数及新语法，涵盖参数声明、初始化及简洁语法迁移。
Dart主构造函数语法咨询
Dart代码重构与迁移
npx skills add flutter/agent-plugins --skill dart-use-primary-constructors -g -y
提供Dart代码API文档的编写规范，涵盖///注释格式、公共API聚焦、语气风格及反模式禁止。指导Agent生成符合Effective Dart标准的文档注释。
为Dart代码编写或更新API文档
生成Dart声明的doc comments
npx skills add flutter/agent-plugins --skill dart-write-documentation -g -y
配置Flutter集成测试环境，指导通过MCP交互探索UI并编写自动化端到端测试脚本。
添加集成测试
通过MCP探索UI组件
自动化用户流程
npx skills add flutter/agent-plugins --skill flutter-add-integration-test -g -y
提供Flutter组件实时预览功能，指导如何使用@Preview注解、处理原生API限制及配置多场景预览，确保UI开发的一致性与交互测试效率。
创建新的Flutter UI组件
更新现有界面以进行设计一致性检查
需要交互式测试Widget渲染效果
npx skills add flutter/agent-plugins --skill flutter-add-widget-preview -g -y
指导如何编写Flutter组件级测试，使用WidgetTester验证UI渲染和用户交互。涵盖环境配置、核心组件（Finder/Matcher）、实现工作流及状态管理逻辑，确保Widget正确显示数据并响应事件。
需要为Flutter Widget编写单元测试
验证UI组件的渲染结果和交互行为
调试Widget测试失败问题
npx skills add flutter/agent-plugins --skill flutter-add-widget-test -g -y
提供Flutter应用架构最佳实践，指导分层设计（UI、Logic、Data）与项目结构组织。适用于新项目搭建或重构以提升可扩展性，强调关注点分离及MVVM/Repository模式。
Flutter项目初始化架构设计
Flutter代码重构以增强可扩展性
npx skills add flutter/agent-plugins --skill flutter-apply-architecture-best-practices -g -y
指导在Flutter中实现响应式布局，利用LayoutBuilder和MediaQuery根据窗口空间自适应UI，避免基于设备类型或方向硬编码，确保多端一致体验。
需要适配不同屏幕尺寸的UI
Flutter应用布局调整
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实现声明式路由，支持Web和移动端深度链接、浏览器历史及嵌套导航。
配置Flutter应用的路由系统
实现URL深度链接功能
处理嵌套导航结构
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 响应
Flutter 网络配置
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 Hook系统编译打包C/C++代码，支持本地构建与预编译库下载，实现跨平台原生互操作及自动化集成。
setup native assets
compile C/C++ source code
bundle dynamic libraries
build native C code
link native assets
npx skills add flutter/agent-plugins --skill dart-setup-ffi-assets -g -y
