1. 项目概述当AI助手Cursor遇上Everything技能库如果你和我一样日常开发重度依赖Cursor这款AI驱动的IDE那你肯定也遇到过这样的场景想让它帮你写个单元测试得先花几分钟描述TDD流程想让它重构一段代码又得反复解释重构原则。每次都要“调教”AI助手效率实在不高。最近我在GitHub上发现了一个名为everything-cursor的项目它本质上是一个“技能包”安装器能将一套成熟的AI代理配置、工作流技能和编码规则一键注入到你的Cursor环境中。简单来说everything-cursor是一个命令行工具它从一个名为everything-claude-code的社区技能库中提取大量预定义的、高质量的Markdown配置文件并将它们安装到Cursor IDE读取的特定目录下。安装后你的Cursor就“学会”了诸如TDD测试驱动开发工作流、代码审查代理、安全编码规则等一系列高级技能。你不再需要每次都从零开始给AI下指令而是可以直接调用这些预设好的、经过优化的“技能模板”让AI助手更精准、更高效地理解你的意图并执行复杂任务。这个项目的核心价值在于标准化和可复用性。它把那些在开发者社区中被反复验证有效的AI交互模式固化成了可一键部署的配置。无论你是想提升代码质量、规范团队协作还是单纯想探索Cursor的更多可能性这个工具都能帮你省去大量重复配置的时间。注意根据项目仓库的说明该项目已被归档Archived。主要原因是Cursor与Claude Code共享~/.claude/目录路径而everything-claude-code的技能缓存恰好存放在~/.claude/plugins/cache/中Cursor会扫描整个~/.claude/目录因此通过Claude Code安装的技能会自动在Cursor中生效。所以从技术上讲直接使用源技能库everything-claude-code可能是更直接的选择。不过everything-cursor作为一个封装良好的安装器其设计思路、安装逻辑以及对多包管理器的支持仍然是非常值得学习和参考的案例。2. 核心原理与架构设计解析要理解everything-cursor如何工作我们需要先拆解几个关键概念Cursor的技能系统、技能文件的组织形式以及这个安装器是如何在它们之间搭建桥梁的。2.1 Cursor技能系统的工作机制Cursor允许开发者通过在其配置目录通常是项目根目录的.cursor/或用户主目录的~/.cursor/下放置特定的Markdown.md文件来扩展AI助手的能力。这些文件主要分为四类对应不同的功能模块Agents代理 定义了AI助手的“人格”或“角色”。例如一个名为planner.md的代理文件可能会将AI设定为一个项目规划专家擅长将模糊的需求拆解为具体的开发任务和代码结构。当你在Cursor中激活这个代理时AI的回复风格和思考重点就会向“规划者”倾斜。Skills技能 这是最核心的部分定义了具体的工作流程。例如一个tdd-workflow.md技能文件会详细描述测试驱动开发的完整步骤先写一个失败的小测试再实现最小化代码使测试通过然后重构如此循环。AI在遵循这个技能时会严格按照预设的步骤引导你或替你完成代码。Commands命令 可以理解为“快捷指令”。你可以创建一个refactor.md命令文件里面写好一段提示词比如“请用策略模式重构当前函数”。之后在Cursor中你只需输入/refactorAI就会执行这段复杂的提示词无需你每次都手动输入。Rules规则 定义了代码规范和约束。例如一个security.md规则文件会列出禁止使用的危险函数、必须进行的输入验证等。当AI编写或审查代码时会主动遵循这些规则从而帮助团队保持代码安全性和一致性。这些.md文件的内容本质上是结构化的自然语言提示Prompts它们利用了AI对大段上下文的理解能力。Cursor在运行时会读取这些目录下的文件并将其作为上下文的一部分提供给底层的AI模型如Claude从而“定制化”AI的行为。2.2 Everything-Cursor的桥梁作用everything-cursor项目本身并不生产这些技能文件它是一个“搬运工”和“安装器”。它的核心是一个Git子模块Submodule指向了源技能库affaan-m/everything-claude-code。这个子模块里包含了上述四类文件的大量实例。安装器的工作流程非常清晰拉取资源 通过Git子模块或直接下载获取源技能库中的所有.md文件。交互选择 通过命令行交互询问用户希望将技能安装到哪里当前项目的.cursor/目录还是用户主目录的~/.cursor/目录。智能复制 将源技能库中agents/,skills/,commands/,rules/目录下的所有.md文件复制到用户选择的目标目录下对应的文件夹中。状态管理 在目标目录中维护一个清单Manifest记录哪些文件是它安装的。这个清单在后续的更新、卸载操作中至关重要用于区分“系统文件”和“用户自定义文件”。这种设计实现了关注点分离技能内容的创作和维护由everything-claude-code社区负责而分发、安装和生命周期管理则由everything-cursor这个工具负责。作为用户你只需要一条安装命令就能获得一整套即装即用的AI增强能力。2.3 多运行时支持的设计考量你可能会注意到这个安装器同时支持Deno通过JSR、Node.jsnpm和pnpm。这背后有重要的设计考量降低使用门槛 不是所有开发者都安装了Deno或Node.js。提供多种包管理器入口让用户可以用自己最熟悉的方式安装大大提升了工具的易用性和采纳率。利用生态优势 Deno以其安全性默认无权限和内置工具链著称适合作为一次性执行deno x的脚本载体。而npm/pnpm拥有更庞大的用户基数对Node.js生态的开发者更为友好。技术展示 这也是一种很好的技术实践展示说明了如何用TypeScript编写一个同时兼容Deno和Node.js的工具并通过jsr.json和package.json进行双重发布。在实际的CLI代码中通常会通过判断运行时环境来动态加载不同的模块或执行路径但核心的文件操作逻辑是共享的。这种跨运行时支持虽然增加了初期配置的复杂性但对于一个旨在广泛传播的工具来说是非常有价值的。3. 详细安装与配置实战指南了解了原理我们开始动手。这里我会提供最详细的步骤并穿插我实际操作中遇到的细节和选择背后的原因。3.1 环境准备与安装方式选择首先你需要确保你的系统上安装了Cursor IDE。这是前提。然后根据你的习惯选择一种安装方式。方式一Deno一键执行推荐给追求简洁和安全的用户Deno的方式非常干净因为它允许直接远程执行代码无需先进行全局安装。# 单次执行安装命令 deno run -A jsr:yoshixmk/everything-cursor/cli install运行这行命令时发生了以下几件事deno run命令启动Deno运行时。-A是一个权限标志代表--allow-all。这是一个需要特别注意的安全点。因为安装过程涉及文件系统的读写复制文件到.cursor目录所以需要授予全部权限。对于不熟悉的脚本理论上应该更细化地授予权限如--allow-read --allow-write但为了方便项目使用了-A。如果你对安全性有极高要求可以查阅脚本源码确定所需的具体权限后使用更严格的标志。jsr:yoshixmk/everything-cursor/cli指定从JSRJavaScript Registry拉取名为yoshixmk/everything-cursor的包并执行其cli模块。install是传递给该CLI的命令参数。执行后CLI会首先在终端打印出彩色的欢迎信息然后立即进入安装位置的选择提示。方式二npm/npx方式适合Node.js生态开发者如果你更熟悉Node.js生态使用npx是零依赖的便捷选择。# 使用npx单次执行 npx everything-cursor installnpx会临时下载everything-cursor包并执行它的CLI。同样之后会进入交互式选择。方式三全局安装适合需要频繁调用或集成到脚本的用户如果你打算经常使用这个工具或者想在多个项目中快速安装/卸载全局安装更方便。# 使用npm全局安装 npm install -g everything-cursor # 安装后可以直接使用everything-cursor命令 everything-cursor install实操心得我个人更倾向于使用npx或deno x进行单次安装。理由有三第一避免污染全局环境第二每次执行都能确保使用最新版本第三对于这种配置型的工具安装一次后很长时间都不会再运行没必要全局安装。只有当你需要将它作为自己自动化脚本的一部分时才考虑全局安装。3.2 关键决策安装位置的选择无论选择哪种安装方式第一个也是最重要的交互提示都会出现 Select installation location: 1) local - Project local (.cursor/) 2) home - Home directory (~/.cursor/) 3) cancel - Cancel installation Enter your choice (1-3):这是一个需要根据你的使用场景仔细权衡的选择。选项1: local (项目本地安装)路径./.cursor/位于你当前执行命令的项目根目录下特点 配置仅对当前项目生效。适用场景团队项目 你希望将一套统一的AI编码规范如特定的代码审查规则、团队约定的提交信息模板固化到项目仓库中。所有克隆该仓库的团队成员打开Cursor时都会自动加载这些配置保证了协作的一致性。特定技术栈项目 比如一个Rust项目可能需要一套与Go项目完全不同的AI代理和技能。本地安装可以让你为每个项目定制专属的AI助手。临时实验 你想在某个项目里试试某个技能的效果不想影响其他项目。选项2: home (用户主目录安装)路径~/.cursor/位于你的用户主目录下特点 配置对所有项目全局生效。适用场景个人通用配置 你有一套自己习惯的、跨所有项目都适用的工作流比如你个人偏好的TDD流程、常用的重构命令。全局安装一次在任何新老项目中都能直接使用最方便。避免重复配置 不想在每个项目里都复制一遍相同的技能文件。注意事项这个选择会被CLI记住。它会在你选择的位置例如~/.cursor/下创建一个简单的配置文件如.cursor-install-config.json记录你上次的选择。下次再运行everything-cursor install时它会直接使用这个位置而不再询问。如果你想更改位置需要先运行everything-cursor uninstall卸载当前配置然后再运行install重新选择。我个人的策略是对于公司核心业务项目使用local安装将配置纳入版本控制确保团队统一。对于个人 side project 或实验性项目使用home安装追求个人效率最大化。做出选择后例如输入1并按回车安装过程就开始了。你会看到类似下面的输出 Installing everything-cursor... Checking installation location... Copying files to /Users/yourname/your-project/.cursor/ agents/planner.md skills/tdd-workflow/tdd.md commands/refactor.md rules/security.md ... (更多文件) ✅ Installation complete! Location: local Files installed: 42至此技能文件已经全部就位。你可以立即打开Cursor在聊天框里尝试触发新技能了。例如输入“/”看看命令列表里是不是多了新选项或者直接对AI说“我们按照TDD流程来开发这个功能”。4. 技能库内容深度探索与自定义安装完成只是开始真正的价值在于如何使用和定制这些技能。让我们深入看看everything-claude-code这个技能库大概提供了什么以及如何让它更好地为你服务。4.1 预置技能概览与使用示例由于源仓库内容可能更新以下是一些典型技能的示例你可以举一反三技能skills/tdd-workflow/作用 引导AI严格遵循“红-绿-重构”循环进行开发。使用方式 在Cursor中你可以对AI说“请使用TDD工作流为这个Calculator类添加一个add方法。” AI会首先问你期望的行为如“add(2,3)应返回5”然后生成一个会失败的测试用例接着生成实现代码让测试通过最后可能会建议重构。这比单纯说“写个测试”要系统得多。代理agents/code-reviewer.md作用 将AI设定为一个严厉的代码审查员。使用方式 选中一段代码然后对AI说“请以代码审查员的身份检查这段代码。” AI会从代码风格、潜在bug、性能、安全性、可读性等多个维度给出审查意见而不仅仅是普通的解释或修改。命令commands/generate-docs.md作用 一键为选中的代码生成高质量的JSDoc/TSDoc注释。使用方式 选中一个函数或类在Cursor命令面板中输入/generate-docs如果配置了命令别名或者直接对AI说“执行生成文档命令”。AI会输出格式规范、内容完整的注释块。规则rules/performance.md作用 提醒AI在编写代码时注意性能陷阱。使用方式 这个规则是隐式生效的。当AI为你编写涉及循环、算法或数据处理的代码时它会自动考虑规则中的条款例如避免在循环内进行重复计算、选择合适的数据结构等。要查看所有已安装的技能最直接的方法是去你安装的目录.cursor/或~/.cursor/下浏览各个子文件夹。每个.md文件都可以用任何文本编辑器打开里面的内容就是驱动AI的“魔法咒语”。阅读它们也是学习如何编写高质量Prompt的绝佳方式。4.2 如何安全地进行自定义everything-cursor在设计上充分考虑了用户自定义的需求。它的一个核心原则是永不覆盖或删除用户自定义的文件。添加自定义文件 假设你在使用全局安装~/.cursor/并且想添加一个自己写的、用于生成特定项目API客户端代码的技能。直接在~/.cursor/skills/目录下创建一个新文件夹例如my-api-client/。在该文件夹内创建一个.md文件比如generate.md并写入你的自定义提示词。保存文件。完成当下次你运行everything-cursor install进行更新时安装脚本会更新 从源仓库拉取agents/,skills/,commands/,rules/下的.md文件并覆盖同名文件如果源仓库有更新。保留 完全忽略my-api-client/这个它不认识的文件夹以及里面的generate.md文件。你的自定义文件安然无恙。清理 如果源仓库删除了某个技能文件例如old-skill.md那么更新时脚本也会从你的安装目录中删除这个文件。但这只针对它自己安装的文件通过清单Manifest来识别。修改预置文件不推荐但可行 你也可以直接修改安装目录下的任何.md文件来调整技能行为。但需要注意风险 下次更新时如果源仓库更新了同一个文件你的修改会被覆盖。建议 更好的做法是“继承”而非“修改”。例如你觉得预置的code-reviewer.md太严厉可以复制一份重命名为my-gentle-reviewer.md然后修改其中的语气和审查重点。这样既保留了原版又有了自定义版本还不会被更新覆盖。4.3 安装目录结构详解理解安装后的目录结构有助于你更好地管理和规划自定义内容。安装完成后目标目录的结构会非常清晰.cursor/ (或 ~/.cursor/) ├── agents/ │ ├── planner.md # 项目规划代理 │ ├── code-reviewer.md # 代码审查代理 │ └── ... # 其他代理定义 ├── skills/ │ ├── tdd-workflow/ │ │ └── tdd.md # TDD工作流技能 │ ├── debug-assistant/ │ │ └── debug.md # 调试助手技能 │ └── ... # 其他技能目录 ├── commands/ │ ├── refactor.md # 重构命令 │ ├── generate-docs.md # 生成文档命令 │ └── ... # 其他快捷命令 └── rules/ ├── security.md # 安全编码规则 ├── performance.md # 性能优化规则 └── ... # 其他约束规则这种结构模仿了Cursor IDE读取配置的默认约定。你可以遵循这个结构来组织你的自定义文件这通常是最稳妥的做法。5. 维护、更新与问题排查将技能库安装好并开始使用后日常的维护工作非常简单但了解其机制能避免一些困惑。5.1 更新到最新技能库技能库本身everything-claude-code可能会由社区维护者更新添加新技能或优化现有提示。为了获取这些更新你需要重新运行安装命令。# 使用你最初安装的方式即可 npx everything-cursor install # 或 deno x jsr:yoshixmk/everything-cursor/cli install这里有一个智能检测机制安装脚本会检查当前已安装的版本通过存储在安装目录下的一个版本标识文件与要安装的包版本是否一致。如果版本相同它会提示“Already up to date”并跳过文件复制避免不必要的IO操作。如果版本更新了它就会执行更新操作。因此你可以定期运行安装命令它本身是幂等的执行多次效果相同并且是安全的。5.2 完全卸载如果你不再需要这些预置技能或者想彻底清理然后重新选择安装位置卸载操作很简单。# 根据你的安装方式选择对应的卸载命令 npx everything-cursor uninstall # 或 everything-cursor uninstall # (如果全局安装)这个uninstall命令会做一件事根据它自己维护的安装清单删除所有当初由它复制过来的文件。再次强调它不会删除任何你手动创建的文件。卸载后你的.cursor/目录下将只剩下你的自定义文件如果有的话。5.3 常见问题与解决方案实录在实际使用中你可能会遇到以下情况问题1安装后在Cursor里没有看到新技能/命令。排查步骤确认安装位置 首先检查你安装到了哪里local还是home。如果你在项目A中安装了local那么在项目B中打开Cursor是看不到这些技能的。重启Cursor Cursor可能在启动时加载了配置。尝试完全关闭Cursor IDE再重新打开。检查目录结构 去安装目录下查看agents/,skills/等文件夹是否存在里面是否有.md文件。确保文件被正确复制。检查Cursor设置 极少数情况下Cursor可能被配置为从其他路径读取设置。检查Cursor的设置选项。问题2运行安装命令时出现权限错误Permission denied。原因 尝试向受保护的目录如/usr/local/lib写入文件或者当前用户对目标目录没有写权限。解决方案如果使用home安装确保你的用户对~/.cursor/目录有读写权。通常这是默认的。如果使用local安装确保你在项目目录中有权限创建.cursor/文件夹。在Linux/macOS上可以尝试用sudo不推荐可能造成权限混乱更好的办法是检查并修正目录所有权chown。对于Deno确保你使用了-A或适当的--allow-write权限。问题3我想修改某个预置技能但怕更新时被覆盖。解决方案 如前所述采用“复制-重命名-修改”的策略。不要直接编辑原文件。例如将skills/tdd-workflow/tdd.md复制为skills/tdd-workflow/tdd-my-edition.md然后修改后者。在Cursor中你可以通过更具体的指令来调用你的自定义版本。问题4安装器提示“Already up to date”但我确定源仓库有更新。原因 安装器检查的是everything-cursor这个npm/JSR包的版本号而不是其内部子模块everything-claude-code的版本。如果everything-cursor的发布者没有更新包版本和同步子模块安装器就会认为无需更新。解决方案 你可以尝试强制重新安装如果CLI提供--force参数或者直接使用从源码安装的方法手动更新子模块git clone https://github.com/yoshixmk/everything-cursor.git cd everything-cursor git submodule update --remote # 拉取子模块最新内容 deno run --allow-all cli.ts install问题5我卸载后为什么.cursor文件夹还在原因 这是正常且符合设计的行为。卸载操作只删除安装器自己添加的文件。如果你在agents/等文件夹内创建了自己的.md文件或者目录内还有其他非.md文件卸载后这些文件和空文件夹都会保留。这保护了你的劳动成果。如果你想完全删除.cursor目录需要手动进行。
Cursor AI技能库一键部署指南：提升开发效率的标准化配置方案
1. 项目概述当AI助手Cursor遇上Everything技能库如果你和我一样日常开发重度依赖Cursor这款AI驱动的IDE那你肯定也遇到过这样的场景想让它帮你写个单元测试得先花几分钟描述TDD流程想让它重构一段代码又得反复解释重构原则。每次都要“调教”AI助手效率实在不高。最近我在GitHub上发现了一个名为everything-cursor的项目它本质上是一个“技能包”安装器能将一套成熟的AI代理配置、工作流技能和编码规则一键注入到你的Cursor环境中。简单来说everything-cursor是一个命令行工具它从一个名为everything-claude-code的社区技能库中提取大量预定义的、高质量的Markdown配置文件并将它们安装到Cursor IDE读取的特定目录下。安装后你的Cursor就“学会”了诸如TDD测试驱动开发工作流、代码审查代理、安全编码规则等一系列高级技能。你不再需要每次都从零开始给AI下指令而是可以直接调用这些预设好的、经过优化的“技能模板”让AI助手更精准、更高效地理解你的意图并执行复杂任务。这个项目的核心价值在于标准化和可复用性。它把那些在开发者社区中被反复验证有效的AI交互模式固化成了可一键部署的配置。无论你是想提升代码质量、规范团队协作还是单纯想探索Cursor的更多可能性这个工具都能帮你省去大量重复配置的时间。注意根据项目仓库的说明该项目已被归档Archived。主要原因是Cursor与Claude Code共享~/.claude/目录路径而everything-claude-code的技能缓存恰好存放在~/.claude/plugins/cache/中Cursor会扫描整个~/.claude/目录因此通过Claude Code安装的技能会自动在Cursor中生效。所以从技术上讲直接使用源技能库everything-claude-code可能是更直接的选择。不过everything-cursor作为一个封装良好的安装器其设计思路、安装逻辑以及对多包管理器的支持仍然是非常值得学习和参考的案例。2. 核心原理与架构设计解析要理解everything-cursor如何工作我们需要先拆解几个关键概念Cursor的技能系统、技能文件的组织形式以及这个安装器是如何在它们之间搭建桥梁的。2.1 Cursor技能系统的工作机制Cursor允许开发者通过在其配置目录通常是项目根目录的.cursor/或用户主目录的~/.cursor/下放置特定的Markdown.md文件来扩展AI助手的能力。这些文件主要分为四类对应不同的功能模块Agents代理 定义了AI助手的“人格”或“角色”。例如一个名为planner.md的代理文件可能会将AI设定为一个项目规划专家擅长将模糊的需求拆解为具体的开发任务和代码结构。当你在Cursor中激活这个代理时AI的回复风格和思考重点就会向“规划者”倾斜。Skills技能 这是最核心的部分定义了具体的工作流程。例如一个tdd-workflow.md技能文件会详细描述测试驱动开发的完整步骤先写一个失败的小测试再实现最小化代码使测试通过然后重构如此循环。AI在遵循这个技能时会严格按照预设的步骤引导你或替你完成代码。Commands命令 可以理解为“快捷指令”。你可以创建一个refactor.md命令文件里面写好一段提示词比如“请用策略模式重构当前函数”。之后在Cursor中你只需输入/refactorAI就会执行这段复杂的提示词无需你每次都手动输入。Rules规则 定义了代码规范和约束。例如一个security.md规则文件会列出禁止使用的危险函数、必须进行的输入验证等。当AI编写或审查代码时会主动遵循这些规则从而帮助团队保持代码安全性和一致性。这些.md文件的内容本质上是结构化的自然语言提示Prompts它们利用了AI对大段上下文的理解能力。Cursor在运行时会读取这些目录下的文件并将其作为上下文的一部分提供给底层的AI模型如Claude从而“定制化”AI的行为。2.2 Everything-Cursor的桥梁作用everything-cursor项目本身并不生产这些技能文件它是一个“搬运工”和“安装器”。它的核心是一个Git子模块Submodule指向了源技能库affaan-m/everything-claude-code。这个子模块里包含了上述四类文件的大量实例。安装器的工作流程非常清晰拉取资源 通过Git子模块或直接下载获取源技能库中的所有.md文件。交互选择 通过命令行交互询问用户希望将技能安装到哪里当前项目的.cursor/目录还是用户主目录的~/.cursor/目录。智能复制 将源技能库中agents/,skills/,commands/,rules/目录下的所有.md文件复制到用户选择的目标目录下对应的文件夹中。状态管理 在目标目录中维护一个清单Manifest记录哪些文件是它安装的。这个清单在后续的更新、卸载操作中至关重要用于区分“系统文件”和“用户自定义文件”。这种设计实现了关注点分离技能内容的创作和维护由everything-claude-code社区负责而分发、安装和生命周期管理则由everything-cursor这个工具负责。作为用户你只需要一条安装命令就能获得一整套即装即用的AI增强能力。2.3 多运行时支持的设计考量你可能会注意到这个安装器同时支持Deno通过JSR、Node.jsnpm和pnpm。这背后有重要的设计考量降低使用门槛 不是所有开发者都安装了Deno或Node.js。提供多种包管理器入口让用户可以用自己最熟悉的方式安装大大提升了工具的易用性和采纳率。利用生态优势 Deno以其安全性默认无权限和内置工具链著称适合作为一次性执行deno x的脚本载体。而npm/pnpm拥有更庞大的用户基数对Node.js生态的开发者更为友好。技术展示 这也是一种很好的技术实践展示说明了如何用TypeScript编写一个同时兼容Deno和Node.js的工具并通过jsr.json和package.json进行双重发布。在实际的CLI代码中通常会通过判断运行时环境来动态加载不同的模块或执行路径但核心的文件操作逻辑是共享的。这种跨运行时支持虽然增加了初期配置的复杂性但对于一个旨在广泛传播的工具来说是非常有价值的。3. 详细安装与配置实战指南了解了原理我们开始动手。这里我会提供最详细的步骤并穿插我实际操作中遇到的细节和选择背后的原因。3.1 环境准备与安装方式选择首先你需要确保你的系统上安装了Cursor IDE。这是前提。然后根据你的习惯选择一种安装方式。方式一Deno一键执行推荐给追求简洁和安全的用户Deno的方式非常干净因为它允许直接远程执行代码无需先进行全局安装。# 单次执行安装命令 deno run -A jsr:yoshixmk/everything-cursor/cli install运行这行命令时发生了以下几件事deno run命令启动Deno运行时。-A是一个权限标志代表--allow-all。这是一个需要特别注意的安全点。因为安装过程涉及文件系统的读写复制文件到.cursor目录所以需要授予全部权限。对于不熟悉的脚本理论上应该更细化地授予权限如--allow-read --allow-write但为了方便项目使用了-A。如果你对安全性有极高要求可以查阅脚本源码确定所需的具体权限后使用更严格的标志。jsr:yoshixmk/everything-cursor/cli指定从JSRJavaScript Registry拉取名为yoshixmk/everything-cursor的包并执行其cli模块。install是传递给该CLI的命令参数。执行后CLI会首先在终端打印出彩色的欢迎信息然后立即进入安装位置的选择提示。方式二npm/npx方式适合Node.js生态开发者如果你更熟悉Node.js生态使用npx是零依赖的便捷选择。# 使用npx单次执行 npx everything-cursor installnpx会临时下载everything-cursor包并执行它的CLI。同样之后会进入交互式选择。方式三全局安装适合需要频繁调用或集成到脚本的用户如果你打算经常使用这个工具或者想在多个项目中快速安装/卸载全局安装更方便。# 使用npm全局安装 npm install -g everything-cursor # 安装后可以直接使用everything-cursor命令 everything-cursor install实操心得我个人更倾向于使用npx或deno x进行单次安装。理由有三第一避免污染全局环境第二每次执行都能确保使用最新版本第三对于这种配置型的工具安装一次后很长时间都不会再运行没必要全局安装。只有当你需要将它作为自己自动化脚本的一部分时才考虑全局安装。3.2 关键决策安装位置的选择无论选择哪种安装方式第一个也是最重要的交互提示都会出现 Select installation location: 1) local - Project local (.cursor/) 2) home - Home directory (~/.cursor/) 3) cancel - Cancel installation Enter your choice (1-3):这是一个需要根据你的使用场景仔细权衡的选择。选项1: local (项目本地安装)路径./.cursor/位于你当前执行命令的项目根目录下特点 配置仅对当前项目生效。适用场景团队项目 你希望将一套统一的AI编码规范如特定的代码审查规则、团队约定的提交信息模板固化到项目仓库中。所有克隆该仓库的团队成员打开Cursor时都会自动加载这些配置保证了协作的一致性。特定技术栈项目 比如一个Rust项目可能需要一套与Go项目完全不同的AI代理和技能。本地安装可以让你为每个项目定制专属的AI助手。临时实验 你想在某个项目里试试某个技能的效果不想影响其他项目。选项2: home (用户主目录安装)路径~/.cursor/位于你的用户主目录下特点 配置对所有项目全局生效。适用场景个人通用配置 你有一套自己习惯的、跨所有项目都适用的工作流比如你个人偏好的TDD流程、常用的重构命令。全局安装一次在任何新老项目中都能直接使用最方便。避免重复配置 不想在每个项目里都复制一遍相同的技能文件。注意事项这个选择会被CLI记住。它会在你选择的位置例如~/.cursor/下创建一个简单的配置文件如.cursor-install-config.json记录你上次的选择。下次再运行everything-cursor install时它会直接使用这个位置而不再询问。如果你想更改位置需要先运行everything-cursor uninstall卸载当前配置然后再运行install重新选择。我个人的策略是对于公司核心业务项目使用local安装将配置纳入版本控制确保团队统一。对于个人 side project 或实验性项目使用home安装追求个人效率最大化。做出选择后例如输入1并按回车安装过程就开始了。你会看到类似下面的输出 Installing everything-cursor... Checking installation location... Copying files to /Users/yourname/your-project/.cursor/ agents/planner.md skills/tdd-workflow/tdd.md commands/refactor.md rules/security.md ... (更多文件) ✅ Installation complete! Location: local Files installed: 42至此技能文件已经全部就位。你可以立即打开Cursor在聊天框里尝试触发新技能了。例如输入“/”看看命令列表里是不是多了新选项或者直接对AI说“我们按照TDD流程来开发这个功能”。4. 技能库内容深度探索与自定义安装完成只是开始真正的价值在于如何使用和定制这些技能。让我们深入看看everything-claude-code这个技能库大概提供了什么以及如何让它更好地为你服务。4.1 预置技能概览与使用示例由于源仓库内容可能更新以下是一些典型技能的示例你可以举一反三技能skills/tdd-workflow/作用 引导AI严格遵循“红-绿-重构”循环进行开发。使用方式 在Cursor中你可以对AI说“请使用TDD工作流为这个Calculator类添加一个add方法。” AI会首先问你期望的行为如“add(2,3)应返回5”然后生成一个会失败的测试用例接着生成实现代码让测试通过最后可能会建议重构。这比单纯说“写个测试”要系统得多。代理agents/code-reviewer.md作用 将AI设定为一个严厉的代码审查员。使用方式 选中一段代码然后对AI说“请以代码审查员的身份检查这段代码。” AI会从代码风格、潜在bug、性能、安全性、可读性等多个维度给出审查意见而不仅仅是普通的解释或修改。命令commands/generate-docs.md作用 一键为选中的代码生成高质量的JSDoc/TSDoc注释。使用方式 选中一个函数或类在Cursor命令面板中输入/generate-docs如果配置了命令别名或者直接对AI说“执行生成文档命令”。AI会输出格式规范、内容完整的注释块。规则rules/performance.md作用 提醒AI在编写代码时注意性能陷阱。使用方式 这个规则是隐式生效的。当AI为你编写涉及循环、算法或数据处理的代码时它会自动考虑规则中的条款例如避免在循环内进行重复计算、选择合适的数据结构等。要查看所有已安装的技能最直接的方法是去你安装的目录.cursor/或~/.cursor/下浏览各个子文件夹。每个.md文件都可以用任何文本编辑器打开里面的内容就是驱动AI的“魔法咒语”。阅读它们也是学习如何编写高质量Prompt的绝佳方式。4.2 如何安全地进行自定义everything-cursor在设计上充分考虑了用户自定义的需求。它的一个核心原则是永不覆盖或删除用户自定义的文件。添加自定义文件 假设你在使用全局安装~/.cursor/并且想添加一个自己写的、用于生成特定项目API客户端代码的技能。直接在~/.cursor/skills/目录下创建一个新文件夹例如my-api-client/。在该文件夹内创建一个.md文件比如generate.md并写入你的自定义提示词。保存文件。完成当下次你运行everything-cursor install进行更新时安装脚本会更新 从源仓库拉取agents/,skills/,commands/,rules/下的.md文件并覆盖同名文件如果源仓库有更新。保留 完全忽略my-api-client/这个它不认识的文件夹以及里面的generate.md文件。你的自定义文件安然无恙。清理 如果源仓库删除了某个技能文件例如old-skill.md那么更新时脚本也会从你的安装目录中删除这个文件。但这只针对它自己安装的文件通过清单Manifest来识别。修改预置文件不推荐但可行 你也可以直接修改安装目录下的任何.md文件来调整技能行为。但需要注意风险 下次更新时如果源仓库更新了同一个文件你的修改会被覆盖。建议 更好的做法是“继承”而非“修改”。例如你觉得预置的code-reviewer.md太严厉可以复制一份重命名为my-gentle-reviewer.md然后修改其中的语气和审查重点。这样既保留了原版又有了自定义版本还不会被更新覆盖。4.3 安装目录结构详解理解安装后的目录结构有助于你更好地管理和规划自定义内容。安装完成后目标目录的结构会非常清晰.cursor/ (或 ~/.cursor/) ├── agents/ │ ├── planner.md # 项目规划代理 │ ├── code-reviewer.md # 代码审查代理 │ └── ... # 其他代理定义 ├── skills/ │ ├── tdd-workflow/ │ │ └── tdd.md # TDD工作流技能 │ ├── debug-assistant/ │ │ └── debug.md # 调试助手技能 │ └── ... # 其他技能目录 ├── commands/ │ ├── refactor.md # 重构命令 │ ├── generate-docs.md # 生成文档命令 │ └── ... # 其他快捷命令 └── rules/ ├── security.md # 安全编码规则 ├── performance.md # 性能优化规则 └── ... # 其他约束规则这种结构模仿了Cursor IDE读取配置的默认约定。你可以遵循这个结构来组织你的自定义文件这通常是最稳妥的做法。5. 维护、更新与问题排查将技能库安装好并开始使用后日常的维护工作非常简单但了解其机制能避免一些困惑。5.1 更新到最新技能库技能库本身everything-claude-code可能会由社区维护者更新添加新技能或优化现有提示。为了获取这些更新你需要重新运行安装命令。# 使用你最初安装的方式即可 npx everything-cursor install # 或 deno x jsr:yoshixmk/everything-cursor/cli install这里有一个智能检测机制安装脚本会检查当前已安装的版本通过存储在安装目录下的一个版本标识文件与要安装的包版本是否一致。如果版本相同它会提示“Already up to date”并跳过文件复制避免不必要的IO操作。如果版本更新了它就会执行更新操作。因此你可以定期运行安装命令它本身是幂等的执行多次效果相同并且是安全的。5.2 完全卸载如果你不再需要这些预置技能或者想彻底清理然后重新选择安装位置卸载操作很简单。# 根据你的安装方式选择对应的卸载命令 npx everything-cursor uninstall # 或 everything-cursor uninstall # (如果全局安装)这个uninstall命令会做一件事根据它自己维护的安装清单删除所有当初由它复制过来的文件。再次强调它不会删除任何你手动创建的文件。卸载后你的.cursor/目录下将只剩下你的自定义文件如果有的话。5.3 常见问题与解决方案实录在实际使用中你可能会遇到以下情况问题1安装后在Cursor里没有看到新技能/命令。排查步骤确认安装位置 首先检查你安装到了哪里local还是home。如果你在项目A中安装了local那么在项目B中打开Cursor是看不到这些技能的。重启Cursor Cursor可能在启动时加载了配置。尝试完全关闭Cursor IDE再重新打开。检查目录结构 去安装目录下查看agents/,skills/等文件夹是否存在里面是否有.md文件。确保文件被正确复制。检查Cursor设置 极少数情况下Cursor可能被配置为从其他路径读取设置。检查Cursor的设置选项。问题2运行安装命令时出现权限错误Permission denied。原因 尝试向受保护的目录如/usr/local/lib写入文件或者当前用户对目标目录没有写权限。解决方案如果使用home安装确保你的用户对~/.cursor/目录有读写权。通常这是默认的。如果使用local安装确保你在项目目录中有权限创建.cursor/文件夹。在Linux/macOS上可以尝试用sudo不推荐可能造成权限混乱更好的办法是检查并修正目录所有权chown。对于Deno确保你使用了-A或适当的--allow-write权限。问题3我想修改某个预置技能但怕更新时被覆盖。解决方案 如前所述采用“复制-重命名-修改”的策略。不要直接编辑原文件。例如将skills/tdd-workflow/tdd.md复制为skills/tdd-workflow/tdd-my-edition.md然后修改后者。在Cursor中你可以通过更具体的指令来调用你的自定义版本。问题4安装器提示“Already up to date”但我确定源仓库有更新。原因 安装器检查的是everything-cursor这个npm/JSR包的版本号而不是其内部子模块everything-claude-code的版本。如果everything-cursor的发布者没有更新包版本和同步子模块安装器就会认为无需更新。解决方案 你可以尝试强制重新安装如果CLI提供--force参数或者直接使用从源码安装的方法手动更新子模块git clone https://github.com/yoshixmk/everything-cursor.git cd everything-cursor git submodule update --remote # 拉取子模块最新内容 deno run --allow-all cli.ts install问题5我卸载后为什么.cursor文件夹还在原因 这是正常且符合设计的行为。卸载操作只删除安装器自己添加的文件。如果你在agents/等文件夹内创建了自己的.md文件或者目录内还有其他非.md文件卸载后这些文件和空文件夹都会保留。这保护了你的劳动成果。如果你想完全删除.cursor目录需要手动进行。
