resolve-verification-issues

作者: flutter

消除由 ./gradlew verifyPlugin 识别的插件验证警告和错误(内部 API 使用、仅覆盖 API 使用等)。

npx skills add https://github.com/flutter/flutter-intellij --skill resolve-verification-issues

Skill: Resolve Plugin Verification Issues

You are tasked with eliminating plugin verification warnings and errors (Internal API usage, Override-only API usage, etc.).

Objective

Eliminate plugin verification warnings and errors (Internal API usage, Override-only API usage, etc.).

Workflow Instructions

1. Baseline

  • Run ./gradlew testClasses to ensure project compiles.
  • Run ./gradlew test and ./gradlew verifyPlugin to establish a clean baseline.

2. Analyze Report

  • Identify distinct issues to resolve (e.g., "Override-only API usage in ClassX").

3. Implement Fix

  • Resolve the specific issue in the current branch.
  • Ensure the fix is minimal and targeted.

4. Verify Fix

  • Run ./gradlew testClasses to ensure no new compilation errors.
  • Run ./gradlew verifyPlugin again to confirm the specific warning is gone and quantify the improvement.
  • Run ./gradlew test to ensure no regressions.

5. Validation & Manual Testing

  • Explain how to verify the fix manually by running ./gradlew runIde.
  • Provide specific navigation steps for the user to reach the changed code within the plugin (e.g. "Open Settings > Languages & Frameworks > Flutter...").
  • Verify that the changes do not introduce runtime errors or regressions.

6. Report & Review

  • Summarize the remaining verifyPlugin issues (e.g., "Total remaining issues: X compatibility warnings, Y internal API usages").
  • Confirm that ./gradlew runIde validation passed.
  • Test Location: Explicitly state where in the IDE the user should go to test the changed functionality (e.g., "Go to Preferences > Languages & Frameworks > Flutter").
  • Action: Ask the user to review the fix closely.
  • Do not commit or push.
  • Provide a suggested Git commit message including specific counts (e.g., "Fix Internal API usage in ClassX: 5 experimental APIs used -> 4 experimental APIs used").

来自 flutter 的更多技能

dart-modern-features
flutter
为了找到现代化的候选方案:
flutter-fix-layout-issues
flutter
使用Dart和Flutter MCP工具修复Flutter布局错误(溢出、无界约束)。适用于处理“RenderFlex溢出”、“垂直…
adding-release-notes
flutter
在 DevTools 发布说明中添加面向用户的变更描述。用于在 NEXT_RELEASE_NOTES.md 文件中记录改进、修复或新功能。
reviewing-devtools-prs
flutter
DevTools 仓库专属的PR审查工作流程,执行DevTools风格指南和常见审查模式。在审查……中的拉取请求时使用。
dart-use-primary-constructors
flutter
帮助用户在Dart中编写语法和语义正确的主构造函数,并迁移/使用新的构造函数语法、空体分号语法等。
code-documentation
flutter
编写有效代码文档的指南,包括docstrings、JSDoc、dartdoc和实现注释。在编写新代码、添加…时使用此技能。
api-review
flutter
对照规范的API设计指南审查指定代码。当用户要求进行API审查或根据API设计规范检查代码时,请使用此技能…
flutter-accessibility
flutter
在Flutter应用中实现WCAG 2和EN 301 549无障碍标准及自适应布局。在移动端、网页端和桌面端强制实施语义标注、点击目标尺寸(最小48x48 dp)和文本对比度(小文本4.5:1,大文本3:1)。提供网页语义初始化、交互式组件包裹、基于屏幕尺寸的布局切换以及键盘/鼠标输入处理的决策逻辑。包含通过FocusTraversalGroup实现的焦点遍历管理,以及...