file-links について
file-links は、ファイル参照を GitHub 形式の行番号フラグメント付き Markdown リンクに整えるエージェントスキルです。ファイルやコード位置を明確に示す出力に適しています。
主な機能
- 01ファイル参照の Markdown リンク化
- 02GitHub 形式の行番号フラグメント
- 03リンク文字列と URL への範囲指定
- 04プロジェクトルート相対パス
活用シーン
- 01行番号なしでファイルを示す
- 02エラー箇所を示す
- 03関数やコードブロックへリンクする
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ xenodium/ emacs-skills --skill file-linksインストール後、Claude Code で/file-linksを入力して読み込まれたか確認します。
詳細
ファイル参照は Markdown リンクとして記述する
出力でファイルを参照する場合は、必ず Markdown リンクとして記述してください。行番号には GitHub 形式の #L フラグメントを使用してください。
書式
行番号がある場合:
[filename.el:42](relative/path/to/filename.el#L42)
行範囲がある場合:
[filename.el:42-50](relative/path/to/filename.el#L42-L50)
行番号がない場合:
[filename.el](relative/path/to/filename.el)
重要
- リンクテキストでは、行番号に
:を使用します(例:filename.el:42)。 - URL では、行番号に
#Lを使用します(例:filename.el#L42)。 - 範囲の場合、リンクテキストでは
-(例:filename.el:42-50)を使用し、URL では-L(例:filename.el#L42-L50)を使用します。 - 範囲はリンクテキストと URL の両方に記述してください。
次のようにしてはいけません:
[filename.el#L42-L50](filename.el#L42)
ルール
- プロジェクトのルートからの相対パスを使用してください。
- 行番号が関連する場合(例:エラー箇所、関数定義、変更行)は、行番号を含めてください。
- コードブロックを参照する場合は、行範囲を使用してください。
- リンクテキストには、ファイル名(または明確にする必要がある場合は相対パス)の後に行番号を記載してください。
コメント
Markdown 対応