mcpField
S
sdo-docx-formatting

sdo-docx-formatting

github.com/jr2804ドキュメント049 回インストール2 日前に更新
リポジトリ

sdo-docx-formatting について

3GPP、ETSI、ITU-T などの標準化団体向けに、技術文書の書式規則を適用するスキルです。名前付きスタイルと更新可能な番号・参照を用い、具体的なスタイル対応には各団体のドラフティングスキルを参照します。

主な機能

  1. 01名前付き段落・文字スタイルを適用
  2. 02更新可能な番号と相互参照を使用
  3. 03標準文書と会議文書の規則に対応
  4. 04見出し、注記、表、引用の規則に準拠
  5. 05SDO ごとのスタイル対応を使用

活用シーン

  1. 01技術標準文書を整形
  2. 02標準化会議の寄書を準備
  3. 03番号と相互参照を更新可能に保つ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jr2804/prompts --skill sdo-docx-formatting

インストール後、Claude Code で/sdo-docx-formattingを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
citations.md
enumerations.md
equations.md
headings.md
notes.md
tables-figures.md
text-formatting.md

詳細

標準文書の書式設定

すべてのSDO(3GPP、ETSI、ITU-T)における正式な技術文書には、以下の規則を適用してください。このスキルでは、概念レベルで何をすべきかを説明します。具体的なWordのスタイル名はSDOによって異なり、各SDO向けのドラフティングスキル(3gpp-drafting、etsi-drafting、itut-drafting)に記載されています。

基本ルール

  1. 書式設定には、ドキュメントテンプレートで定義された名前付きの段落スタイルと文字スタイルのみを使用してください。直接書式設定やその場限りの書式設定(太字の切り替え、フォントサイズの変更、名前付きスタイルを使わない色の追加など)は決して行わないでください。必要な名前付きスタイルがドキュメントテンプレートにない場合は、ユーザーに伝え、適用前にスタイル定義を作成することを提案してください。
  2. 番号と参照は更新に対応できる状態にしてください。SEQフィールドとブックマークを使用し、番号を直接入力しないでください。
  3. 意味上ひとまとまりになる単位(数値+単位、図/表+番号)には、改行なしスペース(\u00a0)を使用してください。
  4. タブで区切る構造要素(見出し番号+タイトル、列挙記号+テキスト、注記ラベル+テキスト)には、スペースではなく実際のタブ(<w:tab/>)を使用してください。officecliのパターンについては、sdo-docx-operationsを参照してください。

スタイル名の抽象化

このスキルでは抽象的なスタイル名を使用します。各SDOのドラフティングスキルで具体的な対応関係を示しています。例:

抽象名用途3GPP / ETSIITU-T
body-text本文の段落NormalBody Text
heading-1 から heading-3節の見出しHeading 1--Heading 3Heading 1--Heading 3

正しい具体的なスタイルIDについては、必ず各SDO向けのドラフティングスキルを確認してください。各SDO向けのドラフティングスキルがコンテキストにない場合は、どのSDOに適用するのかをユーザーに確認し、上の表の対応例を既定値として使用してください。

分野別の規則

文書モード(最初に適用)

構造上の規則を適用する前に、文書の種類を判定してください。

  • 標準モード(仕様書、報告書、勧告、規範): 条項を中心とする構造(N、N.M、N.M.P)を使用し、規範的参照は早い段階の条項(通常は第2条項)として扱います。
  • 会議文書モード(寄書、提出文書、TDoc/TD): テンプレートまたはSDOの慣行で認められていれば、セクションを中心とする構造を使用できます。参照のセクションは文書の後半に配置されることがよくあります。

判断できない場合は、その文書が会議文書なのか、正式な標準なのかをユーザーに確認してください。

見出し(重要な規則)
  • 条項やセクションには、MS Wordの自動番号付けを決して使用しないでください。見出し番号とタイトルの間には<w:tab/>を使用してください。
  • 番号付け:N → N.M → N.M.P。
  • 標準モードでは、内部構造と相互参照に「セクション」ではなく「条項」の用語を使用してください。
  • 独立した見出しとして表示する場合、「References」には番号を付けません。
列挙(重要な規則)
  • MS Wordの組み込みリスト機能は決して使用しないでください。 箇条書きの後に<w:tab/>を入れた、enダッシュ(–)による列挙を優先してください。
  • 階層レベルにはenum-1、enum-2、enum-3のスタイルを使用してください。
注記(重要な規則)
  • 形式:NOTE\u00a0N:\t<text>(NOTEは大文字、改行なしスペース、実際のタブ)。注記が1つだけの場合は番号を省略します。
  • ブロック内の最後の注記にはnote-main、その前の注記にはnote-continuationを使用します。
表と図(重要な規則)
  • 表のキャプションは表の上に配置します:Table\u00a0N: <text>。{SEQ Table \* ARABIC}フィールドを使用し、番号部分のみをブックマークtbl_<name>で囲みます。
  • 図のキャプションは図の下に配置します:Figure\u00a0N: <text>。{SEQ Figure \* ARABIC}フィールドを使用し、番号部分のみをブックマークfig_<name>で囲みます。
  • 番号を直接入力しないでください。 相互参照には{REF bookmark}を使用してください。
引用(重要ルール)
  • 各項目は、reference-entry スタイルと {SEQ Ref \* ARABIC} フィールドを使用して、[N]\t<text> の形式にします。ブックマーク ref_<name> は、シーケンスフィールドのみを囲むように配置します。
  • 規格モードでは、規範的な「References」は通常、文書の冒頭付近(多くの場合、箇条2)に配置します。「Bibliography」がある場合は、附属書の後に続く、情報提供を目的とした末尾のセクションまたは附属書とします。
  • 会議文書モードでは、「References」セクションは通常、末尾付近または末尾に配置します。
テキスト書式(重要ルール)
  • 段落には body-text、インラインコード/ファイル名には code-text を使用します。
  • 数値と単位の間、および図/表と番号の間には、改行なしスペースを入れます。
  • 引用符は半角の直線型("、')のみを使用し、曲線型/タイポグラフィック引用符は使用しません。
数式(重要ルール)
  • ディスプレイ数式は、スタイル equation を使用した単一の段落とし、構造を \t<equation>\t(<SEQ EQ>) とします。
  • 数式番号を直接記述しないでください。{SEQ EQ \* ARABIC} を使用します。
  • 相互参照のため、番号付きラベルを囲むようにブックマーク EQ_<name> を配置します。
  • 本文と混在するインライン数式には、番号を付けずに oMath ランを使用します。

詳細は、次のリファレンスファイルを参照してください。

相互参照

  • sdo-docx-operations -- タブランの挿入、フィールドコードの挿入、ブックマークの挿入に関する officecli のパターン
  • sdo-writing-style -- テキストコンテンツの文章品質ルール
  • 各 SDO のドラフティングスキル(3gpp-drafting、etsi-drafting、itut-drafting)-- 具体的なスタイル名の対応付け

コメント