バウム | システムエンジニア×AI活用術を発信中

現場SE向け｜障害ログ・議事録・テスト仕様書を
AIに「渡してよいか／任せてよいか／採用してよいか」
判断する基準を、実務例とテンプレで発信。
初めての方は固定ポストから。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

設計書や障害ログをAIに渡す前に、毎回迷う。

・この情報は入力してよいか
・外部接続や権限は必要最小限か
・出力をそのまま採用してよいか

その判断を作業前に確認できるよう、現場SE向けの安全利用チェックリストを32項目にまとめました。

生成AIは、使わないことよりも、確認しないまま使うことが危ない。

▼ 現場SEのための生成AI安全利用チェックリスト
https://t.co/JEAkeT2IoX

#生成AI #AIセキュリティ #システムエンジニア

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIがテストの「一覧は1件」を「1件以上」に変えていたら、条件を読み直してください。余計なタスクが出ても成功してしまいます。初期表示が未完了だけの仕様なら、試すデータは未完了Aと完了済みBです。件数が1件で、Aが出てBが出ないことまで確かめます。期待する結果の根拠は仕様です。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIの「テストを追加しました」だけでは、実行したかまでは分かりません。「何を動かして、どうなったかも教えてください」と頼みます。実行に使った指示も残してもらいましょう。コードを読んだだけなら、その旨も聞きます。動かせなかったテストは理由も聞き、説明と実際の出力を見比べます。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

修正前後のテスト結果は、「どこで失敗したか・期待した結果・実際の結果」を並べて残します。準備中のエラーなら、不具合を見つけたかは未確認です。記事では、同じテストで比べる手順と記録の書き方を紹介しています。
https://t.co/d5LelBPCce

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

「テスト成功」とだけ書くと、何を試したのか分かりません。たとえば「未完了Aと完了済みBを用意し、すべて表示に切り替えたら両方が出た」と残します。データ、操作、結果が分かる書き方です。途中で止まったなら、その箇所も書きます。未確認の操作も添えれば、どこまで試せたかが伝わります。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

画面で不具合が直ったら、試した操作をテストにも残したいです。未完了Aと完了済みBを用意して「すべて表示」を選びます。両方が出たら「未完了のみ」に戻し、Aだけになるかを見てください。AIには、このデータと操作、期待する表示を渡します。次の変更でも同じ条件で試せるテストを作るためです。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIに「テストも追加して」と頼む前に、使うデータと操作を書いておきましょう。「未完了Aと完了済みBで、初期表示はAだけ」のように期待する結果も添えます。記事では、既存テストと一緒に渡す依頼文を載せています。
https://t.co/d5LelBQa1M

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIが作ったテストの成功から分かるのは、書かれた条件を満たしたことです。たとえば「タスクが1件以上ある」では、完了済みが混ざっても成功します。未完了Aと完了済みBを用意し、初期表示でAが出ること、Bが出ないこと、一覧が1件であることを確かめてください。件数と表示対象をセットで見ましょう。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIの修正後に問題が残ったら、どの操作で何が起きたかを伝えましょう。
たとえば「すべて表示では未完了Aと完了済みBが出ます。未完了のみに戻すと、AだけになるはずがBも残ります」と書きます。期待どおりに動いた操作も添え、次の修正でも保つよう頼んでください。修正後は同じ操作で再確認します。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIが直したコードは、動作を確かめるテストの内容も見てください。
「初期表示は1件」が「1件以上」に変わると、2件出ても成功と判定されます。元の依頼が「未完了Aだけを表示」なら、件数だけでなく、完了済みBが出ないかも確認しましょう。期待する結果を書き換えた理由も、AIに説明を求めます。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIには、修正した場所と理由も説明してもらいましょう。原因と判断した根拠も必要です。
「修正しました」という返答だけでは、動かして確かめたか分かりません。確認に使った指示と結果も求めてください。コードを読んだだけなら、その旨も書いてもらいます。未確認の項目には、理由も添えてもらいましょう。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIの修正後は、元と同じデータ・開始状態・操作で確かめましょう。期待した結果と実際の結果を並べます。試せなかった項目は「未実施」です。必要な確認が残る間は完了を保留します。記事に再確認と追加依頼の例を載せました。
https://t.co/7K7PLKwRgu

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIに修正を頼むときは、先に「どう動けばよいか」を決めましょう。
表示されない原因がデータを取得する処理にあれば、画面の処理だけでは直せないかもしれません。変更するファイルは、原因を調べてから決めます。修正する場所が増える場合は、追加する理由と影響も確認してください。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIに修正を頼む前に、保ちたい動作も書きましょう。たとえば、一覧を開いた直後、表示を切り替えた後、元に戻した後です。データ0件の場合も確かめます。確認に使うデータと操作を添えたメモの例を記事に載せました。
https://t.co/7K7PLKwjqW

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIに「完了済みも表示して」と頼むときは、変えたくない動作も伝えましょう。
たとえば、一覧を開いた直後は未完了だけを表示する条件です。「すべて表示」から戻した後も同じです。表示を切り替えても、保存済みの完了状態は変えません。直したい動作と保ちたい動作を、修正後にそれぞれ確かめてください。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

「完了済みが表示されない」は、確認した事実です。「表示条件が間違っている」は、まだ推測です。
そもそも画面に届いたデータに、完了済みが含まれていないかもしれません。AIへの依頼では、事実と推測を分けて書きましょう。調べていない点も「未確認」と添え、原因はコードで確かめてもらいます。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIへの修正依頼には、使ったデータと操作を書きましょう。「本来の結果」と「実際の結果」も並べます。正しい動作は元の依頼文で確認してください。原因が不明でも依頼は作れます。記事に記入例とひな型を載せました。
https://t.co/7K7PLKwRgu

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

AIに「表示されない」と伝えるときは、使ったデータと操作も書いてください。
たとえば、未完了Aと完了済みBがあるのに、「すべて表示」でもAしか出ない場合です。一覧を開いてから切り替えるまでの手順を残しましょう。「本来はAとBが出る」と添え、同じ条件で試した結果も記録します。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

コードは、短ければ読みやすいとは限りません。AIが書いた条件を整理するときは、後から読む人が「どの場面で何をするか」を追えるかを見ます。周囲の名前の付け方やエラー処理とも比べます。依頼と関係のない整理まで広げません。読みやすく直した後も、初期表示や切り替えなどの動作をもう一度試します。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

画面で他人のデータを隠すだけでは、閲覧権限の確認は終わりません。URLの利用者IDを書き換えた場合も考えます。API（データをやり取りする窓口）側で、誰のデータを読めるかを確かめます。画面の表示条件だけを根拠にしません。確認する処理が見つからなければ、安全と決めずに調べます。

[バウム | システムエンジニア×AI活用術を発信中 @baum_right]

秘密情報の確認は、コードへの直接記載だけでは終わりません。設定ファイルと実行中の記録も見ます。確認した範囲と未確認の点を分け、次に調べる場所まで残します。記事には、権限や秘密情報の確認メモの記入例もあります。
https://t.co/SsTcKKVVyZ