Makedown 任务运行器

要解决的具体问题

当你在 DEMO.md 里写满 npm install 和 pytest 的组合时，每次都要手动复制命令、确认执行顺序——任务之间的依赖关系像散落的拼图，稍不注意就会漏掉前置步骤。更麻烦的是，文档里的代码块没有明确标注“这个任务需要先跑完那个任务”，新人接手时得逐行读注释才能理清逻辑。

技能如何工作

核心能力

• 提取可执行任务：扫描Markdown中的围栏代码块，识别带任务元数据注解的片段，将其转化为可运行的shell管道；
• 解析元数据：从代码块的注解中提取任务名、依赖项等信息，比如通过 task: build 标记任务名，depends: clean, lint 声明依赖；
• 管理依赖关系：根据元数据自动构建任务的执行顺序，避免手动梳理依赖链。

关键步骤

1. 解析Markdown中的围栏代码块，筛选出带有 task、depends 等注解的片段；
2. 提取注解中的任务名和依赖项，将分散的任务组织成有向图结构；
3. 对任务执行拓扑排序，确定每个任务的执行顺序；
4. 按顺序将任务对应的shell管道推送到终端执行，并捕获输出结果。

适用边界与注意点

• 依赖系统已安装Python解释器，因为在Unix-like系统中Python通常是预装的，能保证更好的可移植性；
• Markdown中的代码块必须使用规范的注解格式，否则无法识别为可执行任务；
• 适合管理单个文档内的任务依赖，若涉及跨文档或跨项目的复杂依赖，可能需要结合其他工具使用。