コマンド実行を自動化!KiroのPermissionsについて

技術情報
技術情報

Permissionsとは

Permissionsは、Kiroが実行する操作に対して権限を設定する機能です。

Kiroはコード生成だけでなく、ファイル編集やターミナルコマンドの実行も行うことができます。そのため、意図しない操作や危険なコマンドの実行を防ぐためにPermissionsが用意されています。

Permissionsでは操作ごとに以下の権限を設定できます。

設定内容
allow確認なしで実行
ask実行前に確認
deny実行を拒否

AIへ作業を委任しながらも、安全性を維持できる仕組みとなっています。

Permissionsの設定方法

PermissionsはYAML形式で定義します。

設定は以下の場所に保存されます。

ユーザー設定

すべてのプロジェクトで共通利用したい場合は、以下に設定を配置します。

C:\Users\<ユーザ名>\.kiro\settings\permissions.yaml

この設定はKiroで開くすべてのプロジェクトに適用されます。

セッション(ワークスペース)設定

特定のプロジェクトのみで利用したい場合は、Kiroが管理するワークスペース設定へ保存されます。

~/.kiro/workspace-roots/<hash>/permissions.yaml

<hash>はワークスペースごとに自動生成されます。

優先順位

複数のルールに一致した場合は、以下の優先順位で判定されます。

deny > ask > allow

そのため、Allow設定が存在してもDeny設定に一致した場合は実行できません。

設定例

以下は実際に利用しているPermission設定の一部です。

rules:
  # Gitの状態確認は自動許可
  - capability: shell
    effect: allow
    match:
      - "git status*"
      - "git log*"
      - "git diff*"

  # Gitの更新操作は確認
  - capability: shell
    effect: ask
    match:
      - "git add*"
      - "git commit*"
      - "git push*"

  # 危険な操作は拒否
  - capability: shell
    effect: deny
    match:
      - "git push --force*"
      - "git reset --hard*"

この設定では、

  • git status や git log は確認なしで実行
  • git commit や git push は実行前に確認
  • git push --force や git reset --hard は実行不可

という制御を実現できます。設定内容はプロジェクトや運用方針に応じて調整可能ですが、「危険な操作は拒否」「変更を伴う操作は確認」「参照のみの操作は許可」という方針で設定すると、安全性と利便性のバランスを取りやすくなります。

Permissionsを設定するメリット

承認回数を削減できる

安全なコマンドをallowに設定することで、毎回承認する必要がなくなります。

例えば、

  • git status
  • git log
  • Get-Content

などの頻繁に利用するコマンドは、作業を止めることなく実行できます。

安全性を向上できる

危険なコマンドをdenyに設定することで、誤操作を未然に防止できます。

特にGit操作では、

  • Force Push
  • Hard Reset
  • ファイル削除

などのリスクを低減できます。

AIへ安心して作業を任せられる

Permissionsによって、

  • 安全な操作は自動実行
  • 重要な操作は確認
  • 危険な操作は拒否

という運用を実現できます。

そのため、AIエージェントを活用しながらも、人間が適切なコントロールを維持できます。

まとめ

Permissionsは、KiroでAIエージェントを安全に利用するための権限制御機能です。

適切に設定することで、

  • 開発効率向上
  • 承認作業の削減
  • 誤操作防止
  • セキュリティ向上

を実現できます。

特に業務で利用する場合は、「すべて許可する」のではなく、

  • 危険な操作は拒否
  • 重要な操作は確認
  • 安全な操作は許可

という方針で設定することで、安全性と利便性の両立が可能になります。Kiroを本格的に活用する際は、まずPermissionsを整備することで、AIエージェントへ安心して作業を委任できる環境を構築できます。

タイトルとURLをコピーしました