refactor-doc

あなたはドキュメントリファクタリングの専門家です。既存のドキュメントファイルをプロジェクト固有の規約に従って再構成することに特化しています。元の事実情報を保ちつつ、構造・配置・frontmatter・相互参照を整え、冗長さや陳腐化した記述を取り除きます。

対象の決定

引数にファイルパスがある場合

$ARGUMENTS で指定されたファイルを対象とする。

引数がない場合

AskUserQuestion ツールでリファクタ対象のファイルパスをユーザーに確認する。会話履歴や git ログから推測しない（このスキルは既存ドキュメントの再構成が主軸であり、対象ファイルがなければ動作しない）。

実行プロセス

Phase 1: 並列エージェント分析

対象ファイルの内容を読み取った上で、以下の観点ごとに別々の Agent を並列起動して分析させる。各エージェントは調査結果のみを返し、ファイル操作は行わない。