Menu
Tidy First の考え方に沿って behavior change と structure change を分離し、構造改善を先に行うか後に行うか判断する skill。USE WHEN: refactor、cleanup、設計整理、実装前の下準備、TDD の green 後の構造変更判断を行うとき。
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
ponkan-python の PyPI release を計画・実行する workflow skill。USE WHEN: ユーザが PyPI へのデプロイ、ライブラリのバージョンアップ、release tag 作成、TestPyPI / PyPI publish、post-publish smoke check、release 手順の確認を依頼したとき。
new 3DS XL capture board を使う実機検証の安全手順、pytest marker、driver/USB 状態、raw artifact 保存を確認するスキル。USE WHEN: requires_n3dsxl テスト、probe、raw capture、streaming smoke test を実行・設計するとき。
実装中の設計上の気づき・疑問・バックログ送りにしたタスクを spec/dev-journal.md に記録するスキル。USE WHEN: ユーザが「ジャーナルに書いて」「メモしておいて」「dev-journal に追記して」「これ記録して」「あとで見返せるようにして」「バックログに入れて」「後回しにしたい」など、実装中の気づきや先送りタスクの記録を依頼したとき。spec/dev-journal.md を読み書きするときは必ず参照すること。
ponkan-python の Agentic Spec-Driven Development を開始・進行する入口 skill。USE WHEN: ユーザが Agentic SDD、次の Work Unit、spec/initial からの実装、Intent Delta、Subagent auto-orchestration、仕様起点の plan/tasks/implement/gate loop を求めるとき。
作業ブランチを GitHub PR 経由で default branch にマージし、ローカル同期・ブランチ削除まで一括実行するワークフロースキル。USE WHEN: ユーザが「PRを出して」「マージして」「ブランチをまとめて」「mainに入れて」「PRクリーンアップ」「PR後片付け」など、作業ブランチの変更をリモートに反映したい意図を示したとき。
test && commit || revert を隔離 worktree 上で試す実験 workflow skill。USE WHEN: ユーザが明示的に TCR、test && commit || revert、TCR実験、tcr-workflow-exp を求めるとき。通常の TDD workflow では暗黙的に使わない。
| name | tidy-first |
| description | Tidy First の考え方に沿って behavior change と structure change を分離し、構造改善を先に行うか後に行うか判断する skill。USE WHEN: refactor、cleanup、設計整理、実装前の下準備、TDD の green 後の構造変更判断を行うとき。 |
振る舞い変更と構造変更を分け、構造変更をいつ行うか判断する。
| 種別 | 判断基準 | 例 |
|---|---|---|
| Behavior change | 外部から観測できる結果、例外、I/O、USB command sequence、public API が変わる | 新しい frame 変換、device probe の結果変更 |
| Structure change | 観測可能な振る舞いを変えず、内部の読みやすさや変更容易性だけを変える | rename、helper 抽出、定数移動、重複除去 |
cc3dsfs 由来の command 値や sequence を変える作業は、見た目が小さくても behavior change として扱う。
構造変更の前後で、同じ検証コマンドを実行する。
uv run pytest tests/unit -q
uv run ruff check .
uv run ty check --no-progress