comment-code コードにコメント・ドキュメンテーションコメントを追加・補強する。コードの実装は変更せず、役割の境界・呼び出し元の前提・返値の契約・他所との依存を「その場で読める」形で記述することが目的。 使い方 引数を省略した場合は の差分ファイルを対象とする。 を指定するとドキュメンテーションコメントの形式(JSDoc / docstring / rustdoc 等)を優先言語として扱う。指定がない場合は拡張子から自動判定する。 前提条件 - 対象ファイルが読み取り可能な状態であること - Git リポジトリ内であること(引数省略時に を使用するため) フロー Step 1: 対象ファイルを特定する 引数が指定された場合はそのファイル・ディレクトリを対象にする。 対象が空(変更なし・引数なし)の場合はユーザーに対象を確認する。 Step 2: 対象の役割をコードベースから調査する このステップが最も重要。 ファイル単体だけを見るのではなく、システム全体の中での位置づけを把握する。 2-1: 呼び出し元を調査する 対象ファイルが公開するシンボル(関数・クラス・型・定数)をコードベース全体で検索し、どのレイヤー・どのサービスから呼ばれているかを把握する。 2-2: import・依存関係を確認する 対象ファイルが依存している外部モジュール・サービス・設定を把握する。 2-…