un-editorial-check

UN 編集チェック

編集上の判断を行う前に、同梱の Node.js CLI を実行してください。CLI は抽出したコピーに対して文書化されたルールをチェックしますが、文章が明確、中立、正確であることや、出典が十分であることを証明するものではありません。

この SKILL.md があるディレクトリを基準に <skill-base> を解決してください。以下のパスはすべて、そのディレクトリからの相対パスです。

ワークフロー

1. node <skill-base>/bin/check.mjs <paths> を実行します。ユーザー向けに現状と修正後を比較した同じ指摘内容の PDF を作成するには、--report <path.pdf> を追加します。
2. エラー重大度の指摘（終了コード 1）に対応します。警告を確認し、終了コード 0 を得るためだけに抑制しないでください。
3. rules/ 内の該当ファイルを読みます：スペル、用語、数値、文体、外交、ヘイトスピーチ、文法。記憶に頼って内容を言い換えたり、再解釈したりしないでください。
4. AGENT REVIEW REQUIRED の指摘を確認します。主張が証拠と一致しているか、数値に出典と日付があるか、引用が完全か、比較対象の年が揃っているか、ラベルが集計対象を明示しているかを確認してください。
5. 5 つの区分に従い、決定的な指摘と編集上の判断を分けて報告します。区分は、決定的な違反、ヒューリスティックな編集レビュー、有害または差別的な表現のレビュー、外交上の配慮、監査です。各指摘について、ルールの出典、プロファイル、確信度、制約、推奨する人間による対応を含めます。返却する内容でも、それらの項目をそのまま維持してください。

--stdin は標準入力から 1 つの文書をプレーンテキストの文章として読み込み、合成名 <stdin>.txt を付けます。この場合、--fix は使用できません。--claims <file> は登録済みの主張レジスターを検証し、--claims-out <file> は主張レジスターを書き出します。レジスターのルール（UE-CL002、UE-CL003）が検証するのは、記録が行われたことだけであり、主張が真実であることではありません。--emit-corrected <file> は、決定的な修正を適用した PDF 1 件分の復元コピーを書き出します。冒頭には、復元された作業用テキストであることを示す通知が付加されます。同じ実行のレポートからそのテキストを取得し、原文と照合してください。

node <skill-base>/bin/check.mjs --self-test を実行してインストールを検証します（同梱のコーパスを用い、期待される指摘内容と厳密に照合します）。--init はホストと CI のスニペットを含むスターター .un-editorial.json を書き出し、--baseline <path> は既存のコーパスを記録して、新たな指摘のみを失敗として扱います。

チェック対象と対象外

分類されたユーザー向けコピーのみをチェックします。対象は、HTML のテキストノードおよびコピーを含む属性内の文章、Markdown、プレーンテキスト、表示先への代入、コピーとして使われるテンプレートや連結、文のようなリテラルなど、レンダリングされた証拠がある JavaScript 文字列リテラル、ならびに PDF から抽出されたテキストです。コメント、コード、識別子、URL、引用されたタイトルは、いずれのルールも実行される前にマスキングされます。引用文やブロック引用文は黙って除外せず、文脈とあわせて分類します。有害または差別的な内容に関するレビューが該当する場合は、引用または報告された内容として個別に報告します。

PDF（.pdf）、文書コンテナー（.docx、.odt）、および --url で指定された名前の http(s) ページを読み取れます。取得したページは URL を名前としてチェックします。エラーステータス、HTML でもプレーンテキストでもない応答、4 MiB を超える本文は、終了コード 2 で拒否されます。また、監査対象はローカルディスク上のファイルに限られます。これはレンダリング済みのページであり、ソースではありません。ツールはテキストを抽出してその中の指摘事項を報告しますが、引用と段落を区別できないため、PDF 内のすべてのコピーを authored として扱います。そのため、PDF 内の引用文も除外せずに検査します。line は、テキストの位置情報から再構成した視覚上の行を指し、文書全体を通して連続して数えられます。ソースの行ではありません。指摘事項は JSON と SARIF の出力に pdfPage を含みます。スキャン済みまたは画像のみの文書、暗号化された文書、文字コードを復元できないフォントを含む文書は、理由とともに終了コード 2 で拒否されます。問題なしと報告されることも、部分的に読み取られることもありません。拒否された PDF をチェック済みと説明せず、OCR も提案しないでください。ツールは OCR を実行しません。--fix は PDF とすべての文書コンテナーを拒否するため、適用済みの書き換えではなく、レポートに記載された修正案を使用してください。.docx または .odt の本文は段落ごとに抽出されます。line は、文書内の順序で抽出された段落を指します。テキストボックス、ヘッダー、フッター、脚注、文末脚注、コメントは読み取られません。取り消し線付きのコピーはユーザー向けに表示されないため、変更履歴で削除された箇所は除外されます。暗号化された文書、誤った拡張子が付けられたファイル、本文テキストを復元できないコンテナーは、理由とともに終了コード 2 で拒否されます。問題なしと報告されることはありません。

コード品質、アクセシビリティ、セキュリティ、SEO に関する指摘事項は、編集ルールではなく監査項目です。これらは --profile publishing、--profile accessibility、または --profile security を指定した場合にのみ実行され、専用のセクションに報告されます。また、終了コードは変更しません。

--report <path.pdf> はレビュー結果を PDF として、--report <path.html> は単一の自己完結型 HTML ページとして出力します。どちらも修正前の状態を記録し、すべての指摘事項についてルールの出典、プロファイル、確信度、制約、推奨される対応を含めます。また、事実の検証、法律上の意見、国際連合による承認を示すものではないことを明記します。ツールがレンダリングできない拡張子は、暗黙に別の形式へフォールバックせず、拒否されます。

--glossary <file> は、読者独自の用語を報告します。コピー内にある forbiddenTerms リストの用語と、スキャンしたファイルのどこにもない requiredTerms リストの用語が対象です。これらの指摘事項は読者独自の表記ルールとして報告し、国際連合のルールとして扱わないでください。rules/sources.json には記録せず、監査レーンの項目であり、終了コードには影響しないことを明記してください。--fix は用語集の用語を書き換えません。

--watch は、1 人で編集する際に変更を検知して再スキャンします。終了コードは確定せず、中断すると 130 で終了します。継続的インテグレーションでは使用しないでください。

境界

ユーザーに対象ファイルを先に提示せずに --fix を実行しないでください。--fix は (proposed) の差分を出力しますが、何も書き込みません。--fix --apply は書き込みを行い、結果に (applied) とラベルを付けます。対象は、.md、.markdown、.txt ファイル内の決定論的な置換（イギリス英語の綴り、per cent、範囲を示す en ダッシュ、the United States、重複した単語、句読点前のスペース、文と文の間のスペース不足）に限られます。また、シンボリックリンク、ハードリンクされたファイル、PDF、通常ファイル以外は拒否します。生成された差分はすべて確認してください。日付、用語、主張、感嘆符は書き換えません。

終了コード：0 はエラー重大度の編集上の指摘なし、1 はエラー重大度の編集上の指摘あり、2 は使用法、設定、スキャン、書き込みの失敗を示します。監査によって終了コードが変わることはありません。指摘がない実行では No findings under the enabled, documented local rules. と出力されます。これがクリーンな結果の唯一の意味であり、ユーザーに報告してよいクリーン状態の表現はこれだけです。

設定は config/default.json と、任意のプロジェクトの .un-editorial.json、または --config <file> から読み込まれます。--profile の値には、組み込み監査名（publishing、accessibility、security）、同梱プロファイル名（un-secretariat-document、un-v1、un-geneva-web、generic-british-english）、または config/profiles/un-v1.json の同梱ベースラインにマージされる組織プロファイル JSON ファイルへのパスを指定します。文書化されていない設定キーを作り出さないでください。ルール ID の管理対象インデックスは rules/catalogue.json です。

既知の問題がない単一のケースを抑制するには、そのケースが属するコピー範囲内に記述し、理由をバージョン管理に記録してください：, または ``。抑制は、その段落にのみ適用されます。

baseOrigin が設定されている場合、正規 URL はそのスキーム、ホスト名、有効ポートに照らして確認されます。SRI の結果が証明するのは宣言の構文と必須属性であり、ダイジェストがダウンロードしたコンテンツと一致するかどうかではありません。