属人化したツールが、担当者の異動で死ぬ前にやること
毎年3月と10月、私たちの電話は鳴ります。異動で担当者がいなくなり、誰も中身を知らないツールが止まったという相談です。属人化の脱却とは、人を増やすことでも作り直すことでもありません。止まったときに誰が何を見ればいいかを、動いているうちに決めておくこと。その具体手順を書きます。
Photo: Unsplash動いているツールは、資産ではなく負債かもしれない
現場には、誰かが善意で作ったツールが必ずあります。マクロ、バッチ、Excelのシート。よく動いていて、部署の生産性を確実に上げている。だからこそ誰も触らないし、誰も中身を見ません。触る必要がないという状態が、そのまま誰も分からないという状態に変わっていく。ここで属人化が静かに完成します。
私たちは引き継ぎ案件に入るとき、まずそのツールが止まったときの被害額を聞きます。1日止まると何人が何時間待つか。答えられない場合、そのツールは管理されていません。管理されていない仕組みの上に日常業務が乗っている状態は、会計上どう扱われていようと、実態としては資産ではなく負債です。
実際にあった例では、日次で出図データを整形するマクロが1本止まり、20人の設計者が半日分の手作業に戻りました。被害はおよそ80時間です。作者はすでに他部署へ異動しており、連絡自体はついたものの、本人も3年前の自分のコードを読み直すのに2日かかりました。悪意も怠慢もなく、ただ記憶が消えていただけです。
怖いのは、この負債が帳簿のどこにも載らないことです。誰も損失を計上していないので、対策の優先度が上がりません。予算も付きません。だから毎年、同じ種類の事故が別の部署で起き続けます。私たちが最初にやるのは、この見えない負債を数字にして見えるようにすることです。
ツールが死ぬのは、壊れたときではなく人が動いたとき
ツールが使えなくなる原因を集計すると、コードのバグは少数派です。多いのは環境側の変化でした。CADのバージョンが上がった、サーバのパスが変わった、参照していたマスタの列が1つ増えた、Windowsの更新でダイアログの挙動が変わった。どれもツール本体は無傷なのに、動かなくなります。
こうした変化は毎年必ず起きます。問題は、変化が起きたときに直せる人が現場にいるかどうかだけです。つまりツールの寿命は、コードの品質ではなく保守できる人が現場にいる期間で決まります。そしてこの期間は、本人の意思とは無関係に、人事異動で唐突にゼロになります。予告はありません。
だから対策のタイミングは、壊れてからではありません。人事の内示が出てからでも遅い。動いていて、作者もいて、何も問題が起きていない今が、唯一の準備期間です。私たちが引き継ぎの相談で最初に伝えるのはこの一点で、たいていは早すぎると言われます。しかし早すぎたことは一度もありません。
ちなみに私たちは、ツール納品時に必ず「このツールは何年後に何が原因で止まるか」を書いた紙を1枚添えています。予言ではなく、変化に弱い箇所の申告です。CADのバージョン依存はここ、パス依存はここ、と具体的に書く。これがあるだけで、数年後の後任者の初動がまったく変わります。CATIAのバージョンが上がった年に、放置していたツールがまとめて動かなくなるのも同じ理由です。
まず1日でやる棚卸し——列は3つだけでいい
属人化脱却の第一歩は、コードを読むことではありません。何が存在しているかを数えることです。私たちは初日に、部署内のツールを全部書き出してもらいます。凝った管理台帳は不要で、Excelに3列あれば足ります。立派な台帳を作ろうとした現場は、フォーマット決めで2週間使い、そこで力尽きました。
列は名前、止まると誰が困るか、今わかる人の3つです。3列目が空欄、または特定の1人の名前しか書けないものが、そのまま危険度の高い順のリストになります。1列目と2列目は誰でも書けます。3列目だけが本当の情報で、ここを埋める作業に価値があります。100本あっても半日で終わります。
ある部門で実施したときは、47本のツールが出てきて、うち11本が3列目を空欄でした。作者不明のまま3年動いていたものが4本。誰も中身を知らないのに、月末処理の中核に組み込まれているものが1本ありました。当然、この1本から着手しました。優先順位を議論する必要すらありませんでした。
全部を守ろうとしないでください。棚卸しの目的は完璧なリストを作ることではなく、先に死ぬ順番を知ることです。順番がわかれば、限られた保守工数をどこに使うかを判断できます。判断できれば、守れなかったツールが止まっても、それは事故ではなく想定内の出来事になります。
ツールの寿命はコードの品質ではなく、
直せる人が現場にいる期間で決まる。
引き継げるツールの条件は、たった4つに絞れる
私たちが500本超のツールを作り、他社製ツールの保守も引き受けてきた経験から言うと、引き継げるかどうかは4つの条件でほぼ決まります。コードの美しさも、設計思想の新しさも、この4つには入っていません。実際、読みにくいコードでも引き継げた例と、綺麗なコードなのに引き継げなかった例の両方があります。
1つ目、入力と出力が言葉で説明されていること。何を渡すと何が返るか。2つ目、異常時の振る舞いが決まっていること。想定外のデータが来たら止まるのか、無視して先に進むのか。3つ目、環境依存の箇所が1か所にまとまっていること。パスやバージョン番号がコードのあちこちに散らばっていないことです。
4つ目が最も抜けがちで、正しく動いたことを確認する手順があることです。テスト用の入力データと、そのときの正解出力が一緒に保管されているか。これがないと、後任者は直したあとに「直った」と言い切れません。言い切れない人は、怖くて触りません。触られないツールは、そのまま死にます。
逆に言えば、この4つさえ揃っていれば、多少読みにくいコードでも引き継ぎは成立します。私たちが他社製ツールの保守を引き受けるかどうかを判断するときも、見ているのは基本的にここです。4つ揃っていれば即答できますし、2つ以下なら、まず条件を揃える作業から見積もることになります。
Option Explicit
' ===== 環境依存の設定はこのブロックだけに書く =====
' 後任者は、環境が変わったらここ以外を読まなくてよい
Private Const 出力フォルダ As String = "\\server01\cad\out\"
Private Const 対象CADバージョン As String = "R2024"
Private Const 属性テンプレート As String = "図面属性_v3.xlsx"
' 呼び出し側にはパスもバージョンも直書きしない
Public Function 出力パスを作る(ByVal 図番 As String) As String
出力パスを作る = 出力フォルダ & 図番 & ".csv"
End Function
' 前提が崩れていたら処理に入らず止める(社内で言う「関所」)
Public Sub 出図データを整形する(ByVal 図番 As String)
If Dir(出力フォルダ, vbDirectory) = "" Then
MsgBox "出力フォルダが見つかりません: " & 出力フォルダ, vbCritical
Exit Sub ' 中途半端に進めない
End If
' ここから先は前提が揃っている状態だけが通る
Call 属性を書き出す(出力パスを作る(図番))
End Subパスとバージョンを冒頭の3定数に閉じ込めておくと、数年後の後任者は「どこを直せばいいか」をコードを読まずに判断できます。
ドキュメントは書くのではなく、実行できる形で残す
引き継ぎ資料を書いてください、と依頼すると、たいてい立派な仕様書が出てきます。そして誰も読みません。理由は単純で、書いた瞬間から実物とずれていくからです。半年後には3割がずれ、2年後には信用できない文書になります。ずれた資料は、ない場合より有害です。後任者を間違った方向へ誘導するからです。
私たちは仕様書の代わりに、実行できる形の説明を残すことを勧めています。具体的には、テスト用の入力データ一式、それを流すための手順を書いた1枚のメモ、期待される出力ファイル。この3点セットです。後任者はこれを実際に流すことで、文書を読むより速く、5分で挙動を理解できます。
さらに私たちのツールでは、実行前にデータの前提条件を検査して、満たさなければ処理に入らず止まる仕組みを標準で入れています。社内で関所と呼んでいる考え方です。この検査ルール自体が、そのツールが何を前提にしているかを宣言した、絶対に古びないドキュメントになります。動くものと文書が一体だからです。
ドキュメントが古びる問題は、ドキュメントを頑張って更新することでは解決しません。更新する人がいなくなった時点で終わるからです。動くものと一体化させることでしか解決しない。これは私たちが多くの引き継ぎ案件で失敗しながら学んだことで、いまでは納品物の設計方針そのものになっています。
属人化は人の問題ではなく、構造の問題である
属人化の話をすると、しばしば「あの人がブラックボックスにしている」という個人批判に流れます。これはほぼ全ての場合で不当です。現場でツールを作った人は、依頼されていない仕事を自発的にやって、部署を助けています。本来なら評価されるべき行為であって、責められる筋合いはまったくありません。
問題は、作った人に保守と引き継ぎまで無償で背負わせている構造の側にあります。作る工数は成果として見えるのに、引き継げる形に整える工数は誰も見積もっていない。評価もされない。だから誰も時間をかけません。合理的な行動の結果として属人化が生まれている、というのが実態です。
対策としては、ツール1本あたり作成工数の2割を引き継ぎ準備に確保すると最初から決めてしまうのが現実的です。40時間で作るなら8時間。テストデータの整備と、環境依存箇所の集約と、1枚のメモ。この8時間を確保するかどうかで、3年後の被害額が変わります。私たちは見積もりに必ずこの時間を含めます。
私たちは愛知県の大手自動車メーカー及びグループ各社と直接契約で仕事をしていますが、いただく依頼の3割ほどは新規開発ではなく、既存ツールの引き継ぎと保守です。手遅れになってからでも打つ手はありますが、動いているうちに相談いただければ、選べる手はずっと多くなります。
ここまで読んで「うちでもやってみたい」と思われたなら、まずは私たちの無料セミナーをのぞいてみてください。改善を金額で語る考え方を、実例を使って一緒に組み立てます。相談だけでも歓迎です。
記事一覧をすべて見る →