Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン 初心者向け
#63,483 コメント 3 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1時間未満
初心者へのやさしさ
78/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
go
領域
documentation

調査の方向性

まず、指定された3つのファイル(.github/skills/awf-release-integrator/SKILL.md、.github/skills/otel-queries/SKILL.md、.github/skills/messages/SKILL.md)を調査し、その後、参照されている各パスをワーキングツリーに対して確認します。確認済みの存在するファイルを参照するように参照先を更新するか、置き換えが存在しない場合は壊れた参照を削除します。完了とは、3つすべてのリンクがコントリビューターを有効で適切なドキュメントまたはソースファイルに導く状態です。

索引モデルが issue の本文から書いたものです。

説明

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
主要言語
Go
スター
5.2k
フォーク
547
平均マージ
6時間 32分
マージ済み PR(30日)
743

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

github/gh-aw のほかの issue

github/gh-aw の issue をすべて見る

似ている issue

Go の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。