Skip to main content

moai spec ドキュメント管理

更新 2026-07-18 2分で読めます 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.md...]EARS 準拠と構造妥当性のリント
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.md...]
フラグ説明
--jsonJSON 形式で出力
--sarifSARIF 2.1.0 形式で出力
--strict警告をエラーとして扱う
--format <fmt>出力形式 (table)

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 で出力

関連ドキュメント