MochiuWiki : SUSE, EC, PCB

「Windsurfの設定 - AGENTS.md」の版間の差分

📢 Webサイト閉鎖と移転のお知らせ
このWebサイトは2026年9月に閉鎖いたします。
新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）

ビジュアルウィキテキスト
ページの作成:「== 概要 == AGENTS.mdは、Windsurf Cascade向けのディレクトリスコープ型指示ファイルである。<br> Windsurfでは、Cascadeへの指示を定義する方法として、<u>.windsurf/rules/</u> ディレクトリ (推奨) と <u>AGENTS.md</u> ファイル の2種類の現行形式が存在する。<br> <br> AGENTS.mdの主な特徴を以下に示す。<br> * 通常のMarkdown形式 (特殊なフロントマター不要) *: 標準的なMarkdown記…」
 
 
(同じ利用者による、間の1版が非表示)
264行目: 264行目:
<br><br>
<br><br>


== ベストプラクティス ==
== 推奨される事柄 ==
AGENTS.mdの記述におけるベストプラクティスを以下に示す。<br>
AGENTS.mdの記述における推奨される事柄を以下に示す。<br>
<br>
<br>
* 簡潔さの重要性
<center>
*: 300行以下を推奨
{| class="wikitable"
*: 長すぎるとCascadeのコンテキストを圧迫する。
|+ AGENTS.mdの効果的なルール記述
* WHY / WHAT / HOW の3要素
! ポイント !! 説明
*: プロジェクトの目的 (WHY)、技術スタック (WHAT)、コーディング規約 (HOW) を含める。
|-
* 箇条書き・ヘッダー・コードブロックを活用
| 簡潔さの重要性 || 300行以下を推奨<br>長すぎるとCascadeのコンテキストを圧迫する。
*: 構造化された形式がCascadeの理解を助ける。
|-
* 汎用的でない指示は Rules を使用
| WHY / WHAT / HOW の3要素 || プロジェクトの目的 (WHY)、技術スタック (WHAT)、コーディング規約 (HOW) を含める。
*: Windsurf固有の制約 (発動モード等) が必要な指示は .windsurf/rules/ に記載する。
|-
* 具体的な例と明示的な慣例
| 箇条書き・ヘッダー・コードブロックを活用 || 構造化された形式がCascadeの理解を助ける。
*: 抽象的な説明より具体的なコード例・コマンドを優先する。
|-
* コマンドを早期配置
| 汎用的でない指示は Rules を使用 || Windsurf固有の制約 (発動モード等) が必要な指示は <u>.windsurf/rules/</u> に記載する。
*: ビルド・テスト・リントのコマンドをファイル前半に記載する。
|-
* 反復的改善
| 具体的な例と明示的な慣例 || 抽象的な説明より具体的なコード例・コマンドを優先する。
*: 最小限から始め、Cascadeの誤りに応じて指示を追加する。
|-
| コマンドを早期配置 || ビルド・テスト・リントのコマンドをファイル前半に記載する。
|-
| 反復的改善 || 最小限から始め、Cascadeの誤りに応じて指示を追加する。
|}
</center>
<br><br>
<br><br>


「http://mochiuwiki.e2.valueserver.jp/index.php?title=Windsurfの設定_-_AGENTS.md」から取得