※本記事はアフィリエイト広告を含みます。

前の担当者のPCでは動くのに、自分のPCでは起動しない。ソースコードは受け取ったものの、どの設定が正しいか分からない。工場の集計・照合ツールを引き継ぐときは、操作説明に加えて、受け手が同じ版を動かし、あらかじめ決めた期待結果と照合できる材料をそろえます。

この記事では、すでに使っている小規模な業務ツールの担当交代を扱います。AIが作ったコードにも、手書きのスクリプトにも共通する引継ぎの手順です。新規開発の依頼仕様は測定CSVツールの外注と検収で整理しています。

完成させるのは、ファイルの一覧だけではありません。「どの版を、どの環境で、誰が確認し、何が未解決か」が分かる引継ぎ記録です。以下のツール名・版・データ・記録は説明用の仮定例で、実際の企業の移管実績ではありません。

1.引き継ぐツールと、触れてよい範囲を決める

まず、そのツールをどの業務に使っているかを一文で書きます。例えば「部品一覧から、図番ごとの件数を確認用に出すツール」です。次に、入力元、結果の利用先、実行する人と時刻、停止したときの代替手順を記録します。

同じフォルダに試作品や旧版がある場合は、現在使っている版を特定します。ファイルの更新日時だけで決めず、元担当者が実際に使っている起動手順と、その手順が参照するファイルを照合してください。版を特定できない場合は、更新日時の新しいものを推測で選ばず、元担当者へ確認します。

確認項目 仮定例 決まらない場合に相談する相手
業務と利用範囲 部品一覧の確認用集計。製品の合否判定には使わない 業務責任者
対象版 parts-count 1.2、配布フォルダ名とソースの版を対応づける 元担当者・開発担当
入力と出力 許可された一覧のコピーを読み、検証フォルダへ保存 データ管理担当
実行のきっかけ 担当者による手動実行 運用担当
引継ぎ対象外 生産DBの更新、設備への指令、定期実行の切替 IT・設備の管理担当
使えない間の対応 既存の手作業による確認へ戻す 現場の業務責任者

検証中に本番ファイルを上書きしたり、通知を送ったりしないよう、出力先・接続先・自動実行の有無を先に確かめます。外部接続を含むツールなら、許可された検証環境とデータで進めます。

2.「プログラム・環境・設定・確認例」を一組にする

ソースコードがあっても、必要なソフトや設定が欠けていれば動きません。次の表を使い、手元にそろっているものは保存先と版を、欠けているものは確認担当を記入します。

渡すもの 記録する内容 受け手が確認すること
プログラム ソース、配布物、版、変更履歴、必要なビルド手順 稼働中の版と対応しているか
実行環境 OS、CPUの種類、言語・ソフトの版、追加ライブラリ 指定環境を用意できるか
設定 項目名、単位、意味、入力・出力先、設定例 自分の環境で変える項目が分かるか
起動・停止手順 作業フォルダ、コマンドや操作順、終了の確認方法 元担当者の補足なしでたどれるか
確認データ 機密を含まない入力、期待結果、作成根拠 結果を自分で照合できるか
運用情報 ログの場所、失敗時の対応、問い合わせ先、未解決事項 困ったときの判断先があるか
利用・変更の条件 社内管理者、外部部品(ライブラリなど)の利用条件、改修を依頼する窓口 誰が変更・提供を判断するか

パスワードやAPIキーは、一覧表やソースに書き込まないようにします。「どの秘密情報が必要で、誰へ利用権限を申請するか」を記し、受け渡しは社内の管理方法に従います。前任者の個人アカウントをそのまま使い続ける前提にもせず、管理担当者と切替方法を確認します。

Pythonの仮想環境は、フォルダを渡すだけで済ませない

Pythonを使う場合、.venvをそのまま別PCへコピーすれば同じように動く、とは限りません。Python 3.14のvenv公式資料は、仮想環境を移動・コピーして使うものとして扱わず、移動先で作り直す考え方を説明しています。

Python本体の版、必要なパッケージ、作成・起動手順を残します。pipの再現可能なインストールの説明では、パッケージの版を固定する方法や、配布ファイルのハッシュを確認する方法が示されています。ただし、パッケージ一覧だけでOS、外部ソフト、設定、接続先までそろうわけではありません。

この節は、Pythonを使う場合の確認観点です。Excelや専用ソフトにはそれぞれの版・アドイン・利用条件があります。使っているツールに合わせて表を埋め、環境の変更や追加導入は管理担当者へ確認してください。

3.受け手が、検証用の場所で一度たどる

説明を聞く場と、受け手が自分で手順をたどる確認は分けます。元担当者が操作を代行せず、手順のどこで質問が出たかを記録する役に回ると、資料の不足を見つけやすくなります。

受け手が確認する引継ぎの流れ

  1. 対象の版と、渡す資料をそろえる
  2. 許可された検証用環境を用意する
  3. 受け手が手順に沿って実行する
  4. あらかじめ決めた期待結果と照合する
  5. 確認済みの範囲と、保留項目を記録する

途中で止まったら、元担当者の口頭補足を手順へ反映して、その箇所から再確認します。

手元PCや社内の検証基盤で条件を満たせるなら、新しいサーバーの契約は必須ではありません。どこで検証するかは技術検証環境の選び方を参考にしてください。バックアップからの復旧を確認したい場合は、引継ぎとは別に復元試験の条件も決めます。

実施前に、検証用の出力先へ書き込めること、本番のデータを更新しないことを確かめます。そのうえで、受け手が環境の準備、設定、起動、入力、結果確認、終了まで進めます。画面が開いただけで終えず、業務で必要な代表的な処理を確認します。

4.結果だけでなく「確認できなかったこと」を残す

部品一覧の集計ツールを例に、次の架空入力を用意します。ここでは、図番が同じ行を数え、空欄の図番はエラーとして集計結果を確定しない仕様とします。

record_id,drawing_no
P01,D-100
P02,D-100
P03,D-200

期待結果は、D-100が2件、D-200が1件、合計3件です。これは入力を数えて定めた確認例で、ツールが出した結果から逆算した正解ではありません。既存ツールの仕様が別なら、業務担当者がその仕様に合う入力と期待結果を作ります。

確認項目 期待する状態・記録 合わない場合
指定版の起動 指定した版と環境で起動できる 版・環境・起動手順のどこが違うか記録
上の3行の集計 D-100=2、D-200=1、合計3 その結果の業務利用を保留し、仕様と実装を確認
図番を空欄にした入力 この例の仕様ではエラーを示し、結果を確定しない 空欄の扱いが仕様・説明と一致するか確認
出力先の変更 検証用出力先に保存され、本番へ書き込まない 実行を止め、設定と参照先を確認
手順どおりに進められない箇所 失敗した手順、表示、条件を記録できる 元担当者の補足を文書化して再確認

この表は引継ぎ時に実施する確認案で、この記事でツールを実行した試験結果ではありません。正常例を一つ通しただけでは、すべての入力や変更に対応できるとは判断できません。使用頻度や停止時の影響を踏まえ、どの処理まで確認するかを業務責任者と決めます。

引継ぎ表の「結果」は、確認済み・不一致・未実行を分けて書きます。権限がなく試せなかった項目は、「問題なし」にまとめず、未実行として残します。

引継ぎ記録の例(記入用の様式。実績ではありません)
対象ツール/版:
実行環境/設定の版:
受け手/確認日:
確認項目ID/入力の版/期待結果の根拠:
実際の結果/ログ・出力の保存先:
判定:確認済み・不一致・未実行
残件/担当者/次の確認日:
この時点で使用を認める範囲/判断した責任者:

5.保守の担当範囲と、引継ぎ完了の条件を合わせる

使い方を理解できても、改修や障害対応まで引き受けられるとは限りません。「日常操作は現場」「設定変更は生産技術」「コードの改修は開発担当」のように、担当範囲を分けて確認します。対象版、利用を認める範囲、保留項目、問い合わせ先を受け手と責任者が確認して、引継ぎの状態を決めます。

状況 次に決めること
手順と代表処理を受け手が確認できた 確認済み範囲、担当開始日、変更時の再確認方法
元担当者の補足があれば動いた 補足を資料へ反映し、受け手が再確認する日
ソース・設定・利用条件の一部が不明 調査担当と、分かるまで利用を保留する範囲
操作はできるが修正を担える人がいない 社内開発担当、元の委託先、外部支援のいずれへ相談するか

前任者との連絡が取れない場合も、不明なコードをすぐ本番で試すのではなく、手元にある配布物、設定、記録、担当窓口から不足を整理します。既存の手作業や別の管理済みツールで業務を続けられるかも合わせて判断します。

外部の支援先を探す場合

社内の開発担当や元の委託先で対応できないときは、外部へ相談する選択肢があります。その際は「ツールを保守してほしい」だけでなく、対象の言語・版、入手できる資料、再現できた範囲、残件、依頼したい作業をまとめます。ソースや社内データを送る前に、提供してよい範囲と窓口を確認してください。

広告として紹介する発注ナビは、ITの発注先選定を支援するサービスです。公式サイトには業務支援ツール開発や情シス・社内IT支援の区分があります。ただし、既存ツールの保守を引き受けられるか、どの資料が必要か、費用や対応範囲がどうなるかは、相談先との個別確認が必要です。紹介を受けること自体が、ツールの品質や引継ぎ完了を保証するものではありません。

広告:発注ナビの公式案内

まずは、対象版・起動手順・確認用入力・期待結果を一組にして、次の担当者が確認できるか試してみてください。つまずいた箇所を残すことが、次に補う資料や頼む作業を決める材料になります。

個別の進め方に迷う場合は、XのS1N_seigitechへ困りごとの概要をDMでお知らせください。機密資料や個人情報は送らず、DMが使えない場合はお問い合わせページをご利用ください。

一次資料・広告条件の確認日:2026年10月31日。本稿は引継ぎ手順と記録の設計例です。実企業のツール移管、外部業者への発注、Python環境の再構築実演は行っていません。