Agent Skills
› flutter/agent-plugins
flutter/agent-plugins
GitHub依据规范 API 设计指南审查代码，评估契约优先、KISS、易用性、CQS 及安全性等原则，生成包含评分、关键问题与建议的结构化报告。
Install All Skills
npx skills add flutter/agent-plugins --all -g -y
Skills in Collection (38)
依据规范 API 设计指南审查代码，评估契约优先、KISS、易用性、CQS 及安全性等原则，生成包含评分、关键问题与建议的结构化报告。
用户请求进行 API 审查
检查代码是否符合 API 设计原则
npx skills add flutter/agent-plugins --skill api-review -g -y
提供代码文档编写指南，涵盖 docstrings、JSDoc 等规范。适用于 Dart、Python、TypeScript 的新代码编写、功能添加及现有文档优化，旨在提升清晰度与可维护性。
编写新代码时生成注释
为现有代码补充或改进文档
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 Unix CLI 的安全、高效命令模式，涵盖 grep、find、sed 等原生工具及 ripgrep、fd 等现代替代方案，适用于文本处理、文件搜索和代码库导航。
需要高效搜索代码或文件内容
执行复杂的文本处理任务
编写 shell 脚本或一行命令
npx skills add flutter/agent-plugins --skill unix-cli-best-practices -g -y
提供 Dart/Flutter 单元测试的编写、组织与执行规范。涵盖文件结构、使用 package:test 和 mockito 编写用例，以及通过 CLI 运行测试的工作流程，确保代码正确性并防止回归。
需要为函数或类编写单元测试
修复 Bug 后添加回归测试
询问如何组织和运行 Dart 测试
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 语言规范。
Dart 项目出现静态分析错误
需要修复类型不匹配或空安全警告
执行 dart analyze 后存在待处理错误
npx skills add flutter/agent-plugins --skill dart-fix-runtime-errors -g -y
指导如何在 Dart 项目中通过依赖注入和 mockito 生成 Mock 对象，以隔离外部依赖进行单元测试。涵盖配置、代码生成及断言验证流程。
需要为 Dart 类编写单元测试
使用 mockito 生成模拟对象
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项目中因包版本冲突导致的pub get失败问题。提供依赖审计、升级及冲突解析的工作流，指导使用约束语法和锁定文件管理依赖。
pub get 因版本不兼容失败
需要解决依赖版本冲突
审计过时或冲突的包
npx skills add flutter/agent-plugins --skill dart-resolve-package-conflicts -g -y
用于执行Dart静态分析并自动修复代码风格问题，确保开发阶段及提交前的代码质量。
运行Dart静态检查
自动应用机械性lint修复
npx skills add flutter/agent-plugins --skill dart-run-static-analysis -g -y
指导使用 package:ffigen 自动生成 FFI 绑定，替代手动编写 dart:ffi 代码。适用于扩展 C/Objective-C/Swift 集成或替换手工绑定的场景，强调规范、过滤和验证。
需要生成新的 FFI 绑定
扩展 C/Objective-C/Swift 集成
替换手写的 dart:ffi 设置
npx skills add flutter/agent-plugins --skill dart-use-ffigen -g -y
指导在Dart中根据数据结构选择适当的模式匹配策略，区分switch语句与表达式的使用场景，并详细实现各类核心模式语法。
需要处理复杂数据解构
使用switch进行类型或值匹配
npx skills add flutter/agent-plugins --skill dart-use-pattern-matching -g -y
辅助用户在Dart中编写、重构或调试主构造函数及新语法，支持从旧版迁移至3.13+标准语法，减少样板代码。
用户询问Dart主构造函数用法
需要将Dart构造函数迁移到最新语法
检查Dart构造函数语法正确性
npx skills add flutter/agent-plugins --skill dart-use-primary-constructors -g -y
指导配置Flutter集成测试环境，通过MCP工具交互式探索UI并编写自动化端到端测试脚本。
需要为Flutter项目添加集成测试
使用MCP工具探索应用UI组件
自动化用户操作流程
npx skills add flutter/agent-plugins --skill flutter-add-integration-test -g -y
为Flutter项目添加交互式组件预览，支持UI组件创建与更新时的实时渲染、隔离测试及设计一致性验证。
创建新的Flutter 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/Logic/Data）及MVVM模式，规范项目结构与代码组织，旨在提升新项目的可扩展性或重构现有代码。
需要为新Flutter项目设计整体架构
对现有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布局错误（如溢出、无界约束）的技能。通过诊断特定错误签名，按工作流应用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序列化，通过dart:convert库定义包含fromJson/toJson的模型类，处理类型转换、网络请求解析及大数据量时的异步隔离计算，确保类型安全与UI流畅。
需要手动映射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项目的国际化功能
配置多语言支持环境
npx skills add flutter/agent-plugins --skill flutter-setup-localization -g -y
指导在Flutter中使用http包进行REST API通信，涵盖配置、请求处理、错误管理及后台JSON解析。
需要发起HTTP GET/POST请求
处理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
