メニュー
Project NyX のマクロ実装・修正・レビューを行うスキル。USE WHEN: ユーザが「マクロを作って」「マクロを直して」「macros/ 配下を実装」「resources/ の設定を追加」「NyX の MacroBase / Command を使う」「examples/macros を参考にしたい」など、Nintendo Switch 自動化マクロのコード・設定・テストを扱う意図を示したとき。仕様書だけを書く場合は macro-spec-writing を使う。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
フレームワーク本体 (src/nyxpy/framework/) の仕様書を新規作成・レビュー・修正するスキル。Use when: ユーザが「フレームワークの仕様書」「framework spec」「コア機能の設計書」「Command / MacroBase / imgproc / logger 等の仕様」と言ったとき、または spec/agent/ 配下でフレームワーク関連の Markdown を扱うとき。フレームワーク層の公開 API・内部設計・テスト方針を所定フォーマットで執筆する。マクロ (macros/) の仕様書には macro-spec-writing スキルを使うこと。
マクロ仕様書の新規作成・レビュー・修正を行うスキル。Use when: ユーザが「仕様書を書いて」「specを作成」「仕様書レビュー」「仕様のテンプレート」と言ったとき、または spec/agent/ 配下のMarkdownを扱うとき。Nintendo Switch自動化マクロの設計仕様・実装仕様・テスト方針を所定フォーマットで執筆する。
Project NyX の PyPI release を計画・実行する workflow skill。USE WHEN: ユーザが PyPI / TestPyPI への公開、バージョン更新、release PR、v* tag、GitHub Actions publish、公開後 smoke check、release 手順の確認を依頼したとき。
作業ブランチを GitHub PR 経由で main にマージし、ローカル同期・ブランチ削除まで一括実行するワークフロースキル。USE WHEN: ユーザが「PRを出して」「マージして」「ブランチをまとめて」「mainに入れて」「PRクリーンアップ」など、作業ブランチの変更をリモートに反映したい意図を示したとき。push → PR作成 → squashマージ → ローカル同期 → ブランチ削除の全ステップを自動化する。
実装中の設計上の気づき・疑問・バックログ送りにしたタスクを spec/dev-journal.md に記録するスキル。USE WHEN: ユーザが「ジャーナルに書いて」「メモしておいて」「dev-journal に追記して」「これ記録して」「あとで見返せるようにして」「バックログに入れて」「後回しにしたい」など、実装中の気づきや先送りタスクの記録を依頼したとき。spec/dev-journal.md を読み書きするときは必ず参照すること。
| name | macro-development |
| description | Project NyX のマクロ実装・修正・レビューを行うスキル。USE WHEN: ユーザが「マクロを作って」「マクロを直して」「macros/ 配下を実装」「resources/ の設定を追加」「NyX の MacroBase / Command を使う」「examples/macros を参考にしたい」など、Nintendo Switch 自動化マクロのコード・設定・テストを扱う意図を示したとき。仕様書だけを書く場合は macro-spec-writing を使う。 |
Project NyX のマクロを、リポジトリ規約と現行フレームワーク API に沿って実装・修正・レビューします。
リポジトリ内で作業している場合:
docs\macro-development\agent-brief.mddocs\macro-development\README.mddocs\macro-development\macro-template.mdこのスキルだけを外部エージェントに渡す場合は、同じ文書を raw URL から取得します。
https://raw.githubusercontent.com/niart120/Project_NyX/master/docs/macro-development/agent-brief.md
https://raw.githubusercontent.com/niart120/Project_NyX/master/docs/macro-development/README.md
https://raw.githubusercontent.com/niart120/Project_NyX/master/docs/macro-development/macro-template.md
詳細が必要な場合は docs\macro-development\ 配下の各資料、現行コード、既存 examples、テストを根拠にします。spec\framework\rearchitecture は移行元の参考資料であり、公開契約の正本として扱いません。
macros\<macro_id> のマクロ本体resources\<macro_id> の設定ファイルと画像資材examples\macros, examples\resources, examples\tests の公開サンプル仕様書だけを作成・レビューする場合は macro-spec-writing を使います。フレームワーク本体 (src\nyxpy\framework) の API 変更や仕様書には framework-spec-writing を使います。
agent-brief.md を読み、配置・依存・公開 API・検証コマンドを確認します。MacroBase の initialize(cmd, args), run(cmd), finalize(cmd) に分けます。config.py や独立関数へ分離し、Command なしでテストします。resources\<macro_id>\settings.toml に置き、マクロ側は settings_path = "resource:settings.toml" を標準にします。resources\<macro_id>\assets に置き、cmd.load_img() では資材ディレクトリからの相対パスを使います。cmd.capture() はフレーム未準備時に例外を送出するため、通常分岐として握りつぶさず framework の実行失敗として扱います。macros\xxx -> nyxpy.framework.* OK
macros\xxx -> macros\shared OK
macros\xxx -> macros\yyy NG
examples\macros\xxx -> examples\macros\shared OK
examples\macros\xxx -> examples\macros\yyy NG
複数マクロで使う処理は共有部品に切り出します。共有部品はできるだけ Command に依存させず、引数と戻り値でやり取りします。
\ を使います。macro.toml や設定ファイルに保存する環境に依存しないパス表記では / を使います。resource: パスは resources\<macro_id> からの相対指定にします。project: パスはプロジェクトルートからの相対指定にします。static\<macro_name> は標準探索されません。macros\<macro_id> と resources\<macro_id> の対応が取れている。macro.py または __init__.py のどちらか一方に、そのファイルで定義した MacroBase 派生クラスが 1 つだけある。cmd.capture() の失敗をマクロ側の通常分岐として扱っていない。finalize() で押下状態の解放など必要な後片付けをしている。uv run ruff format .
uv run ruff check .
uv run ty check src/nyxpy --output-format concise --no-progress
uv run pytest tests macros