Markdown ファイルインデックスの更新

マークダウンファイル ${file} を、フォルダ ${input:folder} からのファイルのインデックス/テーブルで更新します。

処理フロー

1. スキャン: ターゲットのマークダウンファイル ${file} を読み込み、既存の構造を理解する
2. 発見: 指定されたフォルダ ${input:folder} 内のすべてのファイルをパターン ${input:pattern} に合わせてリストアップ
3. 分析: 既存のテーブル/インデックスセクションが存在するかを確認し、更新するか新規構造を作成するか判定
4. 構造化: ファイルタイプと既存コンテンツに基づいて、適切なテーブル/リスト形式を生成
5. 更新: 既存セクションを置き換えるか、新しいセクションでファイルインデックスを追加
6. 検証: マークダウン構文が有効で、フォーマットが一貫していることを確認

ファイル分析

検出されたファイルごとに、以下を抽出します:

• 名前: コンテキストに基づいて、拡張子の有無を含めたファイル名
• タイプ: ファイル拡張子とカテゴリ (例: .md, .js, .py)
• 説明: 最初の行のコメント、ヘッダー、または推定される目的
• サイズ: ファイルサイズ (オプション)
• 更新日時: 最終更新日時 (オプション)

テーブル構造オプション

ファイルタイプと既存コンテンツに基づいてフォーマットを選択します:

オプション 1: シンプルリスト

## Files in ${folder}

- [filename.ext](path/to/filename.ext) - Description
- [filename2.ext](path/to/filename2.ext) - Description

オプション 2: 詳細テーブル

File	Type	Description
filename.ext	Extension	Description
filename2.ext	Extension	Description

オプション 3: カテゴライズセクション

ファイルをタイプ/カテゴリごとにグループ化し、個別のセクションまたはサブテーブルで表示します。

更新戦略

• 🔄 既存のものを更新: テーブル/インデックスセクションが存在する場合、構造を保持しながらコンテンツを置き換える
• ➕ 新規追加: 既存セクションがない場合、最適なフォーマットで新しいセクションを作成
• 📋 保持: 既存のマークダウンフォーマット、見出しレベル、ドキュメントフローを保持
• 🔗 リンク: リポジトリ内のファイルリンクには相対パスを使用

セクション識別

これらのパターンを含む既存セクションを探します:

• 見出しに含まれる単語: "index", "files", "contents", "directory", "list"
• ファイル関連のカラムを含むテーブル
• ファイルリンク付きのリスト
• ファイルインデックスセクションをマークする HTML コメント

要件

• 既存のマークダウン構造とフォーマットを保持する
• ファイルリンクに相対パスを使用する
• 利用可能な場合はファイルの説明を含める
• デフォルトではファイルをアルファベット順にソートする
• ファイル名の特殊文字に対応する
• 生成されたすべてのマークダウン構文を検証する