YLFコーディング規約
これは現在のタスクのみに使用してください。これらの規約をプロジェクトで永続的にするには、ylf-project-instructions を使用してください。
このスキルは意図的に短くしています。すべてのプロジェクトルールをこのファイルに詰め込むのではなく、現在のプロジェクトを読んで適応してください。
プロセス
-
完了を定義する。
- 具体的な成果と、それをどのように検証するかを明示します。
- 重要な作業の場合は、簡潔なチェックリストを作成し、作業を進めながら更新します。
- 完了とは、要求された結果が動作し、可能な限り検証され、明確に報告された状態を意味します。
-
プロジェクトに適応する。
- まず、アクティブなプロジェクトの指示を読みます:
AGENTS.md、CLAUDE.md、READMEファイル、パッケージスクリプト、テスト設定、および近くのコード。 - プロジェクトルールはこのスキルよりも優先されます。このスキルは、作業方法のギャップを埋めます。
- 既存のパターン、依存関係、命名規則、ファイルレイアウト、および検証コマンドに従います。
- それが通常の解決策である場合、カスタム実装よりも、成熟したプロジェクト依存関係または適切にメンテナンスされたオープンソースパッケージを優先します。
- まず、アクティブなプロジェクトの指示を読みます:
-
重要な場合にのみ明確にする。
- タスクが明確でリスクが低い場合は、先に進みます。
- アーキテクチャ、データ構造、外部サービス、破壊的なアクション、大規模なリファクタリング、または曖昧な範囲など、影響の大きい選択の前には立ち止まって質問します。
- 質問するときは、推奨する回答とトレードオフを示します。
-
外科的に変更する。
- 要求を満たす最小の変更を行います。
- タスクで必要とされない限り、隣接するコードのリファクタリング、再フォーマット、名前変更、またはクリーンアップは行いません。
- 自身の変更によって作成された未使用のコードのみを削除します。
- 修正が無関係なファイルに波及し始めた場合は、続行する前に停止し、その境界を説明します。
-
実際に検証する。
- バグ:可能な場合はまず再現し、その後修正を証明します。
- スクリプト:代表的な入力を使用して実行し、出力を検査します。
- Web/UI:ページを開き、レンダリングを確認し、変更したフローを実行します。
- デプロイメントと統合:アクセスが存在する場合は、ライブサービスまたはコントロールプレーンを確認します。
- 既存の環境ノイズによって完全な検証が妨げられている場合は、要求された結果を証明する最も狭いチェックを実行し、未検証のまま残っているものを伝えます。
-
安全境界を維持する。
- ユーザーが明示的に要求しない限り、gitアクションを実行しないでください。
- ファイルまたはディレクトリをバッチ削除しないでください。一度に削除するのは、明示的な単一ファイルパスのみです。一括削除が必要な場合は、停止してユーザーに処理を依頼してください。
- シークレットを公開しないでください。シークレットが存在することや、名前が一致することを確認することは問題ありません。
- Windowsでは、ファイルロック、pnpmのno-TTY問題、古いビルドアーティファクトなどの環境ノイズを、変更の正しさから分離します。
-
簡潔に報告する。
- 何を変更したか、結果は何か、何を検証したかをユーザーに伝えます。
- 本当に未解決の項目のみに言及します。
- ユーザーが要求しない限り、最終報告書に実装の詳細を含めないでください。
整理
このスキルを更新する際は、動作を変更するルールのみを保持してください。長い例、ツールのチュートリアル、プロジェクト固有の事実は削除してください。これらはプロジェクトの指示または別のスキルに属します。