daily-coding

日々のコーディングチェックリスト

すべてのコード変更でベストプラクティスに従うための、簡潔なコード品質保証チェックリストです。

使用するタイミング

次の場合にこのスキルを使用します。

• 新機能を実装する
• コードを追加する、または既存のコードを変更する
• 「〜を書いて」「〜を実装して」「〜を追加して」「〜を変更して」などのユーザーリクエスト
• Edit または Write ツールを使うコーディングタスク全般

使用しないタイミング

次の場合はこのスキルを使用しないでください。

• 変更する意図のない、純粋な読み取りや理解のタスク
• bug-detective、architecture-design、verification-loop などの専門スキルですでに対応している作業
• 設定のみの変更
• ドキュメントのみの作成

基本チェックリスト

開始前

• 変更前に読む - 変更を加える前に、必ず Read ツールで対象ファイルを読む
• コンテキストを理解する - 既存のコードのロジックと設計意図を理解していることを確認する

コーディング中

• 変更は最小限に - 必要な変更だけを行い、過剰な設計や無関係な機能の追加は避ける
• 型安全性 - Python には型ヒントを追加し、TypeScript では any を避ける
• セキュリティチェック - コマンドインジェクション、XSS、SQL インジェクションの脆弱性を避ける

完了後

• 実行を確認する - 構文エラーがなく、コードが正しく動作することを確認する
• クリーンアップする - デバッグ用の print／console.log 文と一時ファイルを削除する
• 簡潔に要約する - 変更内容と影響範囲をユーザーに伝える

クイックリファレンス

避けるべきよくある間違い

# ❌ Don't
def process(data=[]):  # Mutable default argument
    pass

# ✅ Should
def process(data: list | None = None):
    data = data or []

# ❌ Don't
except:  # Bare except
    pass

# ✅ Should
except ValueError as e:
    logger.error(f"Processing failed: {e}")
    raise

セキュリティチェックポイント

• ユーザー入力は検証またはエスケープする必要があります
• ファイルパスには pathlib を使用し、パストラバーサルを避ける
• 機密情報（API キー、パスワード）をハードコードしない