SwipeGuide:効果的な指示を書く
Last updated: June 19, 2026
効果的な手順書を作成するためのミニマリスト・インストラクション原則に従う
ミニマリスト・インストラクションの原則に従う
ユーザーの立場に立つ
ユーザーが実行するタスクに焦点を当てる
アクション指向のアプローチを選択する
エラーの認識と解決をサポートする
業務中の使用、参照、トレーニングを想定して設計する
作成プロセスに適用する
ステップの内容を書く
最も簡潔な指示の形式である「動詞 + 名詞」を使う
ステップのアクションを実行するために必要な場合は、情報を追加する
可能な限り、動詞から始め、現在形を使って能動態で書く
同じ事柄を説明する際には同じ言葉を使い、手順書/ガイド全体で一貫性を保つ
2. ステップの下に追加情報を書く
SwipeGuideのデフォルトのステップノート
警告
ユーザーが頻繁にミスをする、またはミスによる影響が大きいステップには警告を使用する
ヒント
タスクを実行するための最善/最も簡単な方法など、ステップに関する追加情報をユーザーに提供するにはヒントを使用する
ヒントは能動態で簡潔に書く
ハイパーリンクを使用して、別の手順書や外部情報へのアクセスをユーザーに提供する
代替案
ユーザーがステップを完了するための方法が複数ある場合は、代替案を使用します
ステップを書くときと同じように記述し、これが同じタスクを実行する「別の」方法であることを明確にします
修正
ユーザーが問題に直面する可能性のあるステップでは、修正を使用して、特定のステップ内で問題を解決する方法を説明します
まず問題を説明し、その後、ステップを書くときと同じように、行動指向かつ簡潔に解決策を記述します
2. カスタムステップノート
設備
それぞれの手順タスクを実行するために必要な設備を、該当するステップノートに記載します。
場所
ステップコンテンツで言及されている特定の機械またはコンポーネントが、ライン上、作業フロア上、またはどの機械にあるかを記載します。
ツール
それぞれの手順タスクを実行するために必要なツールを、該当するステップノートに記載します。