Korean Character Count

What this skill does

글자 수 제한이 중요한 한국어 텍스트(자기소개서、志願書、自由記述形式のフォーム等)を対象に、LLM推定なしに決定論的にカウントする。

• 基本文字数：Intl.Segmenter ベースの Unicode extended grapheme cluster
• 行数：CRLF、LF、CR、U+2028、U+2029 を改行1回として計算
• 基本バイト数：UTF-8実際エンコーディング長
• 互換プロファイル：neis バイト規則

When to use

• "このエッセイが1000字を超えているか正確に数えて"
• "このテキストをUTF-8バイト基準で計算して"
• "行数とバイト数も一緒に教えて"
• "ハングル/英文/絵文字が混在した文を推定ではなくコードで数えて"

Why this skill exists

• 文字数制限は1文字の違いにも敏感である。
• LLMが文字数を目測で予測すると再現性がない。
• このスキルは入力を任意にtrim/正規化しないで、文書化された契約でのみ数える。

Contracts

default profile

• characters: Intl.Segmenter("ko", { granularity: "grapheme" })
• bytes: Buffer.byteLength(text, "utf8")
• lines:
  • 空文字列 => 0
  • 非空文字列 => 改行シーケンス数 + 1
  • CRLF は 2 改行ではなく 1 改行として数える。

neis profile

• characters: default と同じ
• lines: default と同じ
• bytes:
  • ハングル grapheme => 3B
  • ASCII grapheme => 1B
  • Enter/改行シーケンス => 2B
  • その他の文字はUTF-8バイト長にフォールバック

Prerequisites

• node 18+
• インストール済みのスキルペイロード内に scripts/korean_character_count.js ヘルパーを含む
• 別途APIキー不要

Workflow

1. テキストを直接受け取るか、ファイル/STDINから読む。
2. node scripts/korean_character_count.js で決定論的カウントを実行する。
3. 必要なプロファイル(default/neis)と出力形式(json/text)を選ぶ。
4. 結果をそのまま返し、どの契約で数えたかを一緒に伝える。

CLI examples

node scripts/korean_character_count.js --text "가나다"
node scripts/korean_character_count.js --text $'첫 줄\r\n둘째 줄🙂'
node scripts/korean_character_count.js --text $'첫 줄\n둘째 줄🙂' --profile neis --format text
node scripts/korean_character_count.js --file ./essay.txt --profile default
cat essay.txt | node scripts/korean_character_count.js --stdin --profile neis

Response policy

• 推定せず、ヘルパー結果をそのまま使う。
• どのプロファイルで数えたかを一緒に表示する。
• デフォルト値が必要な場合は default プロファイルを使う。
• 提出先がNEIS/学校生活記録簿のような別の契約を要求する場合のみ neis を使う。

Done when

• 文字数、行数、バイト数が一緒に返される。
• default と neis 契約の違いが文書に明示される。
• node scripts/korean_character_count.js --help が動作する。
• 混合ハングル/英文/空白/改行/emoji入力に対するテストがある。

Notes

• Unicode grapheme clusters: https://www.unicode.org/reports/tr29/
• WHATWG Encoding Standard: https://encoding.spec.whatwg.org/
• Node Buffer.byteLength: https://nodejs.org/api/buffer.html