Marketplace

applying-code-principles

基本的なソフトウェア原則 - SOLID、DRY、オッカムの剃刀、ミラーの法則、YAGNI。 トリガー: 原則, シンプル, 複雑, アーキテクチャ, リファクタリング, 保守性, コード品質, design pattern, best practice, clean code

allowed_tools: Read, Grep, Glob

$ 安裝

git clone https://github.com/thkt/claude-config /tmp/claude-config && cp -r /tmp/claude-config/.ja/skills/applying-code-principles ~/.claude/skills/claude-config

// tip: Run this command in your terminal to install the skill


name: applying-code-principles description: > 基本的なソフトウェア原則 - SOLID、DRY、オッカムの剃刀、ミラーの法則、YAGNI。 トリガー: 原則, シンプル, 複雑, アーキテクチャ, リファクタリング, 保守性, コード品質, design pattern, best practice, clean code allowed-tools: Read, Grep, Glob

コード原則

Claudeはすべての原則を知っている。このファイルはプロジェクト固有の閾値と優先順位を定義。

優先順序

原則が衝突した場合:

  1. 安全第一 - セキュリティ、データ整合性
  2. YAGNI - 不要なものは作らない
  3. オッカムの剃刀 - 最もシンプルな解決
  4. SOLID - 複雑なシステム向け
  5. DRY - 重複を排除(明確性を犠牲にしない)
  6. ミラーの法則 - 7±2の認知限界を尊重

クイック判断質問

  • 「もっとシンプルな方法は?」(オッカムの剃刀)
  • 「1分以内に理解できる?」(ミラーの法則)
  • 「知識を重複させている?」(DRY)
  • 「今必要?」(YAGNI)
  • 「変更する理由は1つ?」(SOLID/SRP)

閾値

ミラーの法則

対象理想最大限界
関数引数357
クラスメソッド579
条件分岐357

DRY

  • 3回ルール: 3回目の重複で抽象化

SOLID

  • 2番目の実装が現れたときのみインターフェースを作成
  • 単一実装のインターフェースは不可

YAGNI

追加前に確認:

  1. 問題が今存在する? → No = 作らない
  2. 本番で失敗した? → No = エラーハンドリングはまだ不要
  3. ユーザーが要求した? → No = 機能はまだ不要
  4. 測定された証拠がある? → No = 最適化はまだ不要