Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

dart-run-static-analysis: plugin guidance describes the legacy plugin system, and the example includes a file that doesn't exist

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#244 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
90/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
dart
Domaine
documentation

Piste de recherche

Commencez par skills/dart-run-static-analysis/SKILL.md et comparez ses indications sur les plugins avec la documentation moderne des plugins du serveur d’analyse liée dans l’issue. Mettez à jour l’exemple et les explications concernant les plugins modernes et legacy, l’activation du lint, le redémarrage du serveur, l’include valide de flutter_lints et la suppression de missing_return. Appliquez le fix upstream dans dart-lang/skills, puis vérifiez les indications synchronisées dans ce dépôt.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

Skill: skills/dart-run-static-analysis/SKILL.md, unchanged on main since fbb6bbc.

Found these while setting up a new-style analyzer plugin.

1. Plugin setup uses the legacy config

The skill says to put plugins under analyzer: plugins: and add them as dev dependencies. That's the legacy setup, not the setup for the modern plugin system introduced in Dart 3.10 / Flutter 3.38.

For modern plugins, use a top-level plugins: section. The analysis server resolves plugin dependencies separately, so adding the plugin to the project's pubspec.yaml isn't needed just to enable it.

The skill also leaves out that plugin warnings are on by default, but lint rules are off unless enabled under the plugin's diagnostics: key, directly or through an included options file.

Example, with placeholder package and rule names:

plugins:
  my_plugin:
    version: ^1.0.0
    diagnostics:
      rule_1: true
      rule_2: false

Please update the guidance to distinguish modern and legacy plugins, include lint activation, and mention restarting the analysis server after changing plugins:. The current instructions don't enable a modern-only plugin through the modern loader.

2. The example's include path doesn't exist

include: package:flutter_lints/recommended.yaml

flutter_lints 6.0.0 ships lib/flutter.yaml, not lib/recommended.yaml. Use the documented include:

include: package:flutter_lints/flutter.yaml

For pure Dart, use package:lints/recommended.yaml. This also matches the skill's own Base Configuration bullet.

3. missing_return is obsolete

The example sets missing_return: error. The analyzer lists MISSING_RETURN among its removed diagnostic codes. It's still accepted for compatibility, but the override no longer does anything. Please remove it from the example.

Environment

  • Model: Claude Opus 5.5.
  • Harness: Claude Code, with a plugin that vendors these skills.
  • Dart/Flutter SDK: Dart 3.13.4, Flutter 3.47.5.

The same file exists in dart-lang/skills, which syncs into this repository, so the fix needs to happen upstream.

Langage dominant
Dart
Étoiles
3.1k
Forks
182
Merge moyen
3 j 6 h
PR mergées (30 j)
4

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de flutter/agent-plugins

Toutes les issues de flutter/agent-plugins

Issues similaires

Plus d'issues Dart

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.