Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

docs: clarify gh api -f vs -F and @-file expansion in the gh skill

Aperta Adatta ai principianti
  • Qualcosa non va?
#14,701 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@MatiasOlivera ci sta già lavorando.

Dal 15/10/2026.

  • #14700 di @MatiasOlivera — aperta

Valutazione

Difficoltà
2/5
Tempo stimato
Mezza giornata
Idoneità per principianti
62/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
github, markdown
Ambito
cli, documentation

Direzione di ricerca

Inizia dalla sezione gh api di skills/gh/SKILL.md e confrontala con il comportamento dei flag elencati nell'issue: -f/--raw-field rispetto a -F/--field, l'espansione di @file e @-, e i segnaposto {owner}, {repo} e {branch}. Verifica l'opzione --input con la tua chiamata di prova prima di scrivere qualsiasi cosa. È completato quando la sezione descrive le differenze per ciascun flag, spiega --input per l'ambiguità di @ e aggiunge un passaggio di rilettura per verificare le mutazioni. Confrontati con i maintainer su quali di questi punti vogliono che siano documentati prima di scrivere il testo.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

enhancement
Summary

Agents frequently mishandle gh api field flags when constructing mutations. Values starting with @ are treated as file references under -F/--field, typed literals are converted, and {owner}/{repo}/{branch} is expanded, while -f/--raw-field sends raw strings. This causes accidental file reads, wrong types, and failed bodies. The official skill's gh api section does not document the distinction or the --input escape hatch.

Acceptance Criteria
  • skills/gh/SKILL.md documents the difference between -f/--raw-field and -F/--field, including typed conversion and @file/@- expansion.
  • Clarifies placeholders {owner}, {repo}, {branch} behavior per flag.
  • Documents --input as the way to avoid `@) ambiguity.
  • Adds guidance to re-read the mutated object to verify changes.
Scope

Documentation only in skills/gh/SKILL.md. No CLI code changes.

Out of scope
  • General gh usage.
  • Changing gh api behavior itself.

Requesting maintainers add help wanted if this is accepted, so the accompanying PR can follow contribution rules.

Lingua principale
Go
Stelle
46.7k
Fork
9.2k
Merge medio
2g 1h
PR unite (30g)
40

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di cli/cli

Tutte le issue di cli/cli

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.