🌸

🌸 言の葉 Kotonoha 開発ポータル

Alpha Draft

AIへ「高級言語に近い形」で指示するための軽量プロンプト言語。絵文字や短ラベルで目的・入力・条件・出力を構造化。

🌸 言の葉 Kotonohaとは（概要）

🧭

Kotonoha は、AI への指示を 短い見出し（絵文字＋ラベル） と 箇条の設定 に分解して書くための軽量言語（DSL）です。

  • 読みやすさ：ひとかたまりを 3〜6 行で要点表現
  • 運用しやすさ：🧾 出力 と 🧩 スキーマ で機械可読に
  • 拡張しやすさ：目的／入力／条件／検証／出力のブロックを自由に構成

📘 基本

基本ブロック

  • 🗒️ 要約 / 📝 生成 / ✍️ 校正 … タスク種別
  • 📎 入力 … テキスト/ファイル/URL
  • 🔍 条件 … 制約やフィルタ
  • 🧾 出力 … 形式（JSON/MD/CSV/HTML）
  • 🧩 スキーマ … 出力の型定義

書式の原則

  • 行頭に 絵文字＋短い見出し
  • 設定値は key: value か - 箇条書き
  • 長文入力は <<<TEXT ... TEXT 形式で囲う

🏗️ 基礎

🗒️ 要約
📎 入力: <<<TEXT
（ここに文章）
TEXT
🔢 箇条書き: 3
🧾 出力
📦 形式: Markdown

→ 要約・入力・出力を 6 行以内で規定。

🧰 応用

ファイル管理（🔍 条件）

🗂️ ファイル管理
📁 対象: /docs
🔍 条件:
  - 拡張子: [".md",".pdf"]
  - タグ: ["仕様","設計"]

評価ループ（🧪 検証）

🧪 検証
🎯 目的: 事実確認と引用挿入
📎 入力: URL一覧
🔍 条件:
  - 出典の信頼度≧B

🚀 発展

複数ブロックの連鎖・分岐・反復、🧾 出力のスキーマバージョニング、🗂️ ファイル管理と外部API連携など。

📰 最新情報

※ /data/kotonoha/news.json を置くと自動で差し替え表示。

🎯 目的

高級言語に近い指示

曖昧な自然文から一歩進め、宣言的に要件を定義します。

絵文字で見やすく

視認性の高いブロック見出しで、レビューと共有を容易にします。

ファイル管理の指示

🗂️ ファイル管理 で参照範囲やフィルタを指定。

🏢 仕事の現場

  • 要件定義：🧾/🧩で成果物を固定→差分管理
  • レビュー：🧪検証ブロックで基準化
  • ナレッジ化：良い指示は「型」として再利用

🧱 言語開発（ドラフト）

# トップレベルは自由順序のブロック集合
🗒️|📝|✍️|🧪|🗂️|🧾|🧩 : ヘッダ行
key: value        # 単一設定
- item            # 複数設定
<<<TEXT ... TEXT  # 長文リテラル

→ 人間可読で、最小限の構文だけを定める方針。

🗺️ そのほかの言語

比較の観点

  • 記述量 / 学習コスト
  • 出力の固定度 / 検証容易性
  • 既存ツールとの親和性（JSON/Markdown）

🧠 知っておくといい

・知識

  • 宣言的 → 「何を」優先、「どうやって」は任意
  • 出力先：JSON/MD/HTML/CSV のいずれかに固定

・技能

  • 短文で分割、各ブロック 6 行以内
  • レビュー観点（網羅性・一貫性・検証性）

・用語（グロッサリ）

  • 🗒️ 要約 — 要約タスクを明示するヘッダ。直後に設定を続ける。
  • 🗂️ ファイル管理 — 入力ファイルの探索・参照・分類の指示。
  • 🧾 出力 — 成果物の形式（JSON/Markdown/HTML/CSVなど）を規定。
  • 🧩 スキーマ — キーや型の宣言で出力の妥当性を担保。
  • 🔍 条件 — フィルタ条件の列挙。拡張子/サイズ/タグなど。
  • 🧪 検証 — 自己チェックや評価ループを実施。

・ルール（最小セット）

  1. 行頭は絵文字＋短見出し
  2. 入出力は必ず明示（📎 / 🧾）
  3. 出力形式を固定（🧩あれば型定義）
  4. 長文は <<<TEXT で囲む

🧪 例

基本：要約指示

💬 目的：以下の文章を3点で要約して

🗒️ 要約
📎 入力: <<<TEXT
ここに長文を貼り付ける
TEXT
🔢 箇条書き: 3

📝 Notes：Kotonohaは「行頭アイコン＋短いラベル」で意図を明確化。

応用：ファイル管理と出力整形

💬 目的：画像一覧をJSONで出力して

🗂️ ファイル管理
📁 対象: /images/gallery
🔍 条件:
  - 拡張子: [".png",".jpg",".webp"]
  - 最小幅: 512
🧾 出力
📦 形式: JSON
🧩 スキーマ:
  - name: string
  - path: string
  - width: number
  - height: number
  - alt: string?

📝 Notes：「🧾 出力」「🧩 スキーマ」で機械可読な成果物を要求。

発展：評価ループ（自己検証）

💬 目的：生成テキストの誤字検出と修正案

🧪 検証
🎯 目的: 誤字と用字揺れの検出
📎 入力: <<<TEXT
てすと文章。表記ゆれ/ユレ をふくむ テキスト
TEXT
📋 ルール:
  - JIS第1/2水準で置換候補を提案
  - 専有名詞は除外
🧾 出力
📦 形式: JSON
🧩 スキーマ:
  - issues: [{offset:number,length:number,found:string,suggest:string[]}]

📝 Notes：🧪 検証ブロックで評価→🧾 出力で構造化。

データ設置方法（JSON スキーマ） 
// /data/kotonoha/news.json
[{"date":"2025-08-20","title":"タイトル","url":"#"}]

// /data/kotonoha/examples.json
[{"title":"例のタイトル","prompt":"説明",
  "kotonoha":"🗒️ ...","notes":"任意"}]

// /data/kotonoha/glossary.json
[{"term":"🧾 出力","desc":"説明"}]

// /data/kotonoha/links.json
[{"label":"ラベル","url":"/path/"}]

🧭 より具体的に（テンプレ集）

要件から実装チケットへ

📝 生成
🎯 目的: 要件→実装チケット化
📎 入力: <<<TEXT
（要件テキスト）
TEXT
🔍 条件:
  - チケット: [title,desc,acceptance,priority,estimate]
🧾 出力
📦 形式: JSON
🧩 スキーマ:
  - tickets: [{title:string,desc:string,acceptance:string[],priority:string,estimate:number}]

表形式データの要約

🗒️ 要約
📎 入力: CSV
🔍 条件:
  - 指標: ["平均","中央値","外れ値数"]
🧾 出力
📦 形式: Markdown