agentic-cursorrules

agentic-cursorrules是一個基於Python的工具，通過嚴格的文件樹分區和領域邊界來管理大型代碼庫中的多個AI代理。它通過分區代碼庫、生成特定領域的Markdown文件，並為AI代理提供明確的上下文和訪問規則，來預防合併衝突並保持代碼庫的一致性。這個工具的背景是提高AI輔助開發中的項目管理效率，特別是在復雜的項目中，通過減少衝突和提高代碼的可維護性。該工具主要優點包括減少代碼衝突、提高開發效率和可維護性，適用於需要在不同代碼部分使用AI輔助的大型項目。

需求人群：

"目標受眾為軟件開發者和團隊，特別是在進行大型項目開發時需要使用AI輔助以提高效率和減少代碼衝突的場景。該工具適合需要在不同代碼部分使用AI輔助的大型項目，幫助開發者維護代碼的清晰結構和減少開發中的衝突。"

使用場景示例：

在一個大型的Web開發項目中，前後端開發者使用agentic-cursorrules來分別管理他們的代碼部分，減少合併時的衝突。

數據庫開發者利用該工具專注於數據庫層的代碼，而不影響其他服務層的開發。

在進行微服務架構的項目中，每個服務由一個專門的AI代理管理，通過agentic-cursorrules確保服務間的代碼不會產生衝突。

產品特色：

- 代碼庫分區：通過YAML配置定義清晰的邊界，並為每個領域生成單獨的文件樹。

- 訪問控制：每個代理只接收其特定領域文件樹信息，並在定義的邊界內操作。

- 衝突預防：通過智能文件樹分區實現物理分離，顯著降低修改重疊的風險。

- 領域配置靈活：通過YAML文件靈活配置領域，適應不同項目需求。

- 支持多達4個並發代理：優化支持多代理環境，提高性能和管理效率。

- 基於Markdown的指令集：為代理提供詳細的操作指令和上下文信息。

- 文件樹上下文感知：代理能夠理解文件樹結構，提供更精準的代碼輔助。

使用教程：

1. 克隆項目到本地：使用`git clone`命令將agentic-cursorrules項目克隆到本地目錄。

2. 安裝依賴：在項目目錄下創建虛擬環境並激活，然後使用`pip install -r requirements.txt`安裝所需的依賴。

3. 配置.cursorrules文件：將.example配置文件複製並重命名為.cursorrules，並根據需要調整配置。

4. 配置領域：在config.yaml文件中定義項目的領域和架構邊界。

5. 運行代理生成器：執行`python main.py`來生成代理文件，或者使用`--recurring`選項進行定期更新。

6. 引用代理文件：在開發環境中引用生成的代理Markdown文件，以啟用特定領域的AI代理功能。