docs: add Cursor project rules for AI coding with plugin development standards

Change-Id: I3f578b11e29e018a746a9530d2995fec99eabb4b
Co-developed-by: Cursor <noreply@cursor.com>
This commit is contained in:
johnlanni
2025-11-17 20:40:58 +08:00
parent 810ef8f80b
commit 399dcb1ead
5 changed files with 249 additions and 5 deletions

View File

@@ -164,6 +164,31 @@ git config --get user.email
PR は Higress プロジェクトファイルを変更する唯一の方法です。レビュアーが目的をよりよく理解できるようにするために、PR 説明は詳細すぎることはありません。貢献者には、[PR テンプレート](./.github/PULL_REQUEST_TEMPLATE.md) に従ってプルリクエストを完了することを奨励します。
#### AI Coding ツール使用時の特別な要件
AI Coding ツールCursor、GitHub Copilot など)を使用して PR を生成する場合、以下の**厳格な要件**があります:
**新規独立プラグインのシナリオ**(新しく実装された wasm プラグインや golang-filter プラグインなど)の場合:
- プラグインディレクトリの下に `design/` ディレクトリを作成する**必要があります**
- AI Coding ツールに提供した設計ドキュメントを `design/` ディレクトリに配置してください
- PR の説明に AI Coding サマリーを提供してください
**通常の更新/変更のシナリオ**の場合:
- PR の説明に AI Coding ツールに与えたプロンプト/指示を提供してください
- PR の説明に AI Coding サマリーを提供してください
**AI Coding サマリーには以下を含める必要があります**
- 行われた重要な決定
- 実装された主要な変更
- 重要な考慮事項または制限事項
**レビュー優先度に関する通知**
- AI Coding ツールを使用したが上記の要件に従わなかった場合、PR のレビュー優先度が**低下**します
- 要件を満たしていない AI Coding PR に対して、タイムリーなレビューを**保証できません**
- AI Coding ツールを使用せずに完了した PR の場合、これらの追加要件は適用されません
これらの要件の目的は、AI で生成されたコードが十分に文書化され、追跡可能であることを保証し、コードレビューと後続のメンテナンスを容易にすることです。プロンプト/設計ドキュメントを要求することで、開発意図とコンテキストをより良く理解できます。
### 開発前の準備
```shell