Skip to content

Repository files navigation

🚀 Cursor Helper

让 AI 代码评审像呼吸一样自然

专为 Cursor / Trae 打造的零配置增强工具集

Version Installs License

快速开始核心功能详细文档反馈建议


🎯 产品愿景

Cursor Helper 致力于成为 AI IDE 生态中最实用的增强工具集

我们深度洞察开发者真实需求,专注提供 AI IDE 核心功能之外的实用增强工具。我们不做重复造轮子的事,而是做 AI IDE 生态的补充者和增强者,与 AI IDE 形成互补关系。

关注的产品:Cursor、Trae(字节跳动)、CodeBuddy(腾讯)、Qoder(阿里巴巴)

我们的定位

  • 🔧 增强工具集:提供 AI IDE 核心功能之外的实用增强工具
  • 🎯 生态补充者:不做重复造轮子,专注补充和增强
  • 💡 开发者优先:深度洞察开发者真实需求,提供开箱即用解决方案

与 SOP 的对比

🚫 传统 SOP 的问题 Cursor Helper 的解决方案
❌ 各种配置、文档、流程,让开发者频繁去配置 开箱即用:安装后直接使用,无需配置
❌ 文档太多太乱,不知道从哪里开始 简单明了:不需要读文档,只需要会按"/"
❌ 评审结果散乱无序,无法统一管理和追溯 结构化输出:统一的结构化报告格式,按优先级分类(Critical/Warning/Info),方便查看和追溯
❌ 只关注代码,缺少需求和技术方案的符合性检查 多维度总结性评审:代码评审总结 + PRD符合性评审 + 技术方案符合性评审,全面覆盖代码、需求、设计三个维度
❌ 工具更新后,命令文件需要手动维护,版本不一致 自动更新机制:插件更新后,命令文件自动同步,无需手动维护

重要说明⚠️ 评审效果与团队业务规则强相关:Cursor Helper 负责提供一键傻瓜式的评审、修复、规则生成流程,但评审质量的好坏主要取决于团队在 .cursor/rules/ 目录下沉淀的业务规则。规则越丰富、越精准,评审效果越惊艳。我们提供便捷的工具和辅助生成能力,帮助团队将经验沉淀为规则资产。


🚀 极速上手

我们追求极致的"无感体验"。不需要任何配置文件,不需要任何参数。

  1. 安装:在 Cursor 插件市场搜索 Cursor Helper
  2. 运行:打开任意项目,在 Chat 中输入:
    /review
  3. 收工:AI 自动结合你的规则分析代码,你只需喝杯咖啡。

💡 高级技巧:输入 /generate-rule 将本次评审中的好建议一键固化为新规则。

🔄 如果命令没有反应? 打开命令面板(Ctrl+Shift+P / Cmd+Shift+P),搜索 初始化 / 更新 Cursor Helper 命令 手动刷新命令文件,然后执行 Developer: Reload Window 重新加载窗口。详见技术说明

💡 提示:所有命令文件会在插件启动时自动初始化,无需手动操作。.gitignore 文件会自动更新,确保临时文件不会被提交到 Git,但会保留重要的总结性评审报告(代码评审总结、PRD符合性评审、技术方案符合性评审),采用统一的结构化格式,方便评审人直接查看。


💎 为什么选择 Cursor Helper?

1️⃣ 📝 业务规则辅助生成 (/generate-rule)

这是我们的核心差异点。工具不仅是用来的,更是用来"调教"的。

  • 一键沉淀:评审发现问题 -> /fix 修复 -> /generate-rule 固化。
  • 辅助生成:你不需要懂 Prompt 工程,工具会自动帮你写出高质量的规则文件。
  • 越用越强:随着使用次数增加,你的规则库越来越厚,评审质量呈指数级上升。

2️⃣ 🔍 规则驱动的智能评审 (/review)

通用大模型 + 你的独家业务规则 = 完美的评审员。

  • 智能 Diff 分析:自动识别主分支,聚焦变更。
  • ✨ 支持未提交代码:支持评审工作目录中未提交的更改(包括已暂存和未暂存的更改),可以在提交前进行自检。
  • 业务逻辑审计:自动加载 .cursor/rules,检查是否符合团队特定的业务规范(如:错误码定义、事务处理机制)。
  • 上下文感知:支持关联 PRD (/review @Browser <URL>),让 AI 懂需求再评审。
  • 🌐 跨项目需求评审支持(v0.1.5 新增):PRD和技术方案文档即使不属于当前项目,也会执行符合性评审
    • 自动识别跨项目需求,在评审报告中明确标注
    • 只评审当前项目范围内的代码实现,不会因为其他项目未实现而扣分
    • 智能识别当前项目在整体需求中的角色和范围
  • ✨ 结构化报告格式:采用统一的结构化报告格式,按优先级分类(Critical/Warning/Info),便于查看和追溯。
  • 📊 总结性评审:自动生成代码评审总结、PRD符合性评审、技术方案符合性评审,全面覆盖代码、需求、设计三个维度。
  • 📋 推荐提交的报告代码评审总结.md(必须)+ PRD符合性评审.md(如有PRD)+ 技术方案符合性评审.md(如有技术方案)

3️⃣ 🛠️ 闭环自动修复 (/fix)

发现问题只是第一步,解决问题才是关键。

  • Plan Mode 集成:先出计划,后执行。修复过程完全可控。
  • 优先级管理:优先修复 Critical 级致命问题。
  • 闭环验证:修复后自动进行语法检查。

4️⃣ 📋 规则整理工具 (/organize-rules)

规则库越用越厚,需要定期整理优化。

  • 智能分析:自动检查规则文件格式、识别重复内容、生成总分格式的整理报告。
  • 自动优化:智能重命名、分类整理、合并相似规则文件。
  • 结构清晰:确保规则文件结构清晰、易于维护。

5️⃣ 🔧 Gitignore 自动管理

自动管理 Git 忽略规则,保持仓库整洁。

  • ✨ 自动更新:插件启动时自动更新 .gitignore.cursorignore 文件(静默模式),无需手动操作。
  • 智能过滤:自动忽略临时文件(如详细文件评审报告),保留重要报告(总结性评审报告),方便评审人直接查看。
  • 报告结构优化:评审报告采用双层结构,总结性报告(reports/summary/)会被提交到 Git,评审人可直接查看。
  • 多工作区支持:一次操作,所有工作区同步配置。
  • 手动管理:可通过命令面板(Ctrl+Shift+P)执行 管理 Gitignore 文件 手动管理。

6️⃣ 🧹 插件卸载自动清理(v0.1.5 新增)

卸载插件时自动清理,保持系统整洁。

  • 自动清理命令文件:插件卸载时自动删除所有插件相关的命令文件(包括当前版本)
  • 静默模式执行:清理过程不影响用户体验,无需手动操作
  • 保持系统整洁:避免遗留文件占用空间,确保卸载后系统干净

📦 安装指南

推荐使用 命令行安装,速度最快,100% 成功。

# Windows / Mac / Linux 通用
cursor --install-extension YifeiCheng.cursor-helper

或者在 Cursor 扩展商店搜索:YifeiCheng.cursor-helper


📚 常用命令速查

🎯 Cursor Chat 命令(在 Chat 中输入)

命令 说明 场景
/review 全自动评审 提交代码前,结合规则库进行检查
/fix 执行修复 评审完成后一键优化
/generate-rule 辅助生成规则 [核心] 将评审建议沉淀为业务规则
/organize-rules 规则整理 整理和优化 .cursor/rules/ 文件夹,检查格式、生成索引、识别重复
/help 查看帮助 忘记命令时

🔧 VS Code 命令面板命令(Ctrl+Shift+P / Cmd+Shift+P)

命令 说明 场景
初始化 / 更新 Cursor Helper 命令 手动创建或更新命令文件 插件更新后或命令文件被误删时
清空无效 Cursor Helper 命令 清理历史版本和无效命令文件 清理旧版本命令文件时
管理 Gitignore 文件 手动管理忽略文件配置 需要手动更新 .gitignore.cursorignore

⚙️ 自动功能

  • 自动初始化:插件启动时自动创建/更新命令文件
  • 自动 Gitignore 管理:启动时自动更新忽略文件配置(静默模式)
  • 工作区监听:工作区文件夹变化时自动更新命令文件
  • 版本同步:自动检测版本,命令文件版本不匹配时自动更新

🤝 参与共建

我们致力于打造 AI IDE 生态中最实用的增强工具。


Made with ❤️ for Developers

About

Cursor 生态增强工具集 - 早期项目已停止迭代

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages