关于 file-links
file-links 是一项 Agent 技能,可将文件引用格式化为 Markdown 链接,并使用 GitHub 风格的行号片段。它适用于需要清晰指向文件及相关代码位置的输出。
主要功能
- 01文件引用转为 Markdown 链接
- 02使用 GitHub 风格行号片段
- 03链接文本与网址均标注行范围
- 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