shu​ren​hua – 中国語ファーストの「人間らしい言葉で言う」編集スキル

概要

shu​ren​hua は、生成AIチャットアシスタント（Claude、Grok、ChatGPT、Cursorなど）に読み込ませるテキスト編集スキル（プロンプト/ルールセット）です。目的は、中国語の散文をクリーンアップすることです。決まり文句、繰り返しの前置き、硬い表現を除去しつつ、元の事実、条件、約束、著者の声を保持します。英語テキストや、書き換えずに問題をフラグするだけの「レビューのみ」リクエストにも対応します。

誰が使うか

• READMEファイル、リリースノート、イシューコメント、内部同期メッセージを書く開発者。
• 簡潔で専門用語のない中国語版ドキュメントを求めるテクニカルライターやプロダクトマネージャー。
• 中国語の記事を下書きし、意味を失わずに自動で「人間らしい」磨きをかけたい人。

仕組み（リポジトリから）

1. スキル定義 – コア編集ロジックは3つのMarkdownファイルにあります：
   • SKILL.md – AIが読み込むエントリーポイント。
   • references/editing‑guide.md – 詳細な境界（変更可能なもの、保持すべきもの）。
   • references/examples.md – 並列の前後例。
2. インストール – runtime-files.jsonにリストされている3つのファイルを、AIアシスタントがスキルをスキャンするディレクトリにコピーします。3つの配布フレーバーが提供されます：
   • mini – 単一の自己完結型Markdown（dist/shuorenhua‑mini.md）で、一回限りのプロンプト用。
   • lite – SKILL.mdのみ（必要に応じて参照ファイルにフォールバック）。
   • full – 最も完全な動作のための3つのファイルすべて。 いくつかの人気ツール（Codex、Claude Code、Cursor/Windsurf、OpenClaw、ChatGPT）のインストール手順が提供されています。
3. 実行 – 元のテキストを短い指示とともにAIに渡します。例：

   把这段去掉套话，保留信息和我的口气：……
   

   モデルはルールに従ってパッセージを書き換え、クリーンアップされたバージョン（または「レビューのみ」を要求した場合は問題のリストのみ）を返します。
4. 制御の粒度 – スキルは3つのスコープを認識します：
   • structural – 自由編集。文の結合や並べ替えが可能。
   • bounded – 文内のクリーンアップのみ。文全体の削除は許可されますが、結合は不可。
   • in‑place – 文の削除や結合は行わず、単語レベルの調整のみ。 ユーザーはリクエスト内のキーワードでスコープを選択します。
5. 安全チェック – ルールは明示的に保持します：
   • 数字、条件、約束、帰属。
   • コードブロック（コメントを含む）は、ユーザーが明示的に編集を要求しない限り変更されません。
   • 引用、UI文字列、タイトル。
   • 出典のない記述（「研究表明」）は、ユーザーが削除を要求しない限り保持されます。

評価と品質

• ベンチマーク：123のテストケース（65の「改善対象」テキスト、58の通常テキスト）に加え、20のシナリオサンプルと10の長文人間記事。
• モデルカバレッジ：Claude Opus 5は136のターゲットケースをパス。Grok 4.6は56をパス。
• メトリクス：ハード障害ゼロ（情報損失やタスク漏れ）、通常テキストの誤編集率<10%、ポジティブサンプル編集の少なくとも5/7で明確な利点。
• 詳細結果はevals/results‑v2.5.0.mdと基準ファイルevals/v2.5/criteria.mdにあります。

適さない場合

• 本格的なAIライティング検出器や「AIフリー」テキストを保証するツールが必要な場合、このスキルは提供しません。
• 主に中国語向けです。英語はサポートされていますが、ルールセットは中国語の表現に調整されています。
• コードロジックは書き換えません。コードフェンス内のドキュメントスタイルのテキストのみです。

ライセンスとコミュニティ

• MITライセンスでオープンソース。
• Bad-Caseテンプレートによる貢献を歓迎します。イシューには元のテキスト、リクエスト、モデルの出力を含めてください。
• リポジトリはスター成長を追跡し、チェンジログを提供します。最新の安定版はv2.5.1（メンテナンスリリース）です。

---

上記のすべての情報はリポジトリのREADMEから直接取得しています。外部の仮定は追加されていません。