用途:为某个目标文件夹生成或更新 index.md,把该文件夹内的所有文档整理成可导航的索引。当用户要求为特定文件夹创建或更新文件索引时使用。
主要能力:扫描目标目录中的全部文件与子目录;按文件类型、用途或子目录进行分组;读取每个文件内容以理解其实际用途,并生成 3 到 10 个词的简短描述,而不是仅凭文件名猜测;最后写入或更新 index.md。
输出格式:以“Directory Index”为标题,先列出文件,再列出子目录;每个条目使用以 ./ 开头的相对路径链接,后接简短描述;子目录下按子文件夹分组列出其中的文件。
执行步骤:第一步扫描目录,列出目标位置的所有文件和子目录;第二步按类型、用途或子目录分组内容;第三步读取每个文件生成准确描述;第四步创建或更新 index.md。
校验要求:使用以 ./ 开头的相对路径;将相似文件归为一组;读取文件内容生成描述而非猜测;描述保持简洁但信息充分(3 到 10 个词);组内按字母顺序排序;除非特别指定,跳过以点开头的隐藏文件。
限制与中止条件:如果目标目录不存在或无法访问,则中止;如果用户没有创建 index.md 的写入权限,则中止。