現場・改善

他社が作ったツールの不具合を、その場で直せる条件

2026.07.30 / 読了目安 8分 / 執筆: Qronix 開発チーム

#現場主義#CAD自働化#開発の作法#ツール開発事例

他社が作ったツールの不具合を、その場で直してほしい。私たちがよく受ける依頼です。結論から言うと、直せるかどうかはコードの質ではなく5つの条件で決まります。私たちが実際の保守現場でやっている切り分けの手順と、あえて直さないという判断の基準、そして引き継ぐときに必ず取り決めることを書きます。

パズルのピースPhoto: Unsplash
CONTENTS
1. 「他社製ツールが止まった」という電話から始まる 2. その場で直せるかを決める、5つの条件 3. 最初の30分でやる、再現と切り分けの手順 4. 技術的に直せても、直してはいけないケースがある 5. 保守を引き継ぐときに、必ず取り決める4項目 6. そもそも、後から直しやすいツールを作る

「他社製ツールが止まった」という電話から始まる

連絡はたいてい急ぎです。ベンダーとの保守契約が切れている、当時の担当者と連絡がつかない、明日の出図に間に合わない。この3つが揃った状態で相談が来ます。私たちは愛知県の大手自動車メーカー及びグループ各社と直接契約で仕事をしていますが、依頼の一定数がこの種の緊急保守です。

こういうとき、私たちがまず確認するのは技術情報ではありません。ソースコードが手元にあるかと改変が契約上許されるかの2点です。ここが崩れていると、技術的には5分で直せる問題であっても、1週間動けません。焦って解析に入る前に、動ける範囲を確定させます。

実際、原因がファイルパスの1行だと10分で判明したのに、契約上ソースの改変ができず、元ベンダーの回答を待って復旧まで9営業日かかった案件がありました。技術の問題ではなく、権利の問題です。現場には申し訳ないと思いましたが、勝手に直すという選択肢はありません。

だから緊急時ほど、最初に技術以外を確認します。急いでいるときほど、この確認を飛ばしたくなる。しかし飛ばして解析を始めると、直せない場所を直せる気になってしまい、結果的に復旧が遅れます。急ぎの案件ほど順序を守ることが最短経路になる、というのは保守の現場でくり返し確認してきたことです。最初の5分は、必ず契約と権利の確認に使ってください。

その場で直せるかを決める、5つの条件

経験上、他社製ツールをその場で修正できるかどうかは、次の5条件でほぼ判定できます。1つ目、ソースコードがあること。実行ファイルだけが残っている場合、原則として直せません。2つ目、改変の権利があること。契約書か発注仕様書のどちらかで確認します。口頭の了解では動きません。

3つ目、再現できる環境があること。本番でしか再現しない不具合は、修正作業よりリスク管理が主戦場になります。4つ目、正しい出力の見本があること。直したあとに正しさを確認できなければ、修正は完了しません。この4つ目が欠けている案件は非常に多く、実務では最大の障害になります。

5つ目が影響範囲が閉じていることです。そのツールの出力を、他のツールや他部署が参照していないか。参照していれば、直すこと自体が別の場所を壊します。私たちは修正に入る前に、必ず出力ファイルの行き先を追います。ここで想定外の参照が見つかることは珍しくありません。

5つ揃えば、その場で直せます。3つ以下なら、直すのではなく回避策を出すのが正解です。今日をしのぐ手順を作り、恒久対策は別に立てる。この判断を最初の30分でやり切ることが、結果的に最短の復旧につながります。条件が4つの場合はどちらとも言えないので、まず回避策を出して現場を動かし、恒久対策の可否は1日かけて判断します。

その場で直せるかを決める5条件ソースコードがある実行ファイルだけなら原則直せない改変の権利がある契約書か発注仕様書で確認。口頭の了…再現できる環境がある本番でしか再現しないならリスク管理…正しい出力の見本がある欠けている案件が最も多い影響範囲が閉じている出力ファイルの行き先を必ず追う
5つ揃えばその場で直せる。3つ以下なら、直すのではなく今日をしのぐ回避策を出すのが正解。

最初の30分でやる、再現と切り分けの手順

解析の順序は決めています。最初にやるのはコードを読むことではなく、直前に何が変わったかを聞くことです。昨日まで動いていたなら、変わったのはツールではなく環境です。CADのバージョン、Windowsの更新、参照先のフォルダ構成、入力データを作った人。この4つを順に聞いていきます。

次に、失敗したときの入力データそのものを確保します。再実行ではなく、そのときのファイルをそのまま退避してもらう。多くの現場は復旧を急いで上書きしてしまい、原因究明の材料が消えます。私たちが電話口で最初に出す指示はいつも同じで、まず今の状態を保存してください、です。

そのうえで切り分けます。同じデータを別のPCで流す、正常だった過去のデータを今のPCで流す。この2つを実施すれば、原因が環境側かデータ側かがほぼ確定します。ここまでで30分。コードを読むのは、この切り分けが終わった後です。順序を逆にすると、何時間でも溶けます。

実際の内訳を見ると、私たちが受けた緊急保守のうち、コード修正が必要だったのは半分以下でした。残りは環境設定の変化か、入力データ側の異常です。つまりコードを疑うのは最後で構いません。この前提を持っているだけで、初動の速さがまったく変わります。

コードを疑うのは最後でいい。
昨日まで動いていたなら、変わったのは環境だ。

緊急保守の原因内訳環境設定の変化・入力データの異常半数超別PCで流す/過去データを流すで切り分けるコード修正が必要だった案件半分以下コードを読むのは切り分けが終わった後
昨日まで動いていたなら、変わったのはツールではなく環境。この前提だけで初動の速さが変わる。

技術的に直せても、直してはいけないケースがある

技術的に直せることと、直すべきことは別です。私たちが手を止める場面が3つあります。1つ目は、そのツールの出力が公式な検証記録に使われている場合。改変履歴が管理されていないツールの結果を、品質記録として使い続けるのは危険です。ここは正規のプロセスに戻すよう提案します。

2つ目は、不具合が実は仕様である可能性がある場合です。おかしく見える挙動が、当時の設計ルールを正確に反映していることがあります。10年前の担当者が意図的に入れた例外処理を、親切心で直した結果、下流工程で30件の不整合が出た例を見たことがあります。意図が読めない処理は消しません。

3つ目は、その場しのぎの修正が延命になってしまう場合です。もう使うべきでない古いツールを直し続けると、置き換えの機会が永久に来ません。私たちは、直せますがお勧めしません、と伝えることがあります。今期だけで4件ありました。うち3件は、そのまま作り直しの検討に入っています。

保守を引き受ける側として、直せることを示すのは簡単です。難しいのは、直さないほうがいいと言うことです。目の前の売上を捨てることになりますし、依頼者にも喜ばれません。それでもここを言えるかどうかが、一次請けとして仕事をする責任だと私たちは考えています。

緊急保守の依頼から保守の合意まで他社製ツールが止まった最初の5分で契約と権利を確認失敗時の入力データをそのまま退避直前に何が変わったかを聞く別PC・過去データで環境か入力か切り分け5つの条件がそろっている?回避策で今日をしのぎ恒久対策は別に立てる直してはいけないケースに当たる?直さず、正規の手順や作り直しを提案その場で修正する保守の4項目を1枚にまとめて合意継続保守へ欠けがあるそろう当たる当たらない
図3: 権利確認と切り分けのあと、5条件と直してはいけないケースで、修正・回避策・提案に分かれる。

保守を引き継ぐときに、必ず取り決める4項目

緊急対応が落ち着いたら、継続保守の話になります。ここを曖昧にしたまま走り出すと、半年後に必ずもめます。責任範囲の認識がずれたまま何度か対応すると、どちらも相手が悪いと感じるようになるからです。私たちが最初に取り決めるのは4つあり、いずれも技術ではなく約束事の話です。緊急対応の直後、記憶が鮮明なうちに決めるのが最も揉めません。

1つ目、直す範囲。既存の不具合修正までか、環境変化への追随まで含むか、機能追加は別見積もりか。2つ目、正常の定義。何をもって直ったとするか。テストデータと期待結果を必ず一緒に受領します。3つ目、連絡と一次切り分けの担当。現場側で誰が状況を確認して連絡するのかを、1人だけ決めます。

4つ目が元のベンダーへの通知です。他社製ツールに手を入れる以上、可能な限り元の開発元に一報を入れるか、発注元から通知してもらいます。黙って改変すると、後日トラブルが起きたときにどちらの責任か分からなくなります。これは技術の作法というより、仕事の作法だと思っています。

この4つを1枚の紙にまとめて共有するだけで、保守のトラブルは大きく減ります。契約書ほど堅くする必要はありません。メールの本文でも構いません。重要なのは、合意した事実がどこかに残っていることです。記憶だけに残した合意は、半年で必ず食い違います。

保守を引き継ぐときに必ず取り決める4項目1直す範囲不具合修正まで/環境追随まで/機能追加は別見積もり2正常の定義テストデータと期待結果を一緒に受領する3連絡と一次切り分けの担当現場側で1人だけ決める4元のベンダーへの通知技術の作法ではなく仕事の作法
契約書ほど堅くする必要はない。メール本文でもいいので、合意した事実がどこかに残っていること。

そもそも、後から直しやすいツールを作る

他社製ツールの保守を数多く引き受けてきた結果、私たち自身の作り方も変わりました。私たちが納品するツールは、将来まったく別の誰かが直す前提で作っています。作った本人がいなくなった後の可読性が設計基準です。今日の効率より、3年後の他人を優先します。

具体的には、環境依存の設定を1か所に集める、テストデータと期待結果を必ず同梱する、そして異常なデータが来たら処理せず止める。私たちはこの実行前検査を関所と呼んでいます。止まる仕組みがあると、後任者はコードを読まずに「何が前提だったか」を知ることができます。

この考え方は、私たちのAIエージェントQiにもそのまま入っています。Qiの特徴は、AIにコードを生成させないことです。特許第7907964号として登録された方式で、AIは検証済みの社内ツールを選択するだけ。生成しないので、誰も読んだことのないコードが現場に増えません。保守の観点では、これが決定的な差になります。

他社製ツールが止まって困っている、あるいは自社のツールが将来止まりそうで不安だという場合は、状況の整理からお手伝いできます。まずは5つの条件のどこが欠けているかを、一緒に確認するところから始めましょう。直すかどうかの判断は、その後で構いません。

他社製のCATIAマクロでも、ソースが読める状態で納品されていれば私たちはその場で直せます。読めない納品物こそが、本当のロックインです。

ここまで読んで「うちでもやってみたい」と思われたなら、まずは私たちの無料セミナーをのぞいてみてください。改善を金額で語る考え方を、実例を使って一緒に組み立てます。相談だけでも歓迎です。

VBA参考実装例:後任者が読まずに前提を知れる「関所」の書き方
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

止まる仕組みを先に書いておくと、後任者はコードを読まずに前提条件を知ることができます。異常なデータをそのまま流さないので、下流工程の事故も防げます。

Qronix 開発チーム

CATIA歴22年超・愛知県の大手自動車メーカー及びグループ各社でCATIAツール開発の技術責任者を務めたメンバーを中心とする、CAD自働化のスペシャリスト集団。2024年創業、特許第7907964号を保有。

「うちの資産でもできる?」
まずその質問からどうぞ。

できる・できないの判定と自働化設計書のご提案までは無料です。

contact@qronix.jp へ相談する
記事一覧をすべて見る →
← 記事一覧へトップページへ →