Skip to content

debugger.md

Latest commit

 

History

History
120 lines (98 loc) · 4.65 KB

debugger.md

File metadata and controls

120 lines (98 loc) · 4.65 KB

自然言語マクロプログラミング デバッガー仕様書

本仕様書は、自然言語マクロプログラミングにおけるデバッグ機能の詳細定義と実行指針を規定します。

🔧 デバッグモード構文定義

基本デバッグ指示

「デバッグモードで[処理内容]を実行してください」

詳細レベル指定

  • 簡易デバッグ: 「簡易デバッグモードで実行してください」
  • 標準デバッグ: 「デバッグモードで実行してください」
  • 詳細デバッグ: 「詳細デバッグモードで実行してください」

要素別デバッグ

  • 変数追跡: 「変数{{name}}をデバッグ追跡しながら実行してください」
  • 条件分岐: 「条件分岐をデバッグしながら実行してください」
  • エラー詳細: 「エラー発生時に詳細説明付きで実行してください」

📋 標準出力フォーマット

基本出力形式

[DEBUG] ステップ[番号]: [実行内容の説明]
[DEBUG] 変数状態: {{variable_name}} = [現在値]
[DEBUG] 判断根拠: [条件評価の理由]
[DEBUG] 次のアクション: [次に実行する処理]

変数操作時の出力例

[DEBUG] ステップ1: 変数{{weather}}に天気情報を保存中
[DEBUG] 実行内容: Web検索で今日の天気を取得
[DEBUG] 変数状態: {{weather}} = "晴れ、気温25度、湿度60%"
[DEBUG] 判断根拠: 晴れ → 日差し対策必要, 25度 → 暑さ対策必要
[DEBUG] 次のアクション: {{weather}}を基に服装提案を生成

条件分岐時の出力例

[DEBUG] ステップ2: 条件「{{score}} >= 80」を評価中
[DEBUG] 変数状態: {{score}} = 85
[DEBUG] 条件分析: 85 >= 80 = true
[DEBUG] 判断根拠: 85は80以上のため高評価ブランチに進行
[DEBUG] 分岐決定: 優秀評価メッセージ生成ルートを選択
[DEBUG] 次のアクション: 優秀評価メッセージを生成

複合条件処理の出力例

[DEBUG] 複合条件分析:
- 条件A: {{weather}} == "雨" → "雨" == "雨" = true
- 条件B: {{temperature}} < 20 → 15 < 20 = true
- 条件C: {{plan}} == "屋外" → "屋外イベント" contains "屋外" = true
[DEBUG] 複合判定: (A AND B AND C) = (true AND true AND true) = true
[DEBUG] 判断根拠: 全条件が満たされるため雨天時屋外対策ルートを実行

🎯 詳細レベル別仕様

簡易デバッグモード

  • 重要な変数変更のみ表示
  • 主要な条件分岐の結果のみ報告
  • 出力量を最小限に抑制

標準デバッグモード

  • 全ての変数操作を表示
  • 条件分岐の詳細な評価過程を説明
  • 判断根拠と次のアクションを明示

詳細デバッグモード

  • 中間計算過程も詳細に表示
  • エラーハンドリングの内部動作を説明
  • パフォーマンス情報も含めて報告

⚠️ エラー時デバッグ出力

エラー発生時の標準形式

[DEBUG] エラー検出: [エラーの概要]
[DEBUG] エラー詳細: [具体的なエラー内容]
[DEBUG] 発生箇所: ステップ[番号] - [処理内容]
[DEBUG] 変数状態: [エラー発生時の変数値]
[DEBUG] 原因分析: [エラーの推定原因]
[DEBUG] 修正提案: [解決策の提案]
[DEBUG] 代替実行: [可能な代替処理]

エラーハンドリング例

[DEBUG] エラー検出: 無効な予算値が設定されました
[DEBUG] エラー詳細: {{budget}} = -50000 (負の値は無効)
[DEBUG] 発生箇所: ステップ3 - 予算データ検証処理
[DEBUG] 変数状態: {{budget}} = -50000, {{required_qty}} = 0
[DEBUG] 原因分析: 入力データの妥当性チェックが不十分
[DEBUG] 修正提案: 予算を正の値（例：150000円）に修正
[DEBUG] 代替実行: デフォルト予算100000円で処理を継続

🔍 実行時動作仕様

デバッグ情報生成原則

  1. 透明性: 全ての判断過程を明示
  2. 追跡可能性: 変数の変遷を完全に記録
  3. 理解容易性: 非技術者でも理解可能な説明
  4. 実用性: 問題解決に直接役立つ情報を提供

📚 使用ガイドライン

デバッグモード実行手順

  1. debugger.md読み込み: デバッグ機能の有効化
  2. デバッグ指示実行: 適切な詳細レベルを指定
  3. 出力分析: デバッグ情報を基に問題を特定

使用上の注意事項

  • デバッグ出力は大量になる可能性があります
  • 機密情報が含まれる場合は出力内容に注意してください
  • 長期間のワークフローでは特に有用性が高まります