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エージェントへ安心して作業を委任できる環境を構築できます。