ソフトウェア設計哲学スキル は何をしますか？
John Ousterhoutの原則に基づいたソフトウェア設計のガイダンスを提供し、開発中のコード品質、アーキテクチャ、保守性を向上させます。
概要
このスキルは、John Ousterhout氏の著書『A Philosophy of Software Design』で提唱された設計原則を実践的に応用するためのガイドです。ソフトウェアの複雑さを管理し、モジュール性を高め、長期的な保守性を確保するための具体的なアドバイスを提供します。
主な原則
- 深いモジュール: インターフェースはシンプルに保ち、内部の複雑さを隠蔽する
- 情報隠蔽: 実装の詳細をカプセル化し、依存関係を減らす
- 複雑さの低減: 偶発的な複雑さを排除し、本質的な複雑さのみに集中する
- 一貫性: 命名規則、設計パターン、アーキテクチャ全体で一貫性を保つ
- 変更の分離: 変更が他のコードに与える影響を最小限に抑える
使用方法
開発中に以下のような質問でこのスキルを呼び出せます：
- 「このクラスの設計をレビューして、Ousterhoutの原則に基づいて改善点を教えてください」
- 「この関数の複雑さを減らすためのリファクタリング案を提案してください」
- 「このモジュールのインターフェースは深いですか、浅いですか？」
- 「依存関係を減らすにはどうすればよいですか？」
例
# 浅いモジュールの例（非推奨）
def process_data(data):
# 複雑な処理をすべてここで行う
cleaned = clean(data)
validated = validate(cleaned)
transformed = transform(validated)
saved = save(transformed)
return saved
# 深いモジュールの例（推奨）
class DataProcessor:
def process(self, data):
# 内部の複雑さを抽象化
return self._pipeline.execute(data)
サポート環境
- Claude Code
- Cursor
- Codex (GitHub Copilot)
- その他のAIエージェント
注意事項
このスキルは設計上の助言を提供するものであり、特定のフレームワークや言語に依存しません。ただし、提供するコード例は主にPythonを使用しています。