Skip to content

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 12 Jul 16:16

natural-japanese v1.0.0 — 仕事の日本語を書くスキルへ

「AI臭除去スキル」から、仕事の日本語文書を読みやすくわかりやすく書く・直す決定版スキルへゼロベースで再設計しました。議事録・調査レポート・社内ガイド・リサーチメモ・スライド構成といったビジネス文書から、note・ブログ・エッセイまで。AI臭さの除去は、この大きな工程の一部として組み込まれています。

設計の二軸

  • 検出は機械、判断はAI(従来から継続): 疑いの検出は形態素解析で決定的に行い、直すかどうかはAIが文脈で判断する
  • 事後修正より生成時制約(新): 書いた後にAI臭を消すより、書く前の設計と書くときの制約で発生自体を防ぐ

工程は「設計 → 執筆 → 検査 → 収束」の順に進みます。

主な追加

  • 文体憲法12箇条references/writing-constitution.md): 結論から書く、見出しはメッセージ、説明は地の文、専門用語は「機能→名前」の順、濃淡をつける、同じ鋳型を3回続けない、限界と推定を明示ラベルで開示、など生成時の制約
  • 文書タイプ別の型references/doctypes/): 議事録・調査レポート・社内ガイド・リサーチメモ/ディスカッションペーパー・スライド構成の5型。必須要素・構成の型・品質基準・AIがやりがちな失敗をまとめた
  • 構造レビュー(スケルトン通読): 見出しと段落先頭文だけで論旨・濃淡・So Whatを点検する検査。箇条書き主体の議事録など、文レベルlintが素通りする文書で主役になる
  • スイープ改稿ガード: 既存文書のリライトで、同じ修正を全項目へ一律適用すると処理の均質さ自体が新種のAI臭になる。価値を足せる箇所だけ選んで直す原則を明文化(実文書でのブラインド検証で確認)

検査ツールの拡充と再編(破壊的変更)

機械検査層が「AI臭lint」から「疑いの検出+判断材料の抽出」へ広がったため、単一スクリプトを役割ごとに分割しました。

  • scripts/lint.py — 疑いの検出(--json / --genre / --baseline / --experimental
  • scripts/outline.py — スケルトン抽出(構造レビューへの入力)
  • scripts/terms.py — 専門用語の初出・回数・説明マーカー有無の一覧(用語説明の判断材料)
  • scripts/textcore.py — 共有基盤(形態素解析・文分割・Markdownマスク)

⚠️ 破壊的変更: scripts/ai-smell-lint.py は削除しました(後方互換シムなし)。スクリプトを直接呼んでいた場合は scripts/lint.py に読み替えてください。スキルとして使う分には自動で新パスを参照します。

検出器の校正

  • antithesis_repetition の比率化: 「〜ではなく」型の対比を、出現ごとの一律 critical から「検出数/総文数」の比率で3段階(info / warn / critical)に。コーパス実測(人間 quality:high 81本 vs AI 406本)で人間側の critical 化率を4.9%(FP<5%目標)に抑えつつ、AIの高頻度パターンは検出を維持

その他

  • description をビジネス文書トリガーに対応させ、evals を60ケース(60/60 PASS)に拡張
  • fixtures 回帰チェック 25/33/0/0 維持

Codex コードレビュー GO 取得済み。


変更ログ(自動生成)

Full Changelog: v0.4.0...v1.0.0