← Back to list

tdd-python-drafting
by masa-codehub
⭐ 0🍴 0📅 Jan 23, 2026
SKILL.md
name: tdd-python-drafting description: Replaces the creation of test code based on specifications and the minimal implementation to pass them (Red/Green) in Python projects. Typical use cases: (1) Creating failing tests (Red) based on API or logic specifications, (2) Implementing Python UseCase or Domain Logic layers to pass tests (Green), (3) Constructing pure unit tests isolated from external dependencies using unittest.mock, etc.
TDD Drafting (Python)
詳細仕様書(Spec)と共通実装計画(Plan)に基づき、PythonプロジェクトにおいてTDDのRed/Greenサイクルを実行して機能を実装するスキル。
「機能するPythonコード(Working Code)」を作ることに集中し、品質向上(Refactoring)は tdd-python-refactoring に委譲する。
役割 (Role)
あなたは Python TDD Implementer です。 仕様書をテストケースに変換し、そのテストを通すための最小限の Python 実装(Minimum Viable Implementation)を行います。
手順 (Procedure)
0. 準備 (Preparation)
実装計画(docs/implementation/plans/*.md)を確認し、以下を把握する。
- Layer Structure: コードを配置すべきパッケージ/モジュール。
- Mocking Strategy:
unittest.mockやpytest-mockの使用方針。 - Type Definitions: 使用すべき共通型 (
typing,pydantic等)。
1. Red Phase (Test First)
仕様書(docs/specs/*.md)の要件を満たすテストコードを作成する。
- Action:
tests/配下に適切なテストファイルを作成/更新する。- 正常系(Happy Path) と 異常系(Error Path/Edge Cases) のテストケースを記述する。
- 検証:
python-verificationを実行し、期待通りに失敗(Red) することを確認する。activate_skill{name: "python-verification"}
2. Green Phase (Implementation)
テストをパスさせるための最小限のプロダクトコード(UseCase, Domain Logic)を実装する。
- Action:
src/配下にプロダクトコードファイルを作成/更新する。- 型ヒント(Type Hints) を必須とし、ロジックを実装する。
- 検証:
python-verificationを実行し、全てパス(Green) することを確認する。activate_skill{name: "python-verification"}
3. リファクタリング連携 (Refactoring Connection)
Green状態になった直後、必ず tdd-python-refactoring を呼び出し、Pythonコードとしての品質を高める。
- Action:
activate_skill{name: "tdd-python-refactoring"}を実行する。
4. 監査と納品 (Audit & Delivery)
実装とリファクタリングが完了したら、成果物を監査して納品する。
- Action:
- Full Audit:
- 品質検証:
activate_skill{name: "python-verification"}(Ruff, Mypy, Pytest) - SSOTチェック:
activate_skill{name: "ssot-verification"}(仕様との整合性確認)
- 品質検証:
- Commit & PR:
activate_skill{name: "github-commit"}activate_skill{name: "github-pull-request"}
- Full Audit:
アウトプット (Output)
- 仕様を満たし、テストがパスする Python コード。
tdd-python-refactoringによって洗練され、python-verificationを通過した状態であること。
Score
Total Score
60/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
✓LICENSE
ライセンスが設定されている
+10
○説明文
100文字以上の説明がある
0/10
○人気
GitHub Stars 100以上
0/15
○最近の活動
3ヶ月以内に更新がある
0/10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
○タグ
1つ以上のタグが設定されている
0/5
Reviews
💬
Reviews coming soon