菜单
Tidy First の考え方に沿って behavior change と structure change を分離し、構造改善を先に行うか後に行うか判断する skill。USE WHEN: refactor、cleanup、設計整理、実装前の下準備、TDD の green 後の構造変更判断を行うとき。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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