開発実績一覧

開発・AI運用

共通の開発手順を改訂し、案件別に適用を点検

共通手順の変更範囲を決め、承認した版と各案件への配布結果を照合します。

業務を描いたイメージ

なぜ、この仕組みをつくったのか

一度うまくいった手順を全案件に配ると、前提の違う現場に作業だけが増えることがあります。改訂候補、承認した版、各案件で使った版を区別して残します。

開発担当者が、手順の正本と各利用先のコピーを確認します。更新の対象と理由を記録すると、別の案件で同じ手順を使う担当者にも変更の範囲を説明できます。

仕事の流れを、どう変えるか

従来の作業 改善手順を全員へ配り、どの案件が何を使ったか後から調べる。

設計後の流れ 候補と承認版を照合し、利用先ごとに変更と確認方法を残す。

共通化した手順を一案件で確かめる 共通文書が更新されても、案件の入口が古い手順を指したままなら日々の仕事は変わりません。改訂対象を決めた後、実際に担当者が開く入口から読み直します。

例外のある案件は適用済みと数える前に、どの部分を従来どおり扱うかを明記します。

入力から出力まで、四つの工程

  1. 案件の記録を読む
  2. 適用範囲を決める
  3. 技術責任者が版を承認する
  4. 対象案件で結果を照合する
正本を特定する → 更新対象を決める → 配布結果を照合
掲載例:共通の開発手順を更新して配布結果を確かめる。 正本を特定する → 更新対象を決める → 配布結果を照合

共通手順の改訂案、承認済みの基準版、配布中の版を読み取り、変更内容と承認状態の食い違いを検出します。

担当者が得られる便利さ

似た障害が別の案件で起きても、設定、依存関係、使用中の版が違えば同じ対処は使えません。現場の手間を増やさずに共通化するには、手順を増やす理由と使わない条件も記録しておきます。

開発で工夫したこと

手順の内容から計算した識別値を記録して、意図したファイルが変わったかを照合します。更新前の控えをまとめ、適用後に再度棚卸しします。手順の選択や変更内容の採用には担当者の判断が残ります。

ファイルの識別値と承認記録を照らし、基準版の変更や時期の合わない承認記録を検出して確認に戻します。

AIに任せること、人が確かめること

AIに渡す指示文の変更は、それ自体が動作の変更です。指示が置かれているかだけで採用を決めず、通常の依頼から必要な手順が呼ばれたか、確認を省略していないかを利用先で確かめます。

担当者が引き継ぐなら

各部署でよく使う依頼文を一つずつ用意し、更新後にどの手順が選ばれたかを記録します。意図しない選択があれば該当する版と依頼文を保守担当者に引き継げることを受入条件にします。

変更の影響を受ける利用先を改訂理由に結び付け、採用担当が試験結果と変更範囲を一緒に確認できるようにします。

現在地と、残る確認事項

共通の開発手順を更新して配布結果を確かめる 過去の一括更新では既存手順13件の置換と8件の追加を記録し、更新後に当時の174件を形式検証しました。CLIで一覧への反映を確認しました。デスクトップ環境で各手順が自然な指示から選ばれるかは全件確認できていません。

開発手順の改訂候補を承認済みの版と照合する 今回、合成環境で5件の自動試験が成功しました。読み取りだけの正常確認、基準版・候補の不一致、早すぎる承認、対象候補の列挙を含みます。これによる改訂案の新規配布は行っていません。

業務ソフトの変更に合わせて必要な検証を選ぶ 日報システムへの適用では、一回の検証に519試験と画面確認を含めて変更を受入可能と判定した記録があります。録音素材など製品全体の条件は別に残りました。

レビュー依頼と確認対象が同じ版かを受渡し前に点検する 「確認してください」と依頼した後に添付の版が入れ替わると、承認した内容を再現できません。担当者が読む説明と、実際に確認してほしいファイルの組み合わせを記録し、古い確認依頼のまま承認に進むのを防ぎます。見本による検査で、適合する9例、所定の理由で差し戻す26例、古い説明のまま確定し直す操作を拒む1例が期待どおりでした。文章や画像そのものの採否は受取人が判断します。

確認対象を指定 → 版を突き合わせる → 依頼を引き渡す
確認対象を指定 → 版を突き合わせる → 依頼を引き渡す

自社で応用するなら

まず、技術責任者と各案件の保守担当者が同じ事例を一つ選びます。用意するものは共通手順、適用先、変更理由、以前の確認結果です。試行を終えたら、担当者同士で「配布した版を特定し、前の状態に戻す判断ができるか」を確認してください。

共通手順を改訂した日は、代表案件で使う入口を実際に開きます。配布先にファイルがあることと、日々の作業でその版が読まれることは別に確認できます。

用意する資料
共通手順、適用先、変更理由、以前の確認結果
確認する人
技術責任者と各案件の保守担当者
試行後に確かめること
配布した版を特定し、前の状態に戻す判断ができるか

関連する仕組みを探す

関連実績「開発環境のバックアップと復元範囲を点検」もあわせてご覧ください。業務システム図鑑からも探せます。相談時には「一つの案件で見つけた改善を、どこまで横展開するか」について、手元の一例と、今は誰が判断しているかをお聞かせください。

相談する