コーディング は何をしますか？
このスキルをソフトウェア作業のエントリポイントとして使用してください。このファイルをコンテキストに保持し、タスクに必要な最小限の関連リファレンスセットを読み込んでください。
ルーティング
- 新しいコードの作成や動作の拡張には、
./references/implementation.mdを読んでください。 - リファクタリング、クリーンアップ、簡略化、抽出、再構成、または書き直し作業には、
./references/refactoring.mdを読んでください。 - コードレビュー、PRレビュー、差分批評、またはリスク評価には、
./references/review.mdを読んでください。 - デバッグ、失敗するテスト、リグレッション、ランタイムエラー、CI障害、またはバグ修正には、
./references/debugging.mdを読んでください。 - アーキテクチャ、API設計、モジュール境界、依存関係の方向性、または設計のみの議論には、
./references/design.mdを読んでください。 - 共有のコード品質ルールについては、コードの作成または変更時、およびレビュー/設計中に必要に応じて
./references/standards.mdを読んでください。 - アサーション戦略（不変条件チェック、デバッグ時vsプロダクション時のアサート判断、フェイルファスト契約）については、内部前提を検証するコードを作成またはレビューする際に
./references/assertions.mdを読んでください。
ユーザーの現在のリクエストに必要なリファレンスのみを読み込んでください。タスクに複数のフェーズがある場合は、そのフェーズが開始されたときに次のリファレンスを読み込んでください。
ベースラインルール
- 正確性、安全性、およびユーザーの意図がスタイルの好みより優先されます。
- プロジェクトのフォーマッタ、リンター、テスト、ビルドシステム、フレームワークの規約、およびシステム全体のローカルパターンが、このスキルのデフォルトスタンダードより優先されます。
- ローカルパターンがシステム全体であるとは、複数の近隣ファイルにわたって出現し、ツールによって強制されているか、明確なフレームワーク/アプリケーションの規約の一部である場合を指します。隣接しているだけの一時的な弱いコードをコピーしないでください。
- システム全体のプロジェクトパターンが存在しない場合は、
./references/standards.mdを使用してください。 - ユーザーが明示的に変更を依頼しない限り、公開動作、API、データ契約、マイグレーション、および運用セマンティクスを維持してください。
- 編集範囲はタスクに限定してください。タッチしたコードは一貫性のある結果が得られる程度に改善しますが、関連のないレガシーコードを正規化しないでください。
例の参照
ルールの判断が不明確な場合にのみ例を使用してください。
./examples/README.mdに焦点を絞った例のインデックスがあります。- 一度に1つの該当する例ファイルを開いてください。