markdown_validator｜Markdown语法检查与修正Agent示例

这是CrewAI官方示例仓库里一个已归档的演示项目，目标是用多智能体框架完成一项具体小任务：读取指定Markdown文件，调用自定义校验工具取得Lint问题，再由智能体把问题归纳成一份可直接交给开发者的修改清单。请注意，仓库已归档，说明它只是历史示例，不构成持续维护的产品，后续框架版本兼容性待核验，也不应视为可直接上线的成熟工具。

适用人群：想了解CrewAI智能体、任务与自定义工具如何配合的开发者；需要快速获得Markdown格式问题清单的文档维护者；希望参考“工具调用结果转行动项”提示设计的团队。

实际流程：运行脚本时传入文件名，任务描述要求智能体必须以固定格式调用markdown_validation_tool，只传路径；工具返回校验结果后，智能体把结果整理为修改建议列表。任务明确要求不提供修法示例、不推荐其他工具、不改写正文内容，只输出变更清单。项目还提供训练入口，可运行若干轮并根据用户反馈调整结果。

输入输出：输入是一个本地Markdown文件路径；输出是文本形式的待改变更列表，不含自动改写后的文件。

获取与安装步骤：从GitHub获取该示例目录；把.env.example重命名为.env，并按README说明填写模型、接口地址与API密钥；用Poetry安装依赖（poetry install --no-root，另有poetry lock步骤）；随后按README执行python main.py 文件名，或以poetry run markdown_validator 文件名运行。依赖中声明了crewai、python-dotenv、markdown、pymarkdownlnt及Python版本范围，均以仓库文件为准，未实测。

示例任务：给出一份项目README，运行校验，得到诸如“某行标题层级不连续、列表缩进不规范”之类的条目化建议，由人工决定是否改稿。

限制与注意：仓库已归档，维护状态与依赖兼容性待核验；项目要求通过OpenAI兼容接口调用模型，可指向本地服务或远程端点，需自备API密钥并承担调用费用，费用与额度待核查；国内网络访问与模型可用性待核查。许可证方面，README称采用MIT许可，但仓库元数据标注未声明许可，二者存在冲突，再分发与商用前须人工确认，不得假定允许再分发。该示例只做格式建议，不保证内容正确性；不自动修改文件，也不应未经人工复核直接把输出当作最终修订。个人信息与密钥请勿写入示例配置。

官方来源：https://github.com/crewAIInc/crewAI-examples/blob/da94a91e691e1cf5b3151416bb15b5b62729bea8/crews/markdown_validator/README.md

作者/维护方：crewAIInc/crewAI-examples。采集日期：2026-11-13；依据官方资料经AI整理，未安装、运行或实测。

许可说明：README称MIT，仓库元数据标注未声明，冲突待核验；不得假定允许再分发。具体子目录、依赖、模型和在线服务各自适用其条款。本站提供原创说明和来源入口，不随本文分发源码或凭据。