用途:这是一个面向 Cursor 产品与配置问题的本地文档镜像技能,适合查询 Agent 及其工具、Agent Skills、Rules、Hooks、Model Context Protocol(MCP)、Subagents、Plugins、Cursor CLI、云代理、模型与定价、SDK、集成,以及账户、团队和参考文档。若问题涉及 Claude Code、OpenAI Codex、Anthropic API 或其他非 Cursor 产品,则不适用;Cursor 企业管理员文档有意未镜像。
主要能力:清理后的 Markdown 存放在 references/ 目录;自动生成的主题列表在 references/INDEX.md;带上游 URL 的逐文件清单在 references/docs_manifest.json。镜像由上游 CI 每 3 小时刷新,失败时不会提交冻结内容。
使用方式:若用户给出主题,先规范化为 slug——转小写,去掉开头的 https://cursor.com/docs/ 或 /docs/,去掉首尾斜杠,嵌套层级用 __ 连接(如 agent overview 对应 agent__overview,reference permissions 对应 reference__permissions)。若 references/<slug>.md 存在,直接读取该文件,不要先对整个 references/ 目录做 grep。若无精确匹配,读取 references/INDEX.md 并选择最接近的主题;仍不明确时列出候选并询问。若用户未给主题,读取 references/INDEX.md 并展示可用主题。回答时先给出基于所读文件的直接答案,逐字引用文档中的短片段(命令、配置键),最后以 Source: <上游 URL> 结尾,URL 取自文件 frontmatter 的 source 或 references/docs_manifest.json 的 original_url。
限制与回退:若本地内容看起来过时、与用户说法矛盾或为空,可建议用户运行 npx skills update cursor-docs;检查 references/docs_manifest.json 中该文件条目,status 为 stale 表示上次运行无法访问上游;通过 original_url 核对规范 URL 并作为后续来源提供。
示例调用:/cursor-docs hooks 读取 references/hooks.md;/cursor-docs mcp 读取 references/mcp.md;/cursor-docs skills 读取 references/skills.md;/cursor-docs agent overview 读取 references/agent__overview.md;/cursor-docs reference permissions 读取 references/reference__permissions.md;/cursor-docs(无参数)读取 references/INDEX.md。