他社が作ったツールの不具合を、その場で直せる条件
他社が作ったツールの不具合を、その場で直してほしい。私たちがよく受ける依頼です。結論から言うと、直せるかどうかはコードの質ではなく5つの条件で決まります。私たちが実際の保守現場でやっている切り分けの手順と、あえて直さないという判断の基準、そして引き継ぐときに必ず取り決めることを書きます。
Photo: Unsplash「他社製ツールが止まった」という電話から始まる
連絡はたいてい急ぎです。ベンダーとの保守契約が切れている、当時の担当者と連絡がつかない、明日の出図に間に合わない。この3つが揃った状態で相談が来ます。私たちは愛知県の大手自動車メーカー及びグループ各社と直接契約で仕事をしていますが、依頼の一定数がこの種の緊急保守です。
こういうとき、私たちがまず確認するのは技術情報ではありません。ソースコードが手元にあるかと改変が契約上許されるかの2点です。ここが崩れていると、技術的には5分で直せる問題であっても、1週間動けません。焦って解析に入る前に、動ける範囲を確定させます。
実際、原因がファイルパスの1行だと10分で判明したのに、契約上ソースの改変ができず、元ベンダーの回答を待って復旧まで9営業日かかった案件がありました。技術の問題ではなく、権利の問題です。現場には申し訳ないと思いましたが、勝手に直すという選択肢はありません。
だから緊急時ほど、最初に技術以外を確認します。急いでいるときほど、この確認を飛ばしたくなる。しかし飛ばして解析を始めると、直せない場所を直せる気になってしまい、結果的に復旧が遅れます。急ぎの案件ほど順序を守ることが最短経路になる、というのは保守の現場でくり返し確認してきたことです。最初の5分は、必ず契約と権利の確認に使ってください。
その場で直せるかを決める、5つの条件
経験上、他社製ツールをその場で修正できるかどうかは、次の5条件でほぼ判定できます。1つ目、ソースコードがあること。実行ファイルだけが残っている場合、原則として直せません。2つ目、改変の権利があること。契約書か発注仕様書のどちらかで確認します。口頭の了解では動きません。
3つ目、再現できる環境があること。本番でしか再現しない不具合は、修正作業よりリスク管理が主戦場になります。4つ目、正しい出力の見本があること。直したあとに正しさを確認できなければ、修正は完了しません。この4つ目が欠けている案件は非常に多く、実務では最大の障害になります。
5つ目が影響範囲が閉じていることです。そのツールの出力を、他のツールや他部署が参照していないか。参照していれば、直すこと自体が別の場所を壊します。私たちは修正に入る前に、必ず出力ファイルの行き先を追います。ここで想定外の参照が見つかることは珍しくありません。
5つ揃えば、その場で直せます。3つ以下なら、直すのではなく回避策を出すのが正解です。今日をしのぐ手順を作り、恒久対策は別に立てる。この判断を最初の30分でやり切ることが、結果的に最短の復旧につながります。条件が4つの場合はどちらとも言えないので、まず回避策を出して現場を動かし、恒久対策の可否は1日かけて判断します。
最初の30分でやる、再現と切り分けの手順
解析の順序は決めています。最初にやるのはコードを読むことではなく、直前に何が変わったかを聞くことです。昨日まで動いていたなら、変わったのはツールではなく環境です。CADのバージョン、Windowsの更新、参照先のフォルダ構成、入力データを作った人。この4つを順に聞いていきます。
次に、失敗したときの入力データそのものを確保します。再実行ではなく、そのときのファイルをそのまま退避してもらう。多くの現場は復旧を急いで上書きしてしまい、原因究明の材料が消えます。私たちが電話口で最初に出す指示はいつも同じで、まず今の状態を保存してください、です。
そのうえで切り分けます。同じデータを別のPCで流す、正常だった過去のデータを今のPCで流す。この2つを実施すれば、原因が環境側かデータ側かがほぼ確定します。ここまでで30分。コードを読むのは、この切り分けが終わった後です。順序を逆にすると、何時間でも溶けます。
実際の内訳を見ると、私たちが受けた緊急保守のうち、コード修正が必要だったのは半分以下でした。残りは環境設定の変化か、入力データ側の異常です。つまりコードを疑うのは最後で構いません。この前提を持っているだけで、初動の速さがまったく変わります。
コードを疑うのは最後でいい。
昨日まで動いていたなら、変わったのは環境だ。
技術的に直せても、直してはいけないケースがある
技術的に直せることと、直すべきことは別です。私たちが手を止める場面が3つあります。1つ目は、そのツールの出力が公式な検証記録に使われている場合。改変履歴が管理されていないツールの結果を、品質記録として使い続けるのは危険です。ここは正規のプロセスに戻すよう提案します。
2つ目は、不具合が実は仕様である可能性がある場合です。おかしく見える挙動が、当時の設計ルールを正確に反映していることがあります。10年前の担当者が意図的に入れた例外処理を、親切心で直した結果、下流工程で30件の不整合が出た例を見たことがあります。意図が読めない処理は消しません。
3つ目は、その場しのぎの修正が延命になってしまう場合です。もう使うべきでない古いツールを直し続けると、置き換えの機会が永久に来ません。私たちは、直せますがお勧めしません、と伝えることがあります。今期だけで4件ありました。うち3件は、そのまま作り直しの検討に入っています。
保守を引き受ける側として、直せることを示すのは簡単です。難しいのは、直さないほうがいいと言うことです。目の前の売上を捨てることになりますし、依頼者にも喜ばれません。それでもここを言えるかどうかが、一次請けとして仕事をする責任だと私たちは考えています。
保守を引き継ぐときに、必ず取り決める4項目
緊急対応が落ち着いたら、継続保守の話になります。ここを曖昧にしたまま走り出すと、半年後に必ずもめます。責任範囲の認識がずれたまま何度か対応すると、どちらも相手が悪いと感じるようになるからです。私たちが最初に取り決めるのは4つあり、いずれも技術ではなく約束事の話です。緊急対応の直後、記憶が鮮明なうちに決めるのが最も揉めません。
1つ目、直す範囲。既存の不具合修正までか、環境変化への追随まで含むか、機能追加は別見積もりか。2つ目、正常の定義。何をもって直ったとするか。テストデータと期待結果を必ず一緒に受領します。3つ目、連絡と一次切り分けの担当。現場側で誰が状況を確認して連絡するのかを、1人だけ決めます。
4つ目が元のベンダーへの通知です。他社製ツールに手を入れる以上、可能な限り元の開発元に一報を入れるか、発注元から通知してもらいます。黙って改変すると、後日トラブルが起きたときにどちらの責任か分からなくなります。これは技術の作法というより、仕事の作法だと思っています。
この4つを1枚の紙にまとめて共有するだけで、保守のトラブルは大きく減ります。契約書ほど堅くする必要はありません。メールの本文でも構いません。重要なのは、合意した事実がどこかに残っていることです。記憶だけに残した合意は、半年で必ず食い違います。
そもそも、後から直しやすいツールを作る
他社製ツールの保守を数多く引き受けてきた結果、私たち自身の作り方も変わりました。私たちが納品するツールは、将来まったく別の誰かが直す前提で作っています。作った本人がいなくなった後の可読性が設計基準です。今日の効率より、3年後の他人を優先します。
具体的には、環境依存の設定を1か所に集める、テストデータと期待結果を必ず同梱する、そして異常なデータが来たら処理せず止める。私たちはこの実行前検査を関所と呼んでいます。止まる仕組みがあると、後任者はコードを読まずに「何が前提だったか」を知ることができます。
この考え方は、私たちのAIエージェントQiにもそのまま入っています。Qiの特徴は、AIにコードを生成させないことです。特許第7907964号として登録された方式で、AIは検証済みの社内ツールを選択するだけ。生成しないので、誰も読んだことのないコードが現場に増えません。保守の観点では、これが決定的な差になります。
他社製ツールが止まって困っている、あるいは自社のツールが将来止まりそうで不安だという場合は、状況の整理からお手伝いできます。まずは5つの条件のどこが欠けているかを、一緒に確認するところから始めましょう。直すかどうかの判断は、その後で構いません。
他社製のCATIAマクロでも、ソースが読める状態で納品されていれば私たちはその場で直せます。読めない納品物こそが、本当のロックインです。
ここまで読んで「うちでもやってみたい」と思われたなら、まずは私たちの無料セミナーをのぞいてみてください。改善を金額で語る考え方を、実例を使って一緒に組み立てます。相談だけでも歓迎です。
Option Explicit
' ===== 実行前検査(関所) =====
' この関数自体が「何を前提にしたツールか」の宣言になる。
' 文書と違って実物と一緒に動くので、古びない。
Private Function 前提を満たすか(ByVal 入力パス As String) As Boolean
前提を満たすか = False
If Dir(入力パス) = "" Then
MsgBox "入力ファイルがありません: " & 入力パス, vbCritical
Exit Function
End If
' 列構成が変わったら、処理せず止める(黙って進めない)
If ThisWorkbook.Sheets("入力").Cells(1, 1).Value <> "図番" Then
MsgBox "1列目が『図番』ではありません。様式が変わった可能性があります。", vbCritical
Exit Function
End If
前提を満たすか = True
End Function
Public Sub 変換を実行する(ByVal 入力パス As String)
If Not 前提を満たすか(入力パス) Then Exit Sub ' 異常なら流さない
Call 本処理(入力パス)
End Sub止まる仕組みを先に書いておくと、後任者はコードを読まずに前提条件を知ることができます。異常なデータをそのまま流さないので、下流工程の事故も防げます。
記事一覧をすべて見る →