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

[deep-report] Fix 3 broken file-path references in .github/skills/*/SKILL.md

Chiusa Adatta ai principianti
  • Qualcosa non va?
#63,483 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
78/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
go
Ambito
documentation

Direzione di ricerca

Inizia ispezionando i tre file indicati: .github/skills/awf-release-integrator/SKILL.md, .github/skills/otel-queries/SKILL.md e .github/skills/messages/SKILL.md, quindi verifica ogni percorso referenziato nell’albero di lavoro. Aggiorna i riferimenti in modo che puntino ai file esistenti confermati, oppure rimuovi i riferimenti non validi quando non esiste alcun sostituto. Il lavoro è completato quando tutti e tre i link indirizzano i contributori a documentazione o file sorgente validi e appropriati.

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

Descrizione

automation code-quality cookie documentation improvement quick-win task-mining
Description

A targeted repo-relative path audit of .github/skills/*/SKILL.md files (from Repository Quality Improvement Report #63445) found 3 confirmed-broken references, independently re-verified directly against the working tree in this run:

  1. awf-release-integrator/SKILL.md:32-33 points to docs/awf-config-spec.md and docs/awf-config.schema.json — neither exists. The real files are specs/awf-config-sources-spec.md and pkg/workflow/schemas/awf-config.schema.json.
  2. otel-queries/SKILL.md:274 points to docs/src/content/docs/guides/custom-otlp-attributes.md — this file was never created.
  3. messages/SKILL.md:68 tells contributors to "update the workflow parser in pkg/workflow/safe_outputs.go" — that file no longer exists as a single file; it was split into 113 safe_outputs_*.go files with no single-file successor of that name.
Suggested fix
  • Update awf-release-integrator/SKILL.md to point at specs/awf-config-sources-spec.md and pkg/workflow/schemas/awf-config.schema.json.
  • Either create docs/src/content/docs/guides/custom-otlp-attributes.md or update otel-queries/SKILL.md to point at the correct existing doc (or remove the dangling reference).
  • Update messages/SKILL.md to reference the appropriate pkg/workflow/safe_outputs_*.go file(s) instead of the removed monolithic file.
Expected Impact

Prevents contributors (human or agent) following these skills from being sent to nonexistent files, which currently silently derails onboarding to these specific workflows.

Suggested Agent

Documentation update, low-risk.

Estimated Effort

Quick (< 1h)

Data Source

DeepReport Intelligence Briefing analysis (2026-09-25, cycle 3), sourced from Repository Quality Improvement Report #63445.

Generated by 🔬 Deep Report · claude · agent · 202.3 AIC · ⌖ 9.81 AIC · ⊞ 13K · ◷

  • expires on Sep 27, 2026, 10:39 AM UTC-08:00
Lingua principale
Go
Stelle
5.2k
Fork
547
Merge medio
6h 49m
PR unite (30g)
696

Preparare l'ambiente

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 github/gh-aw

Tutte le issue di github/gh-aw

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.