Generated AGENTS.md links to missing static/llms.txt

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

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

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
78/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
静か
技術スタック
javascript

調査の方向性

scripts/agents.js と scripts/lib/docs-utils.js から始め、次に docs/AGENTS.md と docs/static/ ディレクトリを調べます。discoverTopLevelSections() が CONSTANTS.skipDirs をどのように使っているかを追跡し、生成されたインデックスが ./static/llms.txt にリンクしなくなっていることを確認します。生成された llms.txt が存在する場合を除き、アセットのみのディレクトリが除外されれば完了です。

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

説明

Summary

The generated docs/AGENTS.md currently includes this entry:

- [Static](./static/llms.txt)

However, docs/static/llms.txt does not exist. The repository has a docs/static/ directory, but it appears to contain static assets rather than a documentation section with its own generated llms.txt file.

Where it seems to come from

docs/AGENTS.md is generated by scripts/agents.js, which calls discoverTopLevelSections() from scripts/lib/docs-utils.js.

discoverTopLevelSections() includes top-level directories unless they are listed in CONSTANTS.skipDirs. static is not currently in that skip list, so the generator treats docs/static/ as a docs section and emits a link to ./static/llms.txt.

Expected behavior

The generated AGENTS index should not link to ./static/llms.txt unless that file is generated/committed. If docs/static/ is only an asset directory, it should likely be skipped by the section discovery logic.

Reproduction
  1. Inspect docs/AGENTS.md.
  2. Find the Static entry under the LLM entry point section.
  3. Check that docs/static/llms.txt is missing.
Possible fix

Add static to the docs generator skip list, or otherwise exclude asset-only directories from discoverTopLevelSections().

主要言語
JavaScript
スター
337
フォーク
798
平均マージ
7時間 24分
マージ済み PR(30日)
51

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

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

base/docs のほかの issue

base/docs の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

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

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