跳到正文
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(原文)

安装前可以查看交给 AI 代理的指令内容。

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)

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

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-skills912026年10月4日 更新

因果推論・効果検証(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-skills912026年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-skills912026年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-skills912026年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-skills912026年10月4日 更新

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

中文简介正在准备中。当前显示原文说明。

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

查看 atsushi-green 的全部技能

报告此技能的问题