Generated AGENTS.md links to missing static/llms.txt
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 78/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
- 技術スタック
- javascript
- 領域
- documentation, tooling
調査の方向性
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
- Inspect
docs/AGENTS.md. - Find the
Staticentry under the LLM entry point section. - Check that
docs/static/llms.txtis 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
コントリビューションガイド
このリポジトリのコントリビューションガイドは索引されていません
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
base/docs のほかの issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 95/100
-
難易度 1/5 1時間未満 初心者へのやさしさ 95/100
-
難易度 1/5 1時間未満 初心者へのやさしさ 95/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
HarperFast/skills#96 ·
-
[Block] Latest Posts [Type] Bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
Automattic/studio#4908 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 86/100
sugarlabs/musicblocks#8847 ·