菜单
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 を求めるとき。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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 指摘の採否、次候補を報告する。
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 サイクルを回すとき。