メニュー
Alt の Python 3.14+ 規約を適用する。型ヒント必須と Pyrefly、具体例外と原因チェーン、Pydantic/frozen dataclass の境界保護、asyncio と同期推論の分離、spawn プロセスプール、起動時 fail-closed を扱う。Python のコードを書く・直す・レビューするときに使う。ユーザが「Python」や規約名に触れなくても、Python サービス（news-creator, tag-generator, metrics, recap-subworker, recap-evaluator, acolyte-orchestrator）の実装・修正に入るなら使う。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Drive Alt changes test-first in outside-in order — E2E (Playwright/Hurl) → CDC (Pact) → Unit (RED-GREEN-REFACTOR) — and close with a local CI parity sweep (format/lint/type/security) for every touched microservice. Use when implementing a feature, fixing a bug, or refactoring, when deciding what test to write first, or when the user says "TDDで". Also use before declaring work complete, since "tests pass" is not "CI will pass".
Alt の Architecture Decision Record を日本語で `docs/ADR/NNNNNN.md` に書き起こす。番号採番、frontmatter（title/date/status/tags/affected_services/aliases/supersedes）、Context・Decision・Consequences の書き分け、wikilink 形式、OSS 公開向けの情報衛生を扱う。実装が一段落して決定を記録するときに使う。ユーザが「ADR書いて」「ADRにまとめて」「ADRに記録して」「実装が終わったのでドキュメントに」と言ったとき、または設計上の判断を伴う変更を終えたときに使う。
Interrogate a plan against the project's documented decisions and domain language — challenging fuzzy terms, cross-referencing the code, and surfacing where the plan contradicts an existing ADR or canonical contract. Use when the user wants a plan stress-tested against what the project has already decided, rather than in the abstract. Prefer plain grill-me when there is no documented model to test against, and plan-context-loader when the goal is to gather vault context rather than be questioned.
Hunt for deepening opportunities — shallow modules whose interface costs as much to learn as their implementation saves — and present them as a visual before/after report, informed by the decisions already recorded in docs/ADR/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, reduce the cost of understanding a subsystem, or make code more testable. Use clean-architecture instead when the question is whether a specific change violates Alt's layer rules.
設計・計画タスク時に、Obsidian vault から関連 ADR・contract・review・runbook を 必要最小限だけ集めて計画の精度を上げる。 次のときに使う: - 「計画を立てて」「設計して」「プランを作って」 - ADR や過去の決定を確認したい - Knowledge Trail / Knowledge Home や reproject-safe / immutable 設計が絡む
Alt の Go 規約を適用する。エラーラップ、context 第一引数、slog、テーブル駆動テスト、http.Server の 4 タイムアウト、Redis Streams の XACK/XAUTOCLAIM 対、fail-fast 設定を扱う。Go のコードを書く・直す・レビューするときに使う。ユーザが「Go」や規約名に触れなくても、Go サービス（alt-backend, auth-hub, pre-processor, search-indexer, mq-hub, rag-orchestrator, altctl）の実装・修正に入るなら使う。
| name | bp-python |
| description | Alt の Python 3.14+ 規約を適用する。型ヒント必須と Pyrefly、具体例外と原因チェーン、Pydantic/frozen dataclass の境界保護、asyncio と同期推論の分離、spawn プロセスプール、起動時 fail-closed を扱う。Python のコードを書く・直す・レビューするときに使う。ユーザが「Python」や規約名に触れなくても、Python サービス（news-creator, tag-generator, metrics, recap-subworker, recap-evaluator, acolyte-orchestrator）の実装・修正に入るなら使う。 |
| paths | ["**/*.py"] |
以下はタスク全体を通じて有効な規約であり、一度読んで終わる手順ではない。Python コードを書くたびに適用する。
詳細な根拠とコード例が必要になった時点で docs/best_practices/python.md の該当セクションだけを Read する
（全 13 セクション・444 行あるため全文読み込みはしない）。
Any は境界最小限。uv run pyrefly check . 通過必須（mypy は ADR-000530 により非推奨）except: / except Exception: 禁止。raise DomainError("action") from err で原因チェーン保持E,W,F,B,UP,SIM,N,I,ANN,S,PTH,C4,BLE,ASYNC,TRY,RUF,PL。手動スタイル議論禁止@dataclass(frozen=True, slots=True)。生 dict を引き回さないwith / async with で確実に close。async 並行は asyncio.TaskGroup / async with。裸 open() 禁止APIRouter() はテスト分離を壊す → importlib.reload() で毎テスト再構築async def 内の同期 ML 推論・psutil はループ全停止。anyio.to_thread.run_sync + CapacityLimiter、持続的 CPU-bound は process pool / 専用 worker.claude/rules/di-wiring.md）.python-version + CI parity。3.14 構文は 3.11 ツールチェーンで解析不能finally は実行保証なし（PEP 525）→ contextlib.aclosing で包む。セマフォは slot_id / home_pool の所有権追跡 + release パス invariant + CancelledError ハンドラで取得済みリソースを棚卸し（ADR-000243, ADR-000606, ADR-000612）.get() の無症状ハング → timeout 必須（ADR-000048, ADR-000550）@model_validator で起動時検証して即 exit。存在チェックは Path.exists() でなく is_file()（空ディレクトリで素通りする）（ADR-000825, PM-2026-036）完全なベストプラクティスは docs/best_practices/python.md を参照。
セクション: Project Structure, Type Hints & Static Analysis, Error Handling, Clean Architecture, Pydantic & Dataclass, Async Patterns, Resource Management, Logging, Testing, Tooling, Security, ML Runtime & Process Pools