Skip to content

docs/tools.md の目次アンカー整合性を検証する meta テストを追加 #707

Description

@fumtas1k

背景

PR #706docs/tools.md の目次を全 27 ツール網羅へ更新した。その際のレビューで指摘された改善提案を issue 化する。

現状 tests/meta/tools-docs-coverage.test.tssrc/data/tools.tsdocs/tools.md### 見出しカバレッジ(欠落 / orphan / 重複)を CI で強制しているが、目次(目次セクション)のアンカーリンク自体の整合性は無保護

そのため、将来見出しをリネーム・追加した際に目次の [...](#anchor) リンクが silent break しうる(PR #706 では全 31 リンクを github-slugger で機械照合し破損 0 件を確認済みだが、これは恒久的なガードではない)。

提案

docs/tools.md の目次内アンカーリンクが、実在の見出しから生成される GitHub slug と一致することを検証する meta テストを追加する。

  • 本文の H2/H3 見出しから github-slugger(GitHub と同一の slug 生成器。devDependency として追加要否を確認)で実アンカーを生成
  • 目次セクションの [...](#...) リンクを抽出し、生成アンカー集合と機械照合
  • 破損リンク(参照先の見出しが存在しない)を fail として検出

test-gates 要件

これは「検知機構(validator)」の追加にあたるため、test-gates skill に従い 陽性対照(意図的に壊れたアンカーを注入すると検出される / 正常時は過検知しない)を必ず併設する。

スコープ

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions