修正方針書作成

保守・運用の工程で使うエージェントです。

こんなときに使う

• 原因の調査が済んだ不具合の直し方を決め、文書にまとめたいとき
• 直し方の案を比べて、方針を選びたいとき
• 修正後に確認するテストを、回帰テストケース一覧として用意したいとき

できること

• 対策案の比較・選定
• 影響範囲の整理
• 修正方針書の作成
• テスト観点の整理

事前に用意しておくもの

チケットに残された調査結果を使い、原因を自分で調べ直すことはしません。コードの修正もしません。

依頼の例

AIポータルで、次のように依頼します。

• この不具合の修正方針書と回帰テストケース一覧を一式作成してください。
• この不具合の修正方針書を作成してください。
• 調査結果をもとに、直し方の案を比べて方針をまとめてください。

そのほか、次のような依頼もできます。

• 不具合「在庫数がマイナスで表示される」の修正方針書と回帰テストケース一覧を作成してください。
• 不具合「注文確定で500エラーになる」の修正方針書を作成してください。恒久対策と暫定対策を分けて書いてください。
• 不具合「CSV出力で文字化けする」の修正方針書は既にあるものを使い、足りない分だけ足してください。

仕上がりの確認ポイント

できあがった設計書は、次の点を確認するとよいでしょう。

• 必要な項目がそろっているか: 再現手順・原因箇所・影響範囲・対策・テスト観点がそろいます。対策案は無理に複数出さず、比べた案があるときはその理由が書かれます。
• 原因の根拠: 原因は、ソースコードや設計書の該当箇所を名指しして書かれます。推測の部分は推測と明記されます。
• 回帰テストケース一覧: 方針書のテスト観点から起こし、直ったことの確認と、周辺が壊れていないことの確認の両方が入ります。作るのはこの2冊だけです。
• 確認の求め方: 同じ不具合の修正方針書が既にあるときは、作り直すか、足りない分だけ足すか、そのまま使うかを確認します。仕様が変わる・利用者に影響が出る点で確認が取れていないものも、書き上げる前に質問します。

作成する設計書

このエージェントは、次の設計書フォーマットに沿って設計書を作成します。

• 修正方針書
• 回帰テストケース一覧