code-quality は何をしますか？
コードを書く際に常に考慮すべき、一般的な正確性ルール、Rustパターン、コメント、過剰設計回避のためのガイドライン。
目標
このスキルは、AIエージェント（Claude Code、Cursor、Codexなど）が生成するコードが以下の特性を持つことを保証することを目的としています：
- 正確性: ロジックが正しく、予期しない動作をしないこと
- 可読性: 開発者が容易に理解できること
- 保守性: 変更や拡張が容易であること
- 実用性: 過剰に複雑化せず、問題に適切に対処すること
原則
一般的な正確性
- エッジケースを常に考慮する（空の入力、境界値、エラー状態）
- 不変条件を文書化し、コードでそれを強制する
- 副作用を最小限に抑え、予測可能にする
Rustパターン
- 所有権と借用のルールに従う
- 適切なエラーハンドリング（
Result、Option、カスタムエラー型） - 不必要なアンセーフコードを避ける
- 可能な限りイテレータとクロージャを活用する
コメント
- 「なぜ」を説明し、「何を」は説明しない（コードが自己文書化している場合）
- 複雑なロジックにはインラインコメントを追加する
- 公開APIにはドキュメントコメント（
///）を必ず付ける
過剰設計の回避
- 将来の拡張を予測した抽象化を避ける（YAGNIの原則）
- シンプルな解決策を優先する
- 必要になるまでパフォーマンス最適化を行わない
使用方法
AIエージェントにこのスキルを適用させるには、プロンプトに以下のように含めてください：
スキル tursodatabase/code-quality を適用して、以下のコードを生成してください。
または、エージェントの設定ファイル（例：.claude-skills）にこのスキルを追加することもできます。