Skills · Claude Code · Agent Skills

Python はツールであり、新しいサービスではない。交渉の余地はありません。

データ/ML、自動化、ツール類における Python の最低基準です。ロックファイル付きの uv、マージを止める ruff と mypy --strict、実行時に検証される境界、基本的なセキュリティを求めます。新しい API やサービスは承認済みの言語で作ります。

v0.4.0Disciplina · Python como ferramentagithub.com/schematizeme/skill-python

メンテナー Lucas Andrade

schematize-python · v0.4.0bash
$ schematize install python
GitHub →スキル (.zip) をダウンロード/python-help · github.com/schematizeme/schematize-cli

譲れない最低基準

「速くするため」に外すことはありません。完全な一覧はスキル内にあります。

ツールであり新規バックエンドではない

新しい API やサービスは承認済みの言語で作ります。例外のモデル提供も、業務ロジックを持たない薄いサービスに限ります。

uv.lock をコミットした uv

CI では uv sync --frozen を使います。ロックがないと推移的依存が勝手に変わり、「手元では動く」が文字通りになります。

ruff と mypy --strict がマージを止める

フォーマッタは一つだけ。noqa は必ずコードと理由を添えます。新規コードは厳格な型付けとし、境界は pydantic で実行時に検証します。

危険な実行の禁止

外部データへの pickle、入力への eval/exec、SafeLoader なしの yaml.load、shell=True の subprocess、検証としての assert は禁止です。

ネットワークはタイムアウト、セキュリティは secrets

すべてのネットワーク呼び出しに明示的なタイムアウトを設定し、セキュリティ関連には random ではなく secrets モジュールを使います。

ノートブックは成果物ではない

出力、実データ、認証情報なしで渡します。製品になるときは、テストと型を備えた src/ のモジュールにします。

コマンド

.claude/commands/ にインストールされます。いつでも /python-help を実行できます。

/python-ccコンテキスト圧縮:ハンドオフ(コンテキスト+チェックリスト)をアーカイブに書き出し、/compact を実行します。
/python-claudeschematize-python の常時有効な CLAUDE.md をリポジトリ直下に作成またはマージします。他スキルのブロックは上書きしません。
/python-handoff圧縮せずにコンテキストのハンドオフをアーカイブに書き出します。セッション終了やタスク切り替え時に使います。
/python-helpスキルの全コマンドを一覧表示します。
/python-loadschematize-python の規範本体をすべて強制ロードし、セッション中適用します。
/python-review.py/.ipynb を基準に照らしてレビューします。ゲートと ruff を実行し、機械が読めない点を読みます。

AIエージェント向け

人手を介さずにインストールできます。メタデータは llms.txt にあります。

  • 実行:git clone https://github.com/schematizeme/skill-python.git && ./skill-python/install.sh
  • または https://github.com/schematizeme/skill-python/releases/latest/download/skill-python.zip をダウンロードして .claude/skills/ に展開します。
  • assets/CLAUDE.md をリポジトリ直下にコピーします(常時有効ルール)。
  • /python-help で確認します。

インストールしたくない?

完全な規約を読み、そのままプロジェクトにコピーできます。あるいはスキルをインストールすれば、エージェントが自動で適用します。