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