USDM Tools

USDM (Universal Specification Describing Manner) 形式のソフトウェア要求仕様書を Markdown で記述し、Excel (.xlsx) を生成するツール群。

セットアップ

pip install .          # インストール
pip install -e .       # 開発モード（編集即反映）

基本的な使い方

1. プロジェクト作成

usdm new MyProject my_project

Markdown の雛形と Excel が生成される:

my_project/
├── index.md              # ヘッダーテーブル + シート一覧
├── MyProject.md          # コンポーネント（プロジェクト全体の要求）
├── MyProject.xlsx        # Excel
└── sheet01/
    ├── index.md
    └── MyProject_R01/
        ├── MyProject_R01.md       # 上位要求
        └── MyProject_R01.DM01.md  # 下位要求 + 仕様テーブル

2. シート追加

usdm add my_project "2.機能要件"

3. Markdown 編集

雛形のプレースホルダーを実際の要求・仕様に書き換える。記法の詳細は MANUAL.md を参照。

4. Excel 生成

md2usdm my_project

コマンド一覧

コマンド	説明
usdm new <名前> <出力先>	新規プロジェクト作成
usdm add <プロジェクト> <シート名>	シート追加
md2usdm <プロジェクト> [出力.xlsx]	Markdown → Excel 変換
usdm2md <Excel> [出力先]	Excel → Markdown 変換
compare-excel <A.xlsx> <B.xlsx>	Excel セル比較

ドキュメント

• MANUAL.md — Markdown 記法・ファイル構造の詳細
• USDM_AGENT_GUIDE.md — AI エージェント向け USDM 作成ガイド
• examples/ — 完成例（md2usdm, usdm2md）