AgentSkillsCN

markdown-reader

用于 Markdown 阅读，帮助用户把握标题结构、提取所需内容。对于短句，通常直接阅读即可。

SKILL.md
--- frontmatter
name: markdown-reader
description: 見出し構造の把握や部分抽出が必要な Markdown 読解に使う。短文は通常読解でよい。
compatibility: Python 3 が必要。スキル内の scripts/ ディレクトリのスクリプトを実行する。

Markdown を段階的に読む

いつ使うか

  • •まず見出し構造を把握し、必要な章だけ抽出したいとき
  • •章単位での引用・確認が必要なとき
  • •数行程度の短い Markdown は通常読解で十分

前提

  • •Python 3 が利用可能
  • •スクリプト scripts/md-index.py を使用
  • •対象の Markdown がローカルにある

基本手順（段階的読み込み）

  1. •見出しツリーを表示する
    python3 scripts/md-index.py --tree path/to/doc.md
  2. •読みたい見出し名を正確に選ぶ
  3. •セクションを抽出する
    python3 scripts/md-index.py --section "見出し名" path/to/doc.md ※ スキルディレクトリで実行するか、scripts/md-index.py を絶対パスで指定する

推奨フロー

  1. •まずは大見出し（H1/H2）で --tree
  2. •必要な章だけ --section で読む
  3. •さらに細分化が必要なら小見出しで --section

例

code
python3 scripts/md-index.py --tree README.md
python3 scripts/md-index.py --section "Installation" README.md

注意点

  • •--section は見出し名の完全一致が基本。表記ゆれに注意する
  • •大小文字・全角半角・記号の差は区別される前提で一致させる
  • •目的の見出しが見つからない場合は、見出しレベルや表記を見直す

トラブルシューティング

  • •python3: command not found の場合は Python 3 をインストール
  • •No input provided が出た場合は Markdown ファイルを指定するか stdin を渡す
  • •scripts/md-index.py が見つからない場合は作業ディレクトリかパスを確認
  • •期待した内容が出ない場合は見出し名を再確認する