機械可読仕様書の記述ガイドブック（案）

本書のステータス: ドラフト（DS シリーズ素案）。本書は将来デジタル社会推進標準ガイドライン群 （DS シリーズ）に組み込むことを前提に、その様式を踏襲して作成した素案である。DS 番号は未採番で あり、本書では仮置きとして ds-4xx（4 番台のいずれか）と表記する。正式番号は確定時に採番する。

本書の目的

現在、標準仕様書は Word／Excel で作成され、それを Markdown／YAML へ変換して掲載している。変換は 原本の体裁（自動採番・setext 見出し・pandas ダンプ表・PUA グリフ等）に起因する崩れを伴い、変換器が 原本の癖を吸収し続ける必要がある。

本書は発想を逆転し、最初からテキストを正本として書く場合に、人間・AI・プログラムのいずれもが 等しく扱える仕様書とするための記述ルールを定める。テキストを正本とすれば、Git による差分・レビュー・ 版管理がそのまま仕様の改訂プロセスになり、変換の往復で情報が失われることもない。

本書が定めるフォーマットは、これまで mrlgss が運用してきた 2 つのプロファイル （軽量な文書索引層 mrlgss-doc/0.1 と、型付き正本層 chimata-okf/0.1）を、オーサリングの観点から 一本に統合したものである。

想定読者

• 標準仕様の所管（制度官庁）で、仕様書を起草・改訂する担当者
• 仕様書を機械可読化する技術者
• 仕様書を参照して実装するベンダー開発者・自治体職員（記述の意味を正しく読み取るため）

章構成

• 第1章 なぜテキストを正本とするのか
• 第2章 ファイルとディレクトリの規約
• 第3章 frontmatter の書き方
• 第4章 本文と規範文の書き方
• 第5章 payload（型付き正本）の書き方
• 第6章 規範レイヤー・URN・トレーサビリティ
• 第7章 文字の標準化への準拠
• 第8章 改訂と版管理
• 第9章 適合性と検証

改定履歴