相关 Skills
SKILL.md
readonly只读
name
update-markdown-file-index
description
使用指定文件夹中的文件索引/表格更新 Markdown 文件中的某个部分。
更新 Markdown 文件索引
使用文件夹 ${input:folder} 中的文件索引/表格更新 Markdown 文件 ${file}。
流程
- 扫描：读取目标 Markdown 文件
${file}以了解现有结构 - 发现：列出指定文件夹
${input:folder}中匹配模式${input:pattern}的所有文件 - 分析：识别是否存在需要更新的现有表格/索引部分，或创建新结构
- 构建：根据文件类型和现有内容生成合适的表格/列表格式
- 更新：替换现有部分或添加新的文件索引部分
- 验证：确保 Markdown 语法有效且格式一致
文件分析
对于每个发现的文件，提取：
- 名称：根据上下文包含或不包含扩展名的文件名
- 类型：文件扩展名和类别（例如
.md、.js、.py） - 描述：第一行注释、标题或推断的用途
- 大小：文件大小供参考（可选）
- 修改时间：最后修改日期（可选）
表格结构选项
根据文件类型和现有内容选择格式：
选项 1：简单列表
## ${folder} 中的文件
- [filename.ext](path/to/filename.ext) - 描述
- [filename2.ext](path/to/filename2.ext) - 描述
选项 2：详细表格
| 文件 | 类型 | 描述 |
|---|---|---|
| filename.ext | 扩展名 | 描述 |
| filename2.ext | 扩展名 | 描述 |
选项 3：分类部分
按类型/类别分组文件，使用单独的部分或子表格。
更新策略
- 🔄 更新现有：如果表格/索引部分存在，则替换内容同时保留结构
- ➕ 添加新部分：如果没有现有部分，则使用最合适的格式创建新部分
- 📋 保留：保持现有的 Markdown 格式、标题级别和文档流程
- 🔗 链接：使用仓库内的相对路径作为文件链接
部分识别
查找具有以下模式的现有部分：
- 包含“索引”、“文件”、“目录”、“列表”等词的标题
- 包含文件相关列的表格
- 包含文件链接的列表
- 标记文件索引部分的 HTML 注释
要求
- 保留现有的 Markdown 结构和格式
- 使用相对路径作为文件链接
- 尽可能包含文件描述
- 默认按字母顺序对文件排序
- 处理文件名中的特殊字符
- 验证所有生成的 Markdown 语法
