Menu
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 を求めるとき。
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 を読み書きするときは必ず参照すること。
作業ブランチを 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 では暗黙的に使わない。
TDD Test List の 1 項目だけを red/green/refactor で実行する skill。USE WHEN: 失敗するテストを 1 つ書き、最小実装で通し、必要なら green 後にリファクタリングする TDD サイクルを回すとき。
| name | agentic-sdd |
| description | 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 を求めるとき。 |
AGENTS.md、spec/initial/*、作業仕様を Constitution として読み、次の Work Unit を 1つだけ選んで Plan、Tasks、実装、Gate 報告へ進める。
ユーザが毎回ドメイン背景を説明し直さず、Intent Delta と Risk Approval だけを渡せる workflow にする。
AGENTS.md と spec/initial/* を読む。spec/wip/local_* または spec/complete/local_* がある場合は読む。git status --short を確認する。none とする。開始時は次を短く提示する。
Agentic SDD bootstrap:
- Constitution: AGENTS.md, spec/initial/*
- Git Context: <branch>, <clean | dirty>, <normal branch | isolated worktree | read-only>
- Intent Delta: none | <summary>
- Selected Work Unit: <Step or TDD item>
- Non-goals: <Step outside scope>
- Gates: <commands and manual gates>
- Subagents: auto | none | <sidecar list>
| 候補 | 選択条件 |
|---|---|
spec/initial Step | MVP workflow の既定順に沿う作業。 |
| 作業仕様の TDD item | Step 内の小さい振る舞いを扱う作業。 |
| Source audit item | cc3dsfs 由来の値、command、構造体サイズが未確認。 |
| Hardware-gated item | 実機 new 3DS XL が必要。 |
cc3dsfs-source-audit を使う。n3dsxl-hardware-harness を使う。変更を伴う Work Unit では、Plan 前に git context を確認する。
| 状態 | 扱い |
|---|---|
| read-only 調査 | branch 作成は不要。 |
| 作業ブランチ上で clean | そのまま進める。 |
| default branch 上で clean | 作業内容に応じた branch を作るか、既存作業ブランチへ切り替える。 |
| dirty worktree | 既存変更を読んで、ユーザ変更を破棄せず作業可否を判断する。 |
| TCR 明示 | tcr-workflow-exp の隔離 worktree を使う。 |
通常の TDD / Agentic SDD は隔離 worktree を要求しない。隔離 worktree は TCR の失敗時 revert 境界としてだけ使う。 変更を伴う Work Unit は project の GitHub Flow に従い、短命な作業ブランチから PR 経由で default branch に取り込む。
Plan には次を含める。
- selected Work Unit
- git context
- Intent Delta
- implementation scope
- non-goals
- affected files
- hardware requirement
- verification commands
- source audit requirement
Task Graph は次に分類する。
| 分類 | 扱い |
|---|---|
| Blocking local task | Main Agent が実行する。 |
| Sidecar task | ユーザが Subagent 利用を許可している場合、必要に応じて起動する。 |
| Hardware task | Main Agent が人間承認後に扱う。 |
tdd-workflow、tdd-test-list、tdd-one-cycle を使う。tidy-first で分ける。Work Unit 終了時は agentic-self-review を使い、実行した gate、未実行 gate、source/hardware 状態、Subagent 指摘の採否、次候補を報告する。