dotfiles

Scaffold and structure a new Python data/ML project the way this developer does — standard repo layout, the canonical pyproject.toml/ruff/ty/pre-commit setup, config & CLI architecture (Hydra vs argparse+pydantic), data-modeling and logging choices, and CLAUDE.md/README conventions. Use when starting a new Python project, setting up its toolchain/config, or aligning an existing repo to these conventions. Ships ready-to-use templates. For general Python style (type hints, docstrings, paths, lint/test commands) defer to the docs under ~/.config/claude/docs/.

この dotfiles リポジトリの test-linux CI(Linuxbrew を非標準 HOMEBREW_PREFIX に入れ、全部ソースビルドする Docker ベースのジョブ)が失敗したときのデバッグ手法。速い再現ループの作り方・ログの読み方・失敗の分類・使えるレバー(Homebrew の env/フラグ)をまとめた汎用プレイブック。既知の個別事例(openssl@3 の TLS 崩壊など)は一例として収録するが、起き得るエラーは多様なので方法論を優先する。ユーザーが「test-linux を直して」「brew/homebrew の CI が落ちる/ハング/タイムアウト」「test workflow を修正」等と言ったときに使う。ローカルの Docker で最小限検証した後、実環境の GitHub Actions で最小再現するのが要点。

arXiv論文の本文をローカルにダウンロードする。arxiv IDまたは論文タイトルを受け取り、HTML版(優先)→ar5iv→PDFのフォールバックで取得。レート制限(10秒/回)とキャッシュ付き。ユーザーが「arxivから論文をダウンロードして」「arxiv-download」「論文の本文を取得して」「<arxiv_id>をダウンロード」などと言ったときに使う。

日本語の技術文書・書籍原稿の文章規範。整形（一文一行、引用ブロック、脚注、コラム記法）、段落と論証の構成（パラグラフライティング）、論証の厳密さ（ツッコミどころの除去）、読み手の負荷の管理、視点と語り、演出の抑制、LLM っぽい空句の禁止、冗長の排除を定める。日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。