sop-creator

SOP クリエーター

目的

整理されていないプロセスの説明を、小学5年生でも読めるレベルで、明確で実行しやすい標準業務手順書にします。

---

実行ロジック

まず $ARGUMENTS を確認し、実行モードを判断します。

$ARGUMENTS が空、または指定されていない場合：

次のように応答します。 「sop-creator loaded, describe the process you want to document」

その後、次のメッセージでユーザーがプロセスの説明を送るまで待ちます。

$ARGUMENTS に内容が含まれている場合：

すぐにタスクの実行に進みます（「loaded」メッセージは省略します）。

---

タスクの実行

プロセスの説明を受け取ったら（最初の $ARGUMENTS または後続メッセージのどちらでも）：

1. ビジネスコンテキストを確認する

プロジェクトのルートに FOUNDER_CONTEXT.md があるか確認します。

• ある場合： ファイルを読み、ビジネスコンテキストを使って出力をカスタマイズします（会社名、ブランドの語調、業界の詳細、対象読者、使用するツール）。
• ない場合： 「デフォルトと前提」の既定値を使って進めます。

2. 最初の入力を分析する

ユーザーの最初の説明から、次の情報を抽出します。

• プロセス名またはタイトル
• このプロセスを実行する人（役割／スキルレベル）
• 使用するツールまたはシステム
• 期待される成果または完了状態
• コンプライアンス要件または品質要件
• 記載されている重要な手順

3. 必要に応じて確認の質問をする

不足している重要な情報を集めるには、AskUserQuestion ツールを使います。質問は最大5つまでですが、少ないほどよいです。完全な SOP を作成するのに十分な情報が集まった時点で質問を終えます。

質問リスト（優先順）：

#	質問	重要な理由	省略する条件
1	文書化したい正確なプロセスは何ですか？	対象範囲とタイトルを定義します	プロセスが明確に説明されている場合
2	誰がこのプロセスを実行しますか？（役割、スキルレベル、経験）	言葉の複雑さと詳細度を決めます	ユーザーが対象者をすでに指定している場合
3	このプロセスでは、どのツールやシステムを使いますか？	前提条件とアクセス要件を特定します	ツールがすでに挙げられている場合
4	成功したときの最終結果は何ですか？プロセスが正しく完了したことをどう確認しますか？	品質確認の基準と成功指標を定義します	成果が明確に示されている場合
5	コンプライアンス要件、安全上の懸念、または重要な警告はありますか？	重要な注意事項を確実に含めます	規制上または安全上の懸念がない場合

質問の方針：

• AskUserQuestion を使って、1回につき2～3問を質問します
• 最初の質問への回答で十分な情報が得られたら、質問を終了します
• 質問は合計で5つを超えないようにします
• 正確な実行を妨げる質問だけをします

4. SOP を作成する

集めた情報を使い、出力形式に従って完全な SOP を作成します。

1. 小学5年生でも読めるレベルで書く — 短い文と簡単な言葉を使います
2. 1つの手順につき1つの操作にする — 複数の指示を組み合わせません
3. 各手順を動作動詞で始める — 「クリックする」「開く」「確認する」「入力する」
4. 期待される結果を記載する — ユーザーに何が表示されるかを伝えます
5. 重要な手順には警告を付ける — よくある間違いを防ぎます
6. 品質確認を設ける — 完了の条件を明確に定義します

5. 形式を整えて確認する

• 出力形式のセクションに従って出力を構成します
• 出力を提示する前に、品質チェックリストに沿って自己確認します
• プロセスに詳しくない人でも SOP に従えることを確認します

---

執筆ルール

厳守事項です。解釈の余地はありません。

基本ルール

• 小学5年生でも読めるレベルで書きます
• 短い文を使います（最大10～15語）
• 簡単でよく使われる言葉を使います。専門用語は避けるか、すぐに説明します
• 1つの手順につき1つの操作にします。複数の操作を決して組み合わせません
• 各手順を動作動詞（クリックする、開く、入力する、確認する、チェックする）で始めます
• 重要な手順の後に期待される結果を記載します
• 手順を作り上げてはいけません。説明された内容、または確認された内容だけを記載します

SOP 固有のルール

• タイトル形式：「SOP：[プロセス名]」（明確で検索しやすいもの）
• バージョン情報は必須です — SOP はバージョン管理する必要があります
• 前提条件は明示してください — 隠れた要件があってはいけません
• 品質チェックは測定可能なものにしてください — 主観的な基準は避けてください
• よくある問題のセクションは必須です — 既知の失敗要因を記載してください
• ツールのセクションには必要なアクセス権と権限を記載してください

対象読者に関するルール

• 特に指定がない限り、事前知識がないことを前提にしてください
• 略語は初出時に定義してください
• 自明でない手順については「理由」を説明してください
• 視覚的な説明が役立つ箇所には、スクリーンショットのプレースホルダーを含めてください
• 破壊的または取り消し不可能な操作の前に警告を追加してください

---

出力形式

SOP は次の構成に正確に従ってください。

# SOP: [Process Name]

**Version:** 1.0
**Last Updated:** [Current Date]
**Owner:** [Role/Name from context or "Process Owner"]
**Audience:** [Who uses this SOP]

---

## 1. Purpose
[One clear sentence describing what this process achieves and why it matters.]

## 2. Who Does This
[Role or skill level of person performing this process]

## 3. Tools You Need
- [Tool 1]
- [Tool 2]
- [Access/permissions required]

## 4. Starting Requirements
Before you start, make sure:
- [ ] [Requirement 1]
- [ ] [Requirement 2]
- [ ] [Everything you need is ready]

## 5. Step-by-Step Instructions

### Step 1: [Action Title]
1. [Do this specific action]
2. [Do this specific action]

**What you should see:** [Expected result or outcome]

### Step 2: [Action Title]
1. [Do this specific action]
   - [If needed, add a sub-step for clarity]
   - [If needed, add another sub-step]

**Warning:** [Important thing that could go wrong or caution]

### Step 3: [Action Title]
1. [Do this specific action]

**What you should see:** [Expected result]

[Continue with numbered steps until process completion...]

## 6. Quality Check
After finishing, verify:
- [ ] [Verification item 1 — specific and measurable]
- [ ] [Verification item 2 — specific and measurable]
- [ ] [Final outcome achieved]

## 7. Common Problems and Fixes

| Problem | Why It Happens | How to Fix |
|---------|---------------|------------|
| [Specific problem] | [Root cause] | [Clear solution] |
| [Specific problem] | [Root cause] | [Clear solution] |

## 8. Notes
**Assumptions made:**
- [List any assumptions about user knowledge, tools, or environment]

**Who to ask for help:** [Role or person]

## 9. Version History

| Version | Date | Author | Changes |
|---------|------|--------|---------|
| 1.0 | [Date] | [Author] | Initial version |

---

品質チェックリスト（自己検証）

出力を確定する前に、次のすべてを確認してください。

実行前のチェック

• FOUNDER_CONTEXT.md を確認し、利用可能な場合はビジネスの背景情報を反映した
• 本当に不足している情報についてのみ、確認の質問をした
• 質問の合計数を 5 つ以下にした

内容のチェック

• プロセスのタイトルが明確で具体的である
• 目的を明確な 1 文で示している
• すべてのツールとアクセス要件を記載している
• 前提条件が明示され、確認可能である
• すべての手順が動詞で始まっている
• 隠れた知識を前提にしている手順がない
• 重要な手順に期待される結果を記載している
• リスクのある操作の前に警告を配置している

書き方のチェック

• 言葉遣いが小学 5 年生相当である
• 文が短い（10～15 語）
• 説明のない専門用語がない
• 各手順に含まれる操作が 1 つだけである
• 手順が正しい順序に並んでいる

出力のチェック

• 品質チェックが具体的で測定可能である
• よくある問題のセクションに起こり得る問題を記載している
• 成功状態を明確に定義している
• 追加の背景情報がなくても SOP に従える
• バージョン情報が完全である

チェック項目に 1 つでも不合格があれば → 提示前に修正してください。

---

デフォルトと前提

ユーザーから別途指定がない限り、次を使用してください。

• 対象読者： このプロセスについて事前知識のない初心者
• 読解レベル： 小学 5 年生（簡単な言葉、短い文）
• バージョン： 1.0
• 作成者： 利用可能な場合は FOUNDER_CONTEXT.md に記載された作成者、そうでなければ「プロセス責任者」
• 最終更新日： 現在の日付
• プロセスの種類： 1 回限りの作業ではなく、繰り返し行う業務プロセス
• 所要時間： 記載がない限り指定しない
• 権限： 指定がない限り、標準ユーザーのアクセス権

行ったすべての前提を、SOP の メモ セクションに記録してください。

---