Skip to content
This repository was archived by the owner on Jul 16, 2026. It is now read-only.
This repository was archived by the owner on Jul 16, 2026. It is now read-only.

Bug: agents-lint reports false-positive path errors on workspace-level doc references #4

Description

@lennney

描述

agents-lint 将文档中所有 path-like 文本作为实际文件路径校验,在 workspace 级 AGENTS.md 产生大量误报。

误报示例

文档原文 上下文 误报类型
图片在 \public/images/` — 引用为 `/images/filename.jpg`` 路径模式示例 ✖ Path does not exist: "/images/filename.jpg"
\@web3rdweb/shared` — npm 包源码` npm 包名 ✖ Path does not exist: "@web3rdweb/shared"
nginx 配置在 \/etc/nginx/`` 远程服务器路径 ✖ Path does not exist: "/etc/nginx/"
SSH 配置在 \~/.ssh/config`` 用户 home 目录 ✖ Path does not exist: "~/.ssh/config"
共享组件来自 \@web3rdweb/shared`, NOT in `src/components/`` 架构说明 ✖ Path does not exist: "src/components/"

Workspace 级文档不可避免地会引用远程路径、模式路径和 npm 包名。这些都是有效的说明文字,不是文件路径。

建议修复

  • 对 backtick 内(`…`)的路径引用宽松处理
  • 或允许在文档中用 tag 标记忽略区域: <!-- lint:ignore-path --> / <!-- lint:resume -->
  • 或只对明确的相对路径(开头为 ./ 或 ../)做校验

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions