Korean Slang Writing

このスキルが行うこと

ユーザーが「流行語を混ぜて」「最近の言い方で」「ミーム的に」「ウィットに富んだ」といったリクエストをした場合、検証済みの韓国流行語候補をまず抽出し、必要に応じてナムウィキ原文の要約を確認して、韓国語の文章・プロモーション文・SNS投稿・コメントを流行語のニュアンスで作成する。

• スキルはデータと検索ツールのみを提供する：キュレーション済みシードインデックス検索 + ナムウィキ best-effort 要約。
• 実際の文章作成はエージェント(LLM) がスキルが返した候補の中からユーザー意図に合った表現を選ぶ。
• シードインデックスの出典はナムウィキ 分類:流行語を基準として手作業でキュレーションしている。
• リスク水準の差別・ハラスメント・集団嘲笑の可能性がある表現はシードに入れない。

使用する場合

• 「SNS宣伝文を流行語混ぜて書いて」
• 「コメントを最近の言い方に変えて」
• 「ミーム的に / MZ的に / ウィットに富んで書いて」
• 「この流行語はどういう意味？」(シードインデックス + ナムウィキ lookup)
• 「ポジティブな感じの流行語 3つ推薦して」
• 「この商品コピーに合う流行語候補を出して」

使用しない場合

• 正式な公文書、プレスリリース、法律文書、謝罪文、公式発表など流行語の使用が不適切なコンテキスト
• 繊細な社会・政治・宗教トピックに風刺的な流行語を混ぜる必要がある状況
• 大量インデックシング / 全ウェブスクレイピング (ナムウィキ利用規約・Cloudflare ポリシー違反の可能性)
• 不特定多数向けのブランディング文句で流行語の過剰使用 (著者が確認・同意していない場合)

ポリシー第一

• 流行語は自然に少なく使うことをデフォルトとする。過剰使用はむしろダサい。
• 意味と用例を確認できない流行語は使わない。
• safety が spicy の項目は非格式的なコンテキストでのみ使い、格式的な場では避ける。
• still_usable: false 表示がついた旧型流行語は基本検索結果に含まれない(--include-deprecated で意図的に復元可能)。
• ナムウィキは best-effort 出典であり、Cloudflare ブロック・HTML 構造変更時は fetched: false または warning で応答する。この場合推測せず、シードインデックス meaning_short + リンクのみを案内する。

前提条件

• python3 3.10+ (argparse, urllib, unittest のみ使用 — 追加依存関係なし)
• スキルディレクトリの scripts/*.py ヘルパー (インストール時に自動付属)
• ナムウィキ lookup にはインターネット接続が必要だが、失敗してもシードインデックスだけで安全に応答できる。

レスポンス契約

slang_search 結果スキーマ (v1):

{
  "query": "중꺾마",
  "filters_applied": {
    "mood": ["긍정"],
    "context": ["SNS"],
    "safety": ["safe"],
    "intensity": [],
    "limit": 10,
    "include_deprecated": false
  },
  "matched_before_limit": 12,
  "total_candidates": 5,
  "candidates": [
    {
      "term": "중꺾마",
      "aliases": ["중요한 건 꺾이지 않는 마음"],
      "meaning_short": "포기하지 않는 불굴의 의지.",
      "usage_context": ["격려", "스포츠", "SNS"],
      "mood_tags": ["긍정", "의지"],
      "intensity": "medium",
      "safety": "safe",
      "example_usage": ["힘들지만 중꺾마 정신으로 이겨내자!"],
      "namuwiki_url": "https://namu.wiki/w/...",
      "era": "2022",
      "still_usable": true,
      "match_reason": "exact"
    }
  ],
  "source": "...",
  "last_reviewed": "2026-04-22"
}

match_reason 優先度: exact > alias > substring > no-query (フィルタのみ適用の場合)。

slang_lookup 結果スキーマ:

{
  "input": "중꺾마",
  "url": "https://namu.wiki/w/%EC%A4%91%EA%BA%BE%EB%A7%88",
  "fetched": true,
  "title": "중꺾마",
  "summary": "중꺾마는 ...",
  "error": null,
  "block_reason": null,
  "warning": "optional, when HTML parsing failed"
}

fetched: false の場合、block_reason は blocked / not_found / upstream_error のいずれかであり、エージェントは推測せず原文リンクを提示するか、別出典の確認を提案する。

ワークフロー

1. ユーザー意図の整理

• 執筆目的 (宣伝、コメント、自己紹介、タイトルなど)
• 流行語の強度 (少し / 適度に / たくさん)
• トーン/ムード (ポジティブ、ネガティブ、ユーモア、自嘲、感嘆など)
• コンテキスト (SNS、マーケティング、食べ物、スポーツ、職場、学校など)

2. シードインデックスから候補を探索

python3 scripts/slang_search.py --mood "긍정,유머" --context "SNS,마케팅" --safety safe --limit 5 --format json

主要オプション:

オプション	説明	例
--query	キーワードマッチング (term/aliases/substring)	--query 중꺾마
--mood	ムードタグ (OR マッチング)	--mood 긍정,유머
--context	コンテキストタグ (OR マッチング)	--context SNS,마케팅
--safety	安全レベル (safe/spicy/risky)	--safety safe,spicy
--intensity	強度 (subtle/medium/strong)	--intensity medium,strong
--limit	返却数 (1~50)	--limit 5
--include-deprecated	旧型流行語を含める	--include-deprecated
--index-path	外部インデックス JSON パス	--index-path ./my-index.json
--format	json または text	--format text

3. (オプション) ナムウィキ原文要約の確認

python3 scripts/slang_lookup.py "중꺾마" --format json
python3 scripts/slang_lookup.py "https://namu.wiki/w/%EC%A4%91%EA%BA%BE%EB%A7%88" --max-length 800

• 成功時は title, summary を返す。
• 失敗時は fetched: false + block_reason + error を返す。推測しないこと。

4. エージェントが文章を作成

1. 候補の中からコンテキストに合った 1～3 個を選ぶ。多く入れない。
2. safety が spicy の表現は非格式的なコンテキストでのみ使い、使用意図を明確にする。
3. 結果を 1～2 文で自然に組み込む。
4. 必要に応じて「使用した表現: A, B — 意味確認: [url]」を追加して根拠リンクを示す。
5. ユーザーがより大げさな/控え目なバージョンを望む場合は、代替案も一緒に提供する。

CLI の例

# 1) 特定の流行語の意味/メタをすぐ確認
python3 scripts/slang_search.py --query "갓생" --format text

# 2) ポジティブムードの SNS マーケティング候補 5 個
python3 scripts/slang_search.py --mood "긍정,유머" --context "SNS,마케팅" --safety safe --limit 5

# 3) ユーザー指定のカスタムインデックスに切り替え
python3 scripts/slang_search.py --query "중꺾마" --index-path ~/Downloads/my-slang.json

# 4) ナムウィキ原文要約を試す
python3 scripts/slang_lookup.py "럭키비키" --timeout 10 --format text

レスポンスポリシー

• レスポンスには選択した流行語、最終文、根拠リンクの 3 つを含める。
• 流行語を 2 個以上使った場合、それぞれなぜ使ったのか 1 行の理由を付ける。
• ユーザーが明示的に要求していない状況では流行語を混ぜない。
• ナムウィキ要約がない場合は、シードの meaning_short と原文リンクで代替する。「よくわからない」ことを隠さない。

完了条件

• slang_search が JSON で最低 1 個の候補を返すか、意図的に 0 件 (no match) を明確に伝えた。
• 流行語を使用した場合、各表現の意味/根拠リンクが一緒に提示された。
• safety=risky 表現はシードになく、spicy 表現を使った場合は、なぜこのコンテキストで問題ないのか 1 行説明がある。
• ナムウィキ lookup 失敗時、推測の代わりに原文リンクで代替された。

備考

• シードインデックスの位置: data/seed-slang.json (約 30 項目)。拡張は PR でレビュー後に反映される。
• last_reviewed フィールドを意味のある方法で更新しない変更は、受け入れない方が安全である。
• このスキルはナムウィキ 分類:流行語を基準としているが、全インデックシングはしない。Cloudflare ブロック・データ先行変化に保守的に設計された v1 である。
• 次バージョンでは複数の公開ソースを統合するか、last_reviewed ベースの自動有効期限ロジックを入れることができる。