use-cli-ast-greplisted

# use-cli-ast-grep ## 使いどころ 構文木の形で一致させる検索・書き換えに限る。テキストや正規表現の一致は ugrep と bfs に、シンボル単位の呼び出しグラフは codegraph に残す。 | 問い | ツール | | --------------------------------------------- | ----------- | | AST パターンによる構文木単位の一致・書き換え | ast-grep | | 自由記述・リテラル文字列・正規表現の検索 | ugrep / bfs | | シンボル単位の呼び出し元 / 先・変更の波及範囲 | codegraph | | 既知の 1 箇所を読む・直接編集する | Read / Edit | ## コマンド `run` が単発の検索・書き換え、`scan` がルールファイルによる一括適用、`outline` がシンボル一覧の抽出にあたる。 | 目的 | コマンド | | -------------------------------------- | ------------------------------------------------------------- | | パターン検索 | `ast-grep run -p '<pattern>' -l <lang> <PATHS>` | | パターン書き換え (対話確認あり) | `ast-grep run -p '<pattern>' -r '<fix>' -l <lang> -i <PATHS>` | | パターン書き換え (確認なし一括適用) | `ast-grep run -p '<pattern>' -r '<fix>' -l <lang> -U <PATHS>` | | ルールファイルによるスキャン・書き換え | `ast-grep scan -r <rule.yml> <PATHS>` | | シンボル一覧 (構造の把握) | `ast-grep outline -l <lang> <PATHS>` | | JSON 出力 | `ast-grep run -p '<pattern>' --json <PATHS>` | ## 前提 呼び出しにあたり、次の 3 つを必須の制約とする。 | 項目 | 詳細 | | --------------------- | --------