persistent-side-effects について
Persistent Side Effectsは、受け入れられた実装依頼で認められる操作と、個別承認が必要な操作を定めるエージェントスキルです。変更範囲を守り、必要なローカル検証と外部操作・破壊的操作を区別できます。
主な機能
- 01実装許可の境界を定義
- 02依頼に含まれる変更を明示
- 03重要な操作に個別承認を要求
- 04範囲と影響に基づく許可確認
- 05副作用の完了条件を設定
活用シーン
- 01実装手順に承認が必要か判断
- 02受け入れ済み計画の範囲内でコードを変更
- 03破壊的操作や外部操作の前に権限を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ liaoann/ skills --skill persistent-side-effectsインストール後、Claude Code で/persistent-side-effectsを入力して読み込まれたか確認します。
詳細
永続的な副作用
受け入れられた実装依頼または計画は、その範囲内で必要な変更を許可するものであり、エージェントが実行可能なあらゆる操作を許可するものではありません。質問、調査、計画の依頼だけでは、実装は許可されません。
実装の承認に含まれるもの
ファイルやコマンドごとに再度確認することなく、次の操作を行えます。
- 受け入れられた成果に必要なソースファイルとテストを作成または編集する。
- 変更に必要な場合、プロジェクトで想定されているツールを使って生成物を更新する。
- 安全性が確認されているローカル検証を実行し、依頼された変更の範囲内で発生した失敗を修正する。環境が本番環境から隔離されていると確認できる場合は、一時的なフィクスチャや想定されるビルド/テスト出力も含まれます。
/agentic-change-governance配下で必要なローカルサポートの編集を行う。
計画に正確なファイル名を列挙する必要はありません。許可の範囲は、受け入れられた成果と境界に基づきます。テストで変更が要求されても、それ自体が許可になるわけではありません。テストの隔離状況、本番環境へのアクセス、または破壊的なコマンドの動作が不明な場合は、コマンドを実行する前に確認する必要があります。
個別の承認が必要な操作
このタスクについてすでに明示的に承認されている場合を除き、次の操作には個別の承認が必要です。
- ステージング、コミット、ブランチの作成または切り替え、プッシュ、公開、デプロイ。
- 既存のユーザー向けファイルの削除や移動、無関係な作業の上書き、データの削除、コンテナやボリュームの削除などの破壊的な操作。
- 受け入れられた範囲外の変更、または
/agentic-change-governanceにおける新たな設計上の判断。 - 永続的な環境の作成、または共有システムや外部システムの変更。
- 成果物に必要のない一時ファイル、計画、メモ、利便性のための成果物の作成。原則として、これらは会話内にとどめてください。
ある操作への承認は、別の操作への承認を意味しません。実装の承認はコミットの承認を意味せず、コンテナの作成はその削除の許可を意味しません。既存のハーネス制限や、ユーザーによる明示的な禁止事項も引き続き適用されます。
承認の確認
操作の内容、影響を受けるリソース、その操作を許可する依頼または計画を特定してください。権限の範囲外で判断が必要な場合に限り、不足している判断を確認してください。すでに個別に承認されている操作について、再確認してはいけません。範囲や影響が不明確な場合は、実行前に確認してください。
完了基準
すべての副作用は、受け入れられた実装範囲内で必要な操作として上記の承認に含まれるか、実行前に個別の承認を得ている必要があります。包括的な承認があると推測して、無関係な作業、保護対象のリソース、外部システムに変更を加えてはいけません。