Imported from kuntaro0524/ZOOALL (
AGENTS.md). Install upstream withnpx skills add kuntaro0524/ZOOALL. Copyright stays with the author.
AI向け作業指示
必読
開始と作業範囲
- 最初にbranch・HEAD・未commit変更を確認する。既存差分を自分の変更と扱わず、無断で戻したりcommitに含めたりしない。
- 依頼が調査・提案のみならファイルを変更しない。通常の実装では共通ワークフローに従い、依頼範囲の可逆な作業を進める。
- Issue番号や検証結果を推測で埋めない。Issueへアクセスできなければ、その制限と共有未完了事項を報告する。
- 補助スクリプトと管理用YAMLは現時点では未実装。存在を確認せず実行を案内しない。
ZOOでの操作
- 一般的なコード修正依頼を、実機操作や本番DB/API更新の許可と解釈しない。対象・操作が依頼で明示されていなければ、実行前に確認する。
TestScripts/やtest*.pyを一括実行しない。importだけでも外部接続・ファイル更新が起こり得るため、対象コードを確認する。beamline.ini、端末固有パス、装置接続先を開発管理整備に伴って書き換えない。- 運転中のcloneでcheckout・pull・mergeや実行コードの変更を行わない。運転状態が不明なら装置に影響する変更を進める前に確認する。
- 開発の再開を装置操作の再実行と同一視しない。handoffの再実行禁止事項と現在の状態を確認する。
終了
共通ワークフローのcompleted / paused / no meaningful changeを適用する。変更内容、実施した検証、未確認事項、commit・push・Issue更新の実施状況を正確に報告する。commit・pushしていない状態を共有済みとは呼ばない。
Issue作成・更新、commit・pushなどが依頼範囲や利用可能な権限に含まれない場合は、ローカルで可能な準備を済ませ、残る具体的な操作を報告する。
AIモデルの使い分け
通常の調査、小〜中規模のコード修正、テスト追加、文書化、PR準備はgpt-5.6-solを標準とする。複数モジュールをまたぐ変更、develop/mainの統合、装置挙動に関わる判断、設計整理はgpt-6-astraを優先する。単純な検索や機械的な一覧作成は軽量モデルでもよい。
ZOOはアルゴリズムだけでなく、古いPythonコード、ビームラインごとの差、設定・装置・DB・Webの関係、実機への影響を同時に扱う。モデルの判断だけで実機操作や本番DB更新を実行せず、対象環境・検証結果・未確認事項を明示する。BL32XUで確認したことをBL45XUやBL41XUの合格とは扱わない。