バグ修正タスク起票テンプレート¶

1. バグ概要¶

• 発生環境：VPS-ROOT (Ubuntu 24.04.2 LTS)
• 発生条件：mcp-redmine-templatesコマンド実行時
• 再現手順：mcp-redmine-templatesコマンドを実行すると「vps-status」コマンドが見つからないエラーが発生
• 影響範囲：チケット作成後のMCPコマンド実行部分

2. 切り戻し準備¶

• 最新バックアップ日時：2025-06-07 00:42:00
• バックアップ場所：/root/redmine-mcp (feature/ticket-templates ブランチ)
• 復元手順の確認：完了 [x]

3. ゴール確認¶

• 修正目標：mcp-redmine-ticketコマンド実行時にMCPコマンド実行エラーが発生しないようにする
• 期待される動作：チケット作成後にMCPコマンドが正常に実行される、または実行エラーがユーザーに表示されない
• 完了条件：チケット作成が正常に完了し、エラーメッセージが表示されないこと

4. 前提確認¶

インフラ構成¶

• VPS-root構成状態：Ubuntu 24.04.2 LTS
• 動作中コンテナ：redmine-mcp, redmine-prod
• 関連サービスの状態：RedmineMCP API

バージョン管理¶

• Gitリポジトリ：/root/redmine-mcp
• ブランチ戦略：feature/ticket-templates
• 現在のブランチ：feature/ticket-templates

関連リソース¶

• 関連チケット：#287 (MCPツール改修: チケット起票テンプレート機能の実装)
• エラーログ：2025-06-07 00:42:02 +0900: [ERROR] MCPコマンド実行に失敗しました: No such file or directory - ./vps-status
• モニタリング情報：なし

5. 修正方針¶

• 原因分析：config.yml に設定されているpost_create_commandが「./vps-status」となっており、このパスにコマンドが存在しない
• 修正アプローチ：
  1. config.ymlのpost_create_commandを正しいパスに修正する
  2. もしくはMCPコマンド実行時のエラーハンドリングを改善し、エラーメッセージを表示しないようにする
• 対応優先度の判断理由：機能の主要部分（チケット作成）は正常に動作しているため、中優先度で対応

6. 修正設計¶

• 影響を受けるコンポーネント：
  • /root/redmine-mcp/mcp-redmine/config.yml
  • /root/redmine-mcp/mcp-redmine/mcp_redmine_template_manager.rb
• 変更が必要なコード：
  1. config.yml のpost_create_commandを修正
  2. mcp_redmine_template_manager.rb のexecute_mcp_command関数のエラーハンドリングを改善
• 副作用の可能性：なし

7. 試験仕様¶

• 再現テスト：mcp-redmine-ticket コマンドを実行し、エラーメッセージが表示されることを確認
• 修正確認テスト：修正後にmcp-redmine-ticket コマンドを実行し、エラーメッセージが表示されないことを確認
• 回帰テスト：チケット作成機能が正常に動作することを確認

8. デプロイ方法¶

• デプロイ手順：
  1. config.yml またはmcp_redmine_template_manager.rb を修正
  2. git add, commit, push で変更をコミット
• リリースタイミング：即時
• ロールバック手順：git checkout で前のコミットに戻す

9. 成果物と残課題¶

• 作成する成果物：修正したconfig.yml またはmcp_redmine_template_manager.rb
• 修正後のモニタリング計画：チケット作成コマンド実行時のログを確認
• 残課題：他のMCPコマンドとの連携を確認する

タスク管理¶

• 担当者：システム管理者
• 優先度：中
• 完了予定日：2025-06-10
• 工数見積：0.5人日

コミュニケーション¶

• 進捗報告方法：Redmineチケットへのコメント
• レビュアー：開発チーム
• 関係者への通知：なし