Skip to main content

moai spec ドキュメント管理

更新 2026-09-11 3分で読めます GitHub で編集 ↗

moai spec は .moai/specs/ ディレクトリの SPEC ドキュメントを管理します。ステータス更新、ドリフト検出、受け入れ基準の照会、EARS/GEARS リント、原子的クローズ、era 監査、アーカイブのサブコマンドを提供します。

サブコマンド

コマンド説明
moai spec statusSPEC ステータスの更新または一覧表示
moai spec driftfrontmatter status と git log 間のドリフト検出
moai spec view <SPEC-ID>受け入れ基準をツリー構造で照会
`moai spec lint [SPEC-IDpath/to/spec.md
moai spec close <SPEC-ID>原子的 4-phase クローズ (status: completed + progress.md backfill)
moai spec auditSPEC era 分類と modern-era ステータスドリフト監査
moai spec archiveクローズ済み SPEC を .moai/specs/ の外へアーカイブ

moai spec status

bash
moai spec status <SPEC-ID> <new-status>   # ステータス更新
moai spec status --list                   # 全 SPEC を一覧表示
moai spec status --sync-git               # git log からステータス同期
フラグ説明
--dry-run書き込みなしで変更をプレビュー
--list全 SPEC とステータスを一覧表示
--sync-gitmain の git log から SPEC ステータスを同期
--yes--sync-git の非対話自動確認 (CI/パイプ必須)

moai spec drift

bash
moai spec drift
フラグ説明
--jsonJSON 形式で出力
--exit-code-on-driftドリフト検出時に終了コード 1
--countドリフト件数のみ出力
--no-cacheHEAD-SHA 結果キャッシュを迂回して再計算

moai spec lint

bash
moai spec lint [SPEC-ID | path/to/spec.md | SPEC directory ...]
フラグ説明
--jsonJSON 形式で出力
--sarifSARIF 2.1.0 形式で出力
--strict警告をエラーとして扱う
--format <fmt>出力形式 (table)
--baseline <path>--strict の代わりにリポジトリにチェックインされたルール別ベースラインでゲートする — エラーは常に失敗、ルールの非advisory警告数は記録値を上回った場合のみブロックし、残存する警告総数は出力にそのまま表示される
--update-baseline--baseline ファイルを再計算して書き直す(--reason が必須)
--reason "<text>"--update-baseline が記録する必須の空でない理由 — 理由が空または未指定の場合は拒否される
引数の形例
SPEC-IDSPEC-SPC-001 — プロジェクトルート配下の .moai/specs/SPEC-SPC-001/spec.md に解決 (moai spec view と同じ規則)
ファイルパス.moai/specs/SPEC-SPC-001/spec.md
SPEC ディレクトリ.moai/specs/SPEC-SPC-001 — その中の spec.md を読みます

3 つの形は 1 回の呼び出しで混在できます。引数がなければ従来どおりコーパス全体を走査します。SPEC-ID に見えるのに解決先のファイルがない場合は、文書に対する指摘ではなく 引数エラー (終了コード 3) となり、試したパスを併せて知らせます。

ここから出る警告のうち 2 つは advisory 等級です。ModalityUnjudged は、リンターが判定できない要求事項を黙って見送らずにその事実を知らせます。REQTableRowsRejected は、定義表として読まれなかった表の行を知らせます。どちらも advisory であり、--strict でもエラーに昇格せず、終了コードを変えません。

moai spec close

bash
moai spec close SPEC-ID

SPEC を単一コミットで status: completed へ原子的に遷移させます。

フラグ説明
--backfill-onlyprogress.md の backfill のみ実行
--dry-runコミットせずプレビュー
--force確認なしで強制クローズ
--jsonJSON 形式で出力

moai spec audit

bash
moai spec audit

.moai/specs/SPEC-*/ をスキャンして各 SPEC を era ヒューリスティックで分類し、modern-era ステータスドリフトを検出します。

フラグ説明
--jsonJSON 形式で出力
--filter-era <era>era でフィルタ
--filter-spec <id>SPEC ID でフィルタ
--include-grandfatheredgrandfather era SPEC を含める
--strict厳格モード

moai spec archive

bash
moai spec archive --dry-run   # 対象確認 (移動なし)
moai spec archive --yes       # 計画を適用

grace ウィンドウ (デフォルト 90 日) より古い terminal SPEC をアーカイブします。

フラグ説明
--dry-run移動なしで対象集合を報告
--yes移動を確定 (適用に必須)
--grace-days <n>grace ウィンドウの日数 (0 = デフォルト 90)
--json計画を JSON で出力

関連ドキュメント