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

Add guidance on GitHub autolinked reference formatting for AI agents

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#3,042 2 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
1/5
Temps estimé
Moins d'une heure
Accessibilité débutants
88/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
go
Domaine
tooling

Piste de recherche

Commencez dans pkg/github/toolset_instructions.go, au niveau de generateContextToolsetInstructions(), et comparez les instructions existantes de github_support_docs_search. Vérifiez que le contexte de base généré inclut un lien concis vers la documentation de GitHub sur les références autolinkées avant l’utilisation des outils de création de contenu. C’est terminé lorsque les instructions couvrent les références d’issue, de pull request, de commentaire et de discussion, sans ajouter de nouvel outil ni le dupliquer dans d’autres toolsets.

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

Description

enhancement
Describe the feature or problem you'd like to solve

AI agents using the MCP server create manual markdown links when they could use GitHub's built-in autolinked references instead. GitHub automatically renders patterns like #123, @username, and owner/repo#123 as clickable links across issues, pull requests, comments, and discussions—but agents lack this knowledge in their system instructions.

For complete reference and examples, see:
https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls

Proposed solution

Add guidance to the base context instructions (via generateContextToolsetInstructions()) so all agents learn about autolinked references before using any content-creation tools. This ensures consistent formatting across all GitHub interactions without duplicating guidance in multiple toolsets.

Benefits:

  • Universal coverage: Applies to all content-creation tools (issues, PRs, comments, discussions)
  • Single source of truth: One place to maintain, not scattered across toolsets
  • Early discovery: Agents see this guidance at initialization, before using any specific tool
  • No duplication: Leverage official docs instead of repeating content

Implementation:

Add a section to pkg/github/toolset_instructions.go in generateContextToolsetInstructions():

func generateContextToolsetInstructions(_ *inventory.Inventory) string {
    return `Always call 'get_me' first to understand current user permissions and context.

### GitHub Autolinked References

When creating issues, pull requests, comments, or discussions, use GitHub's autolinked reference syntax—issue numbers (#123), user mentions (@example-username), and cross-repo references (example-owner/example-repo#123)—so GitHub renders them as links automatically.
See the official docs for complete details: https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md`
}

This approach follows the existing pattern of github_support_docs_search, which references official documentation rather than duplicating content.

Additional context

This is a lightweight enhancement that integrates seamlessly into the existing base context instructions. No new tools or infrastructure required—just a brief instruction pointing agents to official GitHub docs.

Future enhancement:
If agents need to proactively request formatting guidance (e.g., "How should I format this reference?"), consider creating a dedicated resource or skill in the MCP server. This would allow agents to ask for formatting help on-demand while still having the baseline guidance available at initialization. This can be explored as a follow-up if needed.

Langage dominant
Go
Étoiles
33.3k
Forks
5.1k
Merge moyen
1 j 1 h
PR mergées (30 j)
19

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 github/github-mcp-server

Toutes les issues de github/github-mcp-server

Issues similaires

Plus d'issues Go

Recevez les nouvelles issues par e-mail

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