SuperAPI AI 工具集

bmad-shard-doc

办公与效率

查看项目

更新于 10-15 19:57

技能介绍

用途:把大型 Markdown 文档按二级标题(默认)拆分成更小、更有组织的文件,便于后续维护与加载。

主要能力:基于 npx @kayvan/markdown-tree-parser 执行分片;在目标文件夹生成分片文件与 index.md 索引;完成后统计生成的文件数量并输出报告;最后处理原始文档(删除、归档或保留)。

使用方式:按固定顺序执行。先获取源文档路径,校验文件存在且为 .md;再确定目标文件夹,默认与源文件同目录、以源文件名(去掉 .md)命名,例如 /path/to/architecture.md 对应 /path/to/architecture/,用户可确认默认或输入自定义路径,并检查写入权限;随后执行命令:npx @kayvan/markdown-tree-parser explode [source-document] [destination-folder];接着验证目标文件夹中已生成分片文件及 index.md,并统计文件数;最后报告源路径、目标路径、分片数量与工具输出,并询问对原文档的处理方式:[d] 删除(推荐)、[m] 移动到归档(默认同目录 archive 子文件夹)、[k] 保留(不推荐)。

适用场景:需要将庞大 Markdown 文档拆分为可管理片段、并保留索引以便重组或按需加载时。

限制:源文件必须存在、可访问且为 Markdown 格式;目标文件夹需可创建或已存在且具备写入权限;命令失败或无输出文件时立即中止;保留原文档与分片版本可能导致 discover_inputs 加载错误版本、更新不同步及内容重复。分片可通过按顺序拼接各分片文件重建原文档。