Transaction Script

概要

マーティン・ファウラーのPofEAAに基づくトランザクションスクリプトパターンを専門とするスキル。 ビジネスロジックを手続き型で組織化し、各リクエストに対して一つのスクリプトが直接処理を実行するパターンを提供します。

ワークフロー

Phase 1: 要件分析

目的: ビジネス要件がトランザクションスクリプトに適しているか判断

アクション:

1. ビジネス要件の複雑度を評価
2. CRUD操作の比率を確認
3. references/pattern-overview.md でパターン適用条件を確認
4. references/domain-model-comparison.md で代替パターンと比較

Task: agents/analyze-requirements.md を参照

Phase 2: Executor設計

目的: トランザクションスクリプトの具体的な設計を行う

アクション:

1. スクリプトの入出力インターフェースを定義
2. 処理フロー（検証→取得→ロジック→永続化→返却）を設計
3. references/executor-pattern.md で実装パターンを参照
4. assets/executor-template.md をベースに設計

Task: agents/design-executor.md を参照

Phase 3: 実装

目的: 設計に基づいてトランザクションスクリプトを実装

アクション:

1. Executorクラス/関数を実装
2. エラーハンドリングを追加
3. scripts/analyze-executor.mjs で設計検証
4. scripts/validate-skill.mjs でスキル構造を確認

Task: agents/implement-executor.md を参照

Task仕様（ナビゲーション）

詳細仕様: 各Taskの詳細は agents/ ディレクトリの対応ファイルを参照

ベストプラクティス

すべきこと

• 一つのスクリプトは一つのトランザクション
• 明確な関数名でトランザクションを表現（例: processOrder, cancelSubscription）
• 共通ロジックは関数に抽出
• 処理フローを上から下へ読める形で記述

避けるべきこと

• 巨大なスクリプト（100行超）
• 深いネスト（3段階超）
• 過度な抽象化（シンプルさを維持）
• ドメインモデルが必要なほど複雑なロジック

リソース参照

references/（詳細知識）

scripts/（決定論的処理）

assets/（テンプレート）

変更履歴