agentic-cursorrules

为你的 AI Agent 提供明确的“领地意识”。

通过严格的文件树分区和领域边界管理，在 Cursor 中实现多 AI Agent 的高效协作。本工具可以生成隔离的 Markdown 规则文件，通过明确的文件树边界来防止 Agent 之间的冲突。

为什么需要它

我们都有过这样的经历：当你让 AI Agent 访问整个代码库时，它可能会擅自“重构”一个工具文件，从而破坏了你甚至都没提到的其他五个模块。

传统的开发工作流会用 Agent 不需要的信息淹没它们。Agentic-cursorrules 通过将每个 Agent 限制在预定义的目录切片中来解决这个问题。对话始终保持专注，diff 仅限于局部，且由于 Agent 不需要同时理解整个宇宙，协作开销也随之降低。

工作原理

其核心逻辑是一个边界管理器。它读取配置（甚至可以为你自动检测！），将目录模式映射到命名的领域（Domains）。

当你运行该工具时，它会解析这些领域，遵循你的 .gitignore 规则，并为每个领域编写 Markdown 文件（例如 @agent_backend_api.md）。这些文件定义了特定领域的边界、相关路径和护栏规则。你在 IDE（如 Cursor、Windsurf 等）中引用这些文件，AI 助手就能精准地知道自己的职责范围并严格遵守。

快速开始

你需要 Python 3.10+ 和 uv（因为我们没时间浪费在缓慢的安装过程中）。

# 1. 克隆仓库
git clone https://github.com/s-smits/agentic-cursorrules.git .agentic-cursorrules
cd .agentic-cursorrules

# 2. 安装依赖
uv sync

# 3. 运行初始化向导
uv run agentic-cursorrules --init

--init 命令是入门最友好的方式。它会扫描你的项目，推断逻辑领域，并以交互方式为你构建 config.yaml。

如何使用

自动驾驶模式

只想看看它能扫描出什么？

uv run agentic-cursorrules --auto-config

这会扫描你的仓库并保存一个 config_auto.yaml，而不会覆盖你的主配置文件。非常适合检查你的文件夹结构在机器眼中是否合理。

手动掌控

在生产环境中，你可能希望在 config.yaml 中手动定义边界：

project_title: "super-app"
tree_focus:
  - "backend/api"       # API 团队的领域
  - "frontend/dashboard" # 仪表盘团队的领域
  - "shared/utils"      # 大家共用的工具库

然后生成文件：

uv run agentic-cursorrules

实用选项

• --init: 友好的设置向导。
• --verify-config: 试运行，查看当前加载的配置。
• --tree-input: 如果你想从图表生成配置，可以粘贴基于文本的文件树。
• --local-agents: 将生成的 Markdown 文件保存在脚本目录中（适用于测试，避免弄乱你的实际项目目录）。
• --recurring: 每分钟持续运行一次（适用于高频开发的会话）。

你将获得什么

对于每个领域，你都会获得一个类似于 @agent_backend_api.md 的 Markdown 文件。

当你开始与 AI 对话时，请引用该文件。它包含一个仅针对该领域相关文件的可视化树，以及“仅引用和修改此结构内的文件”的指示。这就像给赛马戴上了眼罩——能让它们专注前行，速度更快。

仓库结构

为了让你了解各部分功能：

.agentic-cursorrules/
├── agentic_cursorrules/          # 核心代码库
│   ├── agent_generator.py        # 编写 Markdown 文件
│   ├── config_updater.py         # 管理 yaml 配置文件
│   ├── project_tree_generator.py # 绘制精美的目录树
│   └── smart_analyzer.py         # 分析项目文件夹结构的侦探
├── main.py                       # 入口文件
├── config.yaml                   # 你的设置
└── pyproject.toml                # 依赖项