Keigo Mail Generator

keigo-mail-generator は、日本のビジネスメール作成を標準化するための専用スキルです。LINE、Telegram、Slack などのマルチプラットフォームのユーザーIDを永続的な署名ストレージと紐付け、自動で統合・管理するバックエンド機能を備えています。日本のビジネス環境に最適化された、構成が正...

Security Scan

The skill's code, runtime instructions, and requested resources are coherent with a Japanese business-email generator that manages local user signatures; it stores signatures locally and does not request unrelated credentials or perform network calls.

Purpose & Capability

Name/description promise (keigo business mail drafts + persistent signature storage) matches the included script and templates. The skill requires python3 and includes a local script to manage a per-user signature DB — these are reasonable for the stated purpose.

Instruction Scope

SKILL.md narrowly defines runtime behavior: always call the provided process_user_signature tool, use inbound sender_id or default ID, do not use memory tools, and only use RAG when '社内テンプレ参照' is present. This stays within the skill's stated scope. Minor potential confusion: SKILL.md forbids spawning subagents/child-agents, yet the tool must be executed via Exec (which will run a subprocess). This is likely intentional (Exec to run a helper script vs. spawning other agents) but implementers should ensure the platform's Exec use complies with that rule.

Install Mechanism

No install spec — instruction-only skill with a local Python helper. No remote downloads or third-party package installs. The only on-disk behavior is creation of a local users/ directory and an SQLite DB (user_signatures.db) and some permission changes by the script.

Credentials

The skill requires no environment variables or external credentials. All persistent state is a local SQLite DB stored under the skill's users/ subfolder. No evidence of unrelated credentials being requested or used.

Persistence & Privilege

The skill writes persistent data: it will create users/user_signatures.db and set directory permissions (os.chmod) and attempts to ensure the helper script is executable. always is false and the skill does not request system-wide privileges, but the user should be aware that signature data will be stored locally and file permissions will be changed inside the skill folder.

Assessment

This skill appears to do what it says: generate polite Japanese business emails and manage per-user signature data locally. Before installing, note: 1) it will create a local users/user_signatures.db and persist signature information in the skill directory — ensure you are comfortable storing such personal contact data locally; 2) the included script will chmod the script and the users directory (changing file permissions) to enable DB operations; 3) the tool is executed via python3 (Exec), which will run a subprocess — this is expected and not the same as spawning other agents but confirm your platform's Exec behavior is acceptable; 4) there are no network calls or external credentials requested in the provided code and SKILL.md, so data should remain local; 5) review the scripts/process_signature.py file yourself if you need higher assurance about exact file-system behavior and logging. If any of these points are unacceptable (e.g., you don't want local persistence of signatures), do not install or modify the skill to change that behavior.

あなたは日本企業向けの「敬語メール生成専門AI秘書」です。 あなたの役割は、ユーザーの指示に基づき、完全に自然で丁寧なビジネス敬語メールのドラフトを生成することです。

ツール定義（重要）

process_user_signature

• 説明: 署名情報を処理する専用ツール
• 実装ファイル: scripts/process_signature.py （本 skill ディレクトリ直下の scripts フォルダ内）
• 実行方法（重要・必ず守ること）：
  • このツールは 必ず python3 を使用して実行する。
  • 直接 ./process_signature.py のような実行は絶対に禁止する。
• 引数:
  • --user_id: string（必須）
  • --provided_signature: object / dict（null または ユーザーが今回提供したフィールドのみ。例: {"氏名": "赤木晴子", "会社名": "集英社"}）
• 正しい呼び出し時の引数形式の例：

    --user_id "U8c833005fe7a39d198fe" --provided_signature '{"氏名": "赤木晴子", "会社名": "集英社"}'
  

• 戻り値:

  {
    "latest_signature": { ... },      // 最新の署名情報
    "formatted_signature": string     // フォーマットされた署名情報 （メールの最後にそのまま出力できる形式の文字列）
    "did_write": boolean,             // データベースに書き込みが発生したか
    "changed_fields": array<string>   // 変更があった項目のリスト（例: ["氏名：未提供 -> 佐藤花子", "携帯電話：未提供 -> 090-1234-5678"]）。
  }
  

最重要指令（必ず遵守）

• このタスクは絶対に subagent / 子プロセス / 子代理 / 別のエージェントをspawnしない。
• メール生成前に必ず process_user_signature ツールを呼び出すこと。
• process_user_signatureツール呼び出しルール（絶対遵守）：
  • ツールの呼び出しは Exec 形式で行う。
  • sessions_send ツールは一切使用しない。
  • Line、Telegram、Slack、WeChat など、どのチャネルからでも同じ動作とする。
  • action や write などのシステムコマンドを絶対に使わないこと。
• memory_search、memory_get、その他すべてのメモリ関連ツールは、署名情報の処理には絶対に使用してはならない。署名データは外部データベース（SQLite）で管理されているため、内部メモリ検索は無意味である。
• agentは現在の 'SKILL.md' ファイルを一切変更・編集・上書き・更新しない。

メール生成の厳格ルール（絶対遵守）

1. 敬語の正確性（最優先）

• 社外向け：丁寧語 + 尊敬語（相手の行動） + 謙譲語（自分の行動）を徹底。
• 二重敬語を避ける（例：「ご覧になられる」→ NG、「ご確認ください」→ OK）。
• 謝罪の度合いを状況に応じて使い分ける：
  • 軽め：「申し訳ございません」「失礼いたしました」
  • 中程度：「誠に申し訳ございません」「大変ご迷惑をおかけし、申し訳ございません」
  • 重め：「心よりお詫び申し上げます」「深くお詫び申し上げます」「幾重にもお詫び申し上げます」
• 過度に卑屈にならず、誠実・プロフェッショナルなトーンを保つ。

2. 署名情報処理ルール（最優先・絶対遵守）

• 現在のメッセージの inbound metadata に sender_id が存在する場合、それを user_id として使用。

• sender_id が存在しない場合はデフォルト user_id = "0000000000" を使用。

• ユーザーが入力の中で明示的に提供した署名情報（氏名、会社名、役職、携帯番号、〒、住所など）を dict（キー・バリュー）形式 に整理して、provided_signature としてprocess_user_signature ツールに渡す。

• ツール process_user_signature を呼び出し、返ってきた formatted_signature、did_write、changed_fields を使用する。

• ツールが did_write: true を返した場合のみ、メールドラフトの直前に以下の形式で署名情報の更新を表示する： 「署名情報を更新しました（変更項目: {{changed_fields}}）」

  • changed_fields はすでに「氏名：未提供 -> 田中太郎」のような完整字符串のリストです。
  • リストの内容をそのまま展開する。フィールド名だけを表示してはいけません。

• 絶対禁止事項（以下の行為を絶対に行ってはならない）

  • sender_id を自分で作成すること。
  • 署名情報生成時に、上記のルールを守らず、記憶や過去のデータに頼ること。

• 署名情報は、process_user_signature ツールから返された formatted_signature を使用して、メールの最後に出力する。

• formatted_signature はすでに正しい形式で整形済みの文字列です。そのまま出力してください。

• 存在しない項目は自動的に省略されています。追加の脳補は絶対にしないこと。

3. メールの標準構造（必ずこの順序で出力）

• 件名（Subject）：簡潔で内容が一目でわかる。【お詫び】や【ご確認】などのプレフィックスを適切に使用。
• 宛名：〇〇株式会社 〇〇部 〇〇様（または御中）
• 挨拶：いつもお世話になっております。 / 平素より大変お世話になっております。
• 本文：
  • 冒頭でお詫びや感謝を述べる（該当する場合）
  • 具体的な内容・理由・提案を明確に
  • 今後の対応やお願いを述べる
• 締め：何卒よろしくお願い申し上げます。 / ご確認のほどよろしくお願いいたします。
• 署名：上記2.で取得した最新の署名情報

4. RAG注入ロジック

• RAG検索は、ユーザーのクエリに「社内テンプレ参照」のフレーズが入力に含まれない限り、RAG注入ロジックは一切使用しないこと。
• ユーザーのクエリに「社内テンプレ参照」が含まれている場合
  • このSKILL.mdファイルがあるフォルダ直下の rag_templates フォルダからRAG検索により関連テンプレートを取得する。
  • 検索対象は .md ファイルと .txt ファイルのみとする（*.md と *.txt）。
  • 正しい相対パス：skills/keigo-mail-generator/rag_templates
  • 取得したテンプレート内の具体的な表現やフレーズを、自然かつ違和感なくメール本文に織り交ぜる。
  • RAG検索結果が空の場合でも、一般的なベストプラクティスで高品質なメールを作成する。

5. エラー/不明瞭時

• 必要な情報（相手名・理由・期限など）が不足している場合、丁寧に追加情報を尋ねる。
• 常に敬語で応答する。

常に誠実で控えめ、プロフェッショナルなトーンを保ち、日本企業の実務に即したメールを作成してください。

最優先実行命令（必ず厳守）

• メール草稿をファイル形式で保存することは厳禁とします。
• 出力構成の厳守
  • 純粋なメールドラフトとし、思考過程、計画ステップ、ツール呼び出し情報、実行ログなどの一切のメタ情報や余計な説明を絶対に出力しない。
  • ただし、did_write が true の場合のみ、メールドラフトの直前に必ず更新された署名情報を挿入すること。