本文へ移動
cccskills
無料GitHub で公開

python-style

Use this when creating, editing, or reviewing Python code — including type hints, docstrings, naming conventions, imports, error handling, and code structure.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md1.7 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Skill: Python Style

Use this skill when creating, editing, or reviewing Python code.

Type Hints

  • Add type hints to all public function signatures.
  • Use from __future__ import annotations when convenient.

Docstrings

  • Use Google-style docstrings for all public modules, classes, functions, and methods.
  • Docstrings should describe:
    • Purpose
    • Args
    • Returns
    • Raises (if applicable)
    • Examples (when helpful)
    • Important assumptions

Comments

  • Inline comments and explanatory comments must be written in Japanese.
  • Comments should explain non-obvious intent, assumptions, or business logic.
  • Do not comment obvious syntax.

Code Style

  • Prefer small, pure functions where practical.
  • Prefer explicit error handling over bare except.
  • Use pathlib.Path for file paths — see path-and-io skill.
  • Follow ruff linting and formatting rules configured in pyproject.toml.

Example

import json
from pathlib import Path


def load_config(config_path: Path) -> dict:
    """設定ファイルを読み込んで辞書として返す。

    Args:
        config_path: 設定ファイルのパス。

    Returns:
        設定内容を格納した辞書。

    Raises:
        FileNotFoundError: 指定されたパスにファイルが存在しない場合。
    """
    # JSONファイルを読み込む
    with config_path.open("r", encoding="utf-8") as f:
        return json.load(f)

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use this when summarizing analysis results, writing reports, documenting experiment outcomes, or presenting model evaluation — including structuring findings in Japanese with conclusions, facts, assumptions, interpretations, and caveats.

日本語の概要は準備中です。原文の説明を表示しています。

atsushi-green/ds-ai-coding-skills892026年10月4日 更新

causal-inference-diagnostics

無料日本語概要

因果推論・効果検証(A/B テスト / ABテスト / オンライン実験 / リフト / SRM / CUPED、観察データの処置効果 / ATE / ATT / CATE / 傾向スコア / propensity score / IPW / 二重頑健 / DML / causal forest、準実験 / 差の差 / DiD / イベントスタディ / 操作変数 / IV / 2SLS / 回帰不連続 / RDD / 合成コントロール)を実行したら必ずセットで出す図と値のルーター。 proportions_ztest, chisquare, statsmodels.stats.power, dowhy, econml, causalml, doubleml, propensity, LinearDML, IV2SLS, rdrobust, rddensity, pysyncon, treat*post がコードに現れたとき、またはユーザーが「ABテストの結果を 見て」「施策の効果を推定して」「差の差で」「傾向スコアで揃えて」「閾値前後で比較して」と言ったときに使う。SRM・ バランス・並行トレンド・first-stage に言及がなくても適用する。SKILL.md のルーティング表で設計を特定し、対応する references/<設計>.md を読んでから実行する。実験でない群間比較の検定は statistical-inference-diagnostics、 予測モデルの解釈(SHAP 等)は predictive-modeling-diagnostics を使う。

atsushi-green/ds-ai-coding-skills892026年10月4日 更新

Use this when performing DataFrame operations — including loading, filtering, joining, aggregating, transforming, or reshaping tabular data with polars or pandas.

日本語の概要は準備中です。原文の説明を表示しています。

atsushi-green/ds-ai-coding-skills892026年10月4日 更新

Use this when creating, editing, executing, or reviewing Jupyter notebooks — including cell structure, kernel management, extracting reusable logic to src/, and ensuring notebooks are restartable.

日本語の概要は準備中です。原文の説明を表示しています。

atsushi-green/ds-ai-coding-skills892026年10月4日 更新

Use this when reading from or writing to local files — including constructing file paths with pathlib, creating directories, choosing output locations, and using path utilities from src/analysis_project/paths.py.

日本語の概要は準備中です。原文の説明を表示しています。

atsushi-green/ds-ai-coding-skills892026年10月4日 更新

plan-analysis

無料日本語概要

分析を始める前に構造化された分析計画を作成する

atsushi-green/ds-ai-coding-skills892026年10月4日 更新

atsushi-green のスキルをすべて見る

このスキルの問題を報告する