开发人员文档通常在每个文件中包含描述。这些描述可能会过时，导致混乱和不正确的信息。为了防止这种情况，您可以使用一些 ai 和 genaiscript 自动检测文档中过时的描述。
markdown 和 frontmatter
许多文档系统使用 markdown 格式来编写文档，并使用“frontmatter”标头来存储元数据。这是带有 frontmatter 的 markdown 文件的示例：
---title: "my document"description: "this is a sample document."---# my documentlorem ipsum dolor sit amet, consectetur adipiscing elit.
登录后复制
目标是创建一个脚本来检测 frontmatter 中的描述字段何时过时。
剧本
genaiscript 旨在在文件上运行，并提供一个特殊变量 env.files，其中包含要分析的文件列表。您可以使用该变量通过 def 函数将文件包含在上下文中。我们将每个文件限制为 2000 个令牌，以避免大文件上的内容爆炸。
// define the file to be analyzeddef("docs", env.files, { endswith: ".md", maxtokens: 2000 })
登录后复制
下一步是给脚本分配任务。在这种情况下，检查 frontmatter 中的内容和描述字段是否匹配。
// analyze the content to detect outdated descriptions$`check if the 'description' field in the front matter in docs is outdated.`
登录后复制
最后，我们利用内置的诊断生成功能为每个过时的描述创建错误。
// enable diagnostics generation$`generate an error for each outdated description.`
登录后复制
在 visual studio 代码中运行
将此脚本保存到工作区后，您将可以通过上下文菜单在文件或文件夹上执行它
通过选择运行 genaiscript….
自动化
您可以在文档文件上自动运行此工具，以使用 cli 识别过时的描述。
npx --yes genaiscript run detect-outdated-descriptions **/*.md
登录后复制
此脚本可以集成到您的 ci/cd 管道中以自动化检测过程。
以上就是使用人工智能检测过时的描述的详细内容，更多请关注【创想鸟】其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至253000106@qq.com举报，一经查实，本站将立刻删除。
发布者：PHP中文网，转转请注明出处：https://www.chuangxiangniao.com/p/2670420.html
