memory-sanitize

memory-sanitize

エージェントの文脈に影響する永続層の日本語文章の品質を、textlint-ja の規則群と独自規則で再現可能に検証する。自動修正はしない、検出のみ。修正はエージェント自身が結果を見て判断する。

検査は二段構えで実施する。第一段は機械検出、第二段は散文品質レビュー。永続層への書き込みは両段を通過してから完了とする。

1. 機械検出: textlint による決定論的な検査。文法・形式・英単語混入など、規則で機械的に判定できる規律違反を検出する。scripts/check.sh がこれを担う。
2. 散文品質レビュー: tech-writing スキルを参照したエージェント主導の検査。論証・段落構成・冗長排除・演出の抑制・LLM っぽい表現の禁止など、機械では判定できない規律違反を検出する。

起動条件

• 「日本語品質チェック」「textlint かけて」「英語混入チェック」「メモリ点検」「memory sanitize」等の指示
• 永続層への新規書き込み後の自己確認

検査対象

スキルは「エージェントの文脈に影響する永続層の日本語散文」を対象とする。以下の機能的性質を満たすファイルが想定対象。

• 日本語の散文、すなわち文として読まれる本文を含む
• エージェントの文脈や応答に影響する。ランタイムが読み込むもの、応答指針として参照されるもの、などを指す
• 永続化されている。一時ファイルでなく、セッションをまたいで残るもの

検査対象に入れないもの:

• 構造化データ (JSON / YAML / lockfile / 設定ファイル等)。規則のデータファイル (data/*.json・$XDG_CONFIG_HOME/memory-sanitize/*.json) もここに含まれる。
• ソースコード (Markdown でない .ts・.js・.py 等)。

具体的な配置・命名・構造は環境ごとに異なるため、スキルは検査対象の経路を一切規定しない。対象はエージェントが起動文脈から判断し、引数で check.sh に渡す。

呼び出し方は以下のとおり。

• ユーザーが対象を指定した場合は字句通り使う
• ユーザーが指定しない場合はエージェントが上記の機能的性質に照らして自分の環境から候補を列挙する
• 判断に迷う場合はユーザーに確認する

対象が決まったら bash <SKILL_DIR>/scripts/check.sh <file...> の形で実行する。

検出項目

textlint の既存規則と独自規則を 1 回の実行で同時に適用する。

textlint-ja の既存規則による技術文書一般品質

• ですます・である調の混在
• 文末句点の混在
• 重複した助詞・接続詞
• 不適切な表現・冗長表現
• 全角半角混在
• 二重否定
• 全角文字どうしの間の半角スペース (ja-no-space-between-full-width。カタカナ複合語は除外される)

scripts/rules/ 配下の独自規則 (判断を要する)

判定は機械的でも、違反を 0 にするには編集判断が要る規則。許可一覧の整備や文の書き換えが伴うため、二値ゲートには向かない。

• no-english-word: 固有名詞 (data/proper-nouns.json)・略語 (data/acronyms.json)・バッククォート内コード以外の連続英字を検出
  • 検出範囲は「日本語と英語が混在した Str ノード」のみ。日本語文字すなわちひらがな・カタカナ・漢字を 1 文字も含まないテキストは「英単語混入」の対象外となる。純英語の見出し・引用・スラッグ単独行・コード片などがこれに当たる。ルール本来の目的、すなわち日本語文中の英単語混入検出だけを評価し、純英語パターンは無関係とする。
• no-paren-equals-gloss: 半角開き括弧 ( の直後に等号 = が続く (= 構文を完全禁止
  • 「X (= Y)」形式の括弧内同格挿入は本文の論述リズムを断ち切る注釈様式として全面的に避ける。同格挿入が必要なら別文に分け、「X とは Y である」と書き起こすか、「X すなわち Y」と読点でつなぐ。
  • 検出対象は半角形のみ。バッククォート内の文字列リテラル、すなわち Code ノードは対象外。
• no-em-dash-ja: 日本語の地の文・見出しでのダッシュ類使用を禁止
  • 検出対象は次の 3 種類。— (U+2014、em ダッシュ)、― (U+2015、横棒)、—— (em ダッシュ 2 連の 2倍ダッシュ)
  • 除外は次のとおり。– (U+2013、en ダッシュ) は範囲表記として許容する。日本語文字を含まない純英語の Str ノードは対象外 (例: Curry–Howard などの英語複合語)。バッククォート内コード・コードブロックは標準動作で自動除外される。
  • tech-writing 規範 18 行目を機械化したもの。同格・補足の挿入は括弧 () に降ろし、言い換えは句点で二文に分けるか読点で対応する。
• no-heading-separator: 見出しに区切り線 ─ (U+2500、罫線) を含めるのを禁止
  • 検出対象は Header ノード内の ─ 単独および ── の連続。
  • 除外は次のとおり。Header ノード以外の本文中での ─ 出現は対象外。バッククォート内コード・コードブロックは標準動作で自動除外される。
  • tech-writing 規範 20 行目を機械化したもの。二要素を罫線で連結した見出し (例: 種別──主題) を遮断する。見出しは単一の自然な句にし、要素を一つに絞るか助詞・読点でつなぐ。