Menu
Project NyX の PyPI release を計画・実行する workflow skill。USE WHEN: ユーザが PyPI / TestPyPI への公開、バージョン更新、release PR、v* tag、GitHub Actions publish、公開後 smoke check、release 手順の確認を依頼したとき。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | pypi-release |
| description | Project NyX の PyPI release を計画・実行する workflow skill。USE WHEN: ユーザが PyPI / TestPyPI への公開、バージョン更新、release PR、v* tag、GitHub Actions publish、公開後 smoke check、release 手順の確認を依頼したとき。 |
Project NyX (nyxpy-fw, import package nyxpy) の release preflight、version bump PR、GitHub Actions Trusted Publishing、post-publish smoke check を進める。
手元の twine upload は使わない。.github/workflows/publish.yml を使い、production PyPI は v* tag ref から workflow_dispatch の target=pypi で publish する。tag push だけでは publish されない。
| 入力 | 扱い |
|---|---|
version | 明示されたらその version を候補にする。未指定なら latest tag と未リリース commit から提案する。 |
releaseType | patch / minor / major。未指定なら変更内容から提案する。 |
includeTestPyPI | 明示された場合のみ TestPyPI workflow を通す。高リスク変更では実行を提案する。 |
createGitHubRelease | 既定で提案する。不要と明示されたら final report だけにする。 |
realDeviceSmoke | 実機 smoke は、ユーザの明示承認と機材準備がない限り実行しない。 |
git status --short が clean であること。spec/agent/complete/local_015/PYPI_PUBLICATION_RUNBOOK.md と .github/workflows/publish.yml が存在すること。nyxpy-fwniart120/Project_NyXpublish.ymltestpypi または pypitarget=pypi workflow 実行は、current turn で明示確認を得てから行うこと。git branch --show-current と git status --short --branch を確認する。origin/<default> を確認し、release PR 作成時は release/vX.Y.Z branch を使う。git fetch --tags origin で tag を更新する。git tag --list "v*" --sort=-version:refname と git log --oneline --no-merges <latest-tag>..HEAD で未リリース差分を読む。pyproject.toml、uv.lock、README、docs、spec/agent/complete/local_015/PYPI_PUBLICATION_RUNBOOK.md の package name / version / Python support / entry points / optional extras の drift を確認する。.github/workflows/publish.yml が target=pypi を refs/tags/v* に制限し、publish job に id-token: write を持つことを確認する。| 条件 | 既定の release type |
|---|---|
| docs、metadata、bug fix、dependency constraint cleanup | patch |
| 後方互換の public API / CLI / GUI / macro API 追加 | minor |
| import package、public API、CLI、設定、dependency surface の破壊的変更 | major または pre-1.0 の explicit version |
Project NyX はアルファ版だが、破壊的変更を含む release では release plan に対象範囲と移行不要の理由を書く。
feat commit があるのに patch を選ぶ場合、理由を release plan に書く。
BREAKING CHANGE または ! 付き commit があるのに minor 以下を選ぶ場合、中断して user に確認する。
release/vX.Y.Z branch を作る。pyproject.toml の project version を更新する。uv lock で uv.lock を同期する。spec/agent/complete/local_015/PYPI_PUBLICATION_RUNBOOK.md の例、release note draft、必要な docs を更新する。dist/.gitignore は残し、過去 version の wheel / sdist は削除する。uv sync --dev
uv lock --check
uv run ruff format --check .
uv run ruff check .
uv run ty check src/nyxpy --output-format concise --no-progress
uv run pytest
uv run vulture src tests examples macros --min-confidence 80
uv run --no-sync mkdocs build --strict
Remove-Item -Force dist\nyxpy_fw-*.whl, dist\nyxpy_fw-*.tar.gz -ErrorAction SilentlyContinue
uv build
uvx twine check --strict dist\nyxpy_fw-X.Y.Z-py3-none-any.whl dist\nyxpy_fw-X.Y.Z.tar.gz
git diff --check
next(Path("dist").glob("*.whl")) のような曖昧な選択は、古い artifact を誤検査するため使わない。
nyxpy/__main__.py、nyxpy/py.typed、nyxpy/framework/、entry points nyxpy / nyx-cli / nyx-gui を含むこと。.pypirc、.nyxpy、dist/、site/、ローカル作業用 macros/、ローカル作業用 resources/ を含まないこと。pr-merge-cleanup に委譲する。Publish Python Package workflow の workflow_dispatch path で、target=testpypi を指定して実行する。--no-deps で取得し、依存は PyPI から解決する手順を優先する。spec/agent/complete/local_015/PYPI_PUBLICATION_RUNBOOK.md の「TestPyPI install 確認」に従う。origin/<default> と同期していることを確認する。vX.Y.Z tag が存在しないことを再確認する。git tag -a vX.Y.Z -m "vX.Y.Z"
git push origin vX.Y.Z
Publish Python Package workflow を vX.Y.Z ref から target=pypi で手動実行する。twine check が通った後の requests.exceptions.ChunkedEncodingError など attestation / network 系 failure は、metadata 変更ではなく failed job rerun 候補として扱う。https://pypi.org/pypi/nyxpy-fw/X.Y.Z/json
uvx --from nyxpy-fw==X.Y.Z python -c "import importlib.metadata, nyxpy; print(importlib.metadata.version('nyxpy-fw')); print(nyxpy.__name__)"
uvx --from nyxpy-fw==X.Y.Z nyxpy --help
uvx --from nyxpy-fw==X.Y.Z nyx-cli --help
uvx --from "nyxpy-fw[windows]==X.Y.Z" python -c "import importlib.metadata; print(importlib.metadata.version('nyxpy-fw'))"
uvx --from "nyxpy-fw[ponkan]==X.Y.Z" python -c "import importlib.metadata; print(importlib.metadata.version('nyxpy-fw'))"
origin/<default> と同期していない。pyproject.toml、uv.lock、README、docs、publication runbook の metadata が矛盾している。target=pypi の tag 制約または id-token: write を満たしていない。target=pypi workflow 実行の明示意図がない。最終報告には次を含める。
- version:
- release type:
- release branch / PR:
- tag:
- merge commit:
- TestPyPI:
- PyPI URL:
- publish workflow run:
- local gates:
- post-publish smoke:
- GitHub Release:
- GUI / real device: used | not used | not run with reason
- follow-up:
フレームワーク本体 (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自動化マクロの設計仕様・実装仕様・テスト方針を所定フォーマットで執筆する。
作業ブランチを GitHub PR 経由で main にマージし、ローカル同期・ブランチ削除まで一括実行するワークフロースキル。USE WHEN: ユーザが「PRを出して」「マージして」「ブランチをまとめて」「mainに入れて」「PRクリーンアップ」など、作業ブランチの変更をリモートに反映したい意図を示したとき。push → PR作成 → squashマージ → ローカル同期 → ブランチ削除の全ステップを自動化する。
実装中の設計上の気づき・疑問・バックログ送りにしたタスクを spec/dev-journal.md に記録するスキル。USE WHEN: ユーザが「ジャーナルに書いて」「メモしておいて」「dev-journal に追記して」「これ記録して」「あとで見返せるようにして」「バックログに入れて」「後回しにしたい」など、実装中の気づきや先送りタスクの記録を依頼したとき。spec/dev-journal.md を読み書きするときは必ず参照すること。
Project NyX のマクロ実装・修正・レビューを行うスキル。USE WHEN: ユーザが「マクロを作って」「マクロを直して」「macros/ 配下を実装」「resources/ の設定を追加」「NyX の MacroBase / Command を使う」「examples/macros を参考にしたい」など、Nintendo Switch 自動化マクロのコード・設定・テストを扱う意図を示したとき。仕様書だけを書く場合は macro-spec-writing を使う。