polysh手順書 / 実践ガイド
ワークフローが変わったら SOP を更新する。
手順書は、操作項目、前提条件、最終確認が最新であってこそ役に立ちます。元の説明を更新してから、両方の出力を見直しましょう。
書き直す前に、何が変わったかを明確にする。
まずは、以前の手順と現在のタスクの違いを把握しましょう。ボタン名が変わっただけなら、少しの言い換えで済むかもしれません。新しい権限や承認ステップの変更があれば、道筋全体が変わることもあります。
対象者も確認します。手順を実行する人に、以前は不要だったアクセス権が必要になっているかもしれません。そうした前提条件は冒頭近くに置き、つまずきを防ぎましょう。
説明を元から更新する。
既存のスクリプトを、現在のソフトウェアと照らし合わせて見直します。録画が正しいタスクを示しているなら、ナレーションを修正しましょう。画面の流れが変わっている場合は、新しい道筋を録画し、動画とガイドで正しい操作項目を示せるようにします。
残したいガイドの手動編集はメモしておきましょう。ガイドを作り直すと、選択した言語の編集内容は置き換えられます。始める前に、更新版に引き継ぐべき内容を決めておきます。
手順だけでなく、結果も確認する。
手順の最後のステップで目に見えるものを示すと、その手順は信頼しやすくなります。週次のステータスページなら、公開ページに表示される今週の日付と承認済みの更新内容がそれにあたります。
同僚に、記載された出発点から手順を試してもらいましょう。どこで迷うかを見るほうが、記憶を頼りにもう一度編集するよりも多くのことがわかります。
最新版を意図して公開する。
見直しが済んだら、新しいナレーションを生成して動画を書き出します。更新した書き出し用に、新しい動画の共有リンクを作成しましょう。ガイドのリンクを再利用する前には、現在のガイドを確認します。
どのバージョンを使うべきかをチームに伝え、必要に応じて古いリンクを廃止しましょう。わかりやすい手順書には、今日の正確なステップだけでなく、次の更新を担う明確な担当者も必要です。