Skip to main content

moai tool-policy ツールポリシー

更新 2026-07-18 1分で読めます GitHub で編集 ↗

moai tool-policy はツール/権限ポリシーの SSOT を管理します。.moai/config/sections/tool-policy.yaml が唯一の真実源であり、ここから settings.json の permissions ブロックを生成 (codegen) し、ポリシー項目を照会します。

サブコマンド

コマンド説明
moai tool-policy buildtool-policy.yaml から settings.json permissions ブロックを再生成
moai tool-policy listtool-policy 項目を一覧表示 (thin query)

moai tool-policy build

bash
moai tool-policy build
moai tool-policy build --local-only

ローカル .claude/settings.json とテンプレート settings.json.tmpl の permissions ブロックを再生成します。

フラグ説明
--repo-root <path>リポジトリルート (デフォルト: cwd)
--policy <path>tool-policy.yaml のパス (デフォルト: <repo-root>/.moai/config/sections/tool-policy.yaml)
--local-onlyローカル .claude/settings.json のみ再生成 (テンプレート .tmpl を省略)
--template-onlyテンプレート settings.json.tmpl のみ再生成 (ローカルを省略)
--default-mode <mode>permissions.defaultMode を上書き (デフォルト: 既存値を保持)
--json結果を JSON で出力

moai tool-policy list

bash
moai tool-policy list
moai tool-policy list --risk-tier irreversible --decision deny
フラグ説明
--risk-tier <read|write|irreversible>リスクティアでフィルタ
--decision <allow|deny|ask>決定でフィルタ
--tool <name>ツール名でフィルタ (完全一致)
--format <text|json>出力形式
--repo-root <path>リポジトリルート (デフォルト: cwd)
--policy <path>tool-policy.yaml のパス

関連ドキュメント