mcpField
F
file-links

file-links

github.com/xenodiumAgent 工作流14782 次安装14 周前更新
代码仓库

关于 file-links

file-links 是一项 Agent 技能,可将文件引用格式化为 Markdown 链接,并使用 GitHub 风格的行号片段。它适用于需要清晰指向文件及相关代码位置的输出。

主要功能

  1. 01文件引用转为 Markdown 链接
  2. 02使用 GitHub 风格行号片段
  3. 03链接文本与网址均标注行范围
  4. 04使用相对项目根目录的路径

适用场景

  1. 01引用不带行号的文件
  2. 02指向错误所在位置
  3. 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