Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#63,483 3 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
78/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
go
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu bằng cách kiểm tra ba tệp được nêu: .github/skills/awf-release-integrator/SKILL.md, .github/skills/otel-queries/SKILL.md và .github/skills/messages/SKILL.md, sau đó xác minh từng đường dẫn được tham chiếu trong cây làm việc. Cập nhật các tham chiếu để trỏ đến những tệp hiện có đã được xác nhận, hoặc xóa các tham chiếu bị hỏng khi không có tệp thay thế. Hoàn tất nghĩa là cả ba liên kết đều dẫn người đóng góp đến tài liệu hoặc tệp mã nguồn hợp lệ, phù hợp.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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
Ngôn ngữ chính
Go
Star
5.3k
Fork
568
Merge trung bình
5 giờ 57 phút
Pull request đã merge (30 ngày)
647

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của github/gh-aw

Tất cả issue của github/gh-aw

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.