sh0d0wn007/yomitoki

記録された最新のソース活動: 2026年10月27日 15:35

SkillsMP カタログ更新: 2026年10月29日 18:30

収集済み skills: 1

GitHub スター: 1
GitHub フォーク: 0

AI アシスタントでインストール

このプロンプトをコピーして、使用中の AI アシスタントに送ってください。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/sh0d0wn007/yomitoki.

リポジトリの README

README の元ファイル：README.md

README の元ファイルを読む

README 全文を表示

<img src="assets/logo.svg" alt="yomitoki" width="560"> 🇯🇵 日本語 | <a href="README.zh-CN.md">🇨🇳 简体中文</a> | <a href="README.en.md">🇺🇸 English</a> # yomitoki コードの理解にかかる時間を減らすための、AIエージェント向けスキルです。[Agent Skills](https://agentskills.io/) 形式の `SKILL.md` で書かれており、Claude Code・Codex・Gemini CLI・Cursor・GitHub Copilot などの対応エージェントで使えます。命名・制御フロー・変数・責務・コメント・テストの見直しに加え、Python・C・C++・Java・JavaScript・TypeScriptの機械検査と修正前後の比較を行います。 **紹介動画：実コードで見る改善前後** https://github.com/user-attachments/assets/1c9d27cf-d481-47d6-bb6b-0ae146cda7e0 ペリカンのアニメーションを題材に、描画順と詳細の分離、命名の変更を実コードで比較します。関数数・コード行数の変化と、検証できた範囲も紹介しています。 - `scripts/check.py`：関数の行数・引数数・ネスト・複雑さ・入れ子の三項式を検査（Python・C・C++・Java・JavaScript・TypeScript） - `scripts/run_checks.py`：構文指標と、PythonのRuff lint・整形を一括検査 - `scripts/compare_reports.py`：検査条件・対象範囲・指摘数・指標の変化を比較 - `scripts/diff_code.py`：変更前後のPythonソースから構造の変化と確認位置を抽出 - `scripts/review_session.py`：`begin` で現在のソースの退避と変更前検査、`finish` で変更後検査・比較・差分保存をまとめる（対象コードは変更・実行しない）退避先は `begin --state-root /path/outside/reviews` で対象外の親ディレクトリを渡すと、一意な子保存先が作成されます。既存の作業用親も使え、返された `stateDir` を `finish --state-dir` に渡せます。固定名の未作成パスには従来の `begin --state-dir` も使えます。PowerShellの初回からのUTF-8設定は [実行例](references/review-session.md) を参照してください。作業は「文脈と契約の確認 → 変更前の保存・機械検査 → 小さな修正 → 数値とソース差分の点検 → テスト」の順に進めます。コードはレビューでも修正でも [判断基準](references/principles.md) の14項目すべてに照らして確認し、指摘と変更には該当する項目の番号を付けて報告します。差分検査の使い方は [変更内容の点検](references/change-review.md) を参照してください。退避と前後検査をまとめる方法は [一括検査と比較](references/review-session.md) を参照してください。判断基準や検証範囲を保ち、同じ検査の表示し直しや変更のない状態での再検査を減らします。補助処理はプロジェクトのテスト・lint・型チェック・ビルドを実行しません。小さな対象では `begin --context` で全ソースと判断基準を一緒に読み、`finish --include-diffs` で全差分を一緒に受け取れます。14項目は個別に根拠を記録し、`--review-notes` で欠けた項目や未確認を検出します。記録の網羅性は判断の正しさを保証しません。 ## 対応言語 | 対象 | 付属スクリプト | 併用する導入済みツール | | --- | --- | --- | | Python | 構文指標・Ruff lint・整形 | プロジェクト既存のlint・型チェック | | C・C++ | 構文指標 | clang-tidy・Cppcheck | | Java | 構文指標 | PMD・Checkstyle | | JavaScript・TypeScript | 構文指標 | ESLint・Biome・Oxlint・tsc | | HTML・CSS | なし | HTML-validate・Stylelint | 構文指標（関数の行数・引数数・ネスト・複雑さ・入れ子の三項演算子）は、Pythonでは標準ライブラリの`ast`、その他の言語では [tree-sitter](https://tree-sitter.github.io/) の構文木から同じ定義で測ります。Ruffに当たるlint・整形は、Python以外では対象プロジェクトの導入済みツールで検査します。付属スクリプトはこれらのツールを導入・実行しません。選び方・実行例・変更前後の比較は [言語別の機械検査](references/language-checks.md) を参照してください。 ## セットアップ ### npxでインストール npm（npx）と、Node.js **24系の24.22.1以降（推奨）** または **22系の22.23.4以降** を使用してください。各メジャーバージョンの最新パッチ版を選びます。これらは [2026年10月21日のセキュリティリリース](https://nodejs.org/en/blog/vulnerability/october-2026-security-releases) の修正を含むバージョンです（2026年10月25日確認）。利用するプロジェクトのルートで実行します。 ```bash npx skills add Sh0D0wn007/yomitoki --skill yomitoki ``` 画面の案内に従って利用するエージェントを選びます。標準ではプロジェクト単位でインストールされます。全プロジェクトで使う場合は `--global` を付けます。例えば、CodexとClaude Codeの両方で使う場合： ```bash npx skills add Sh0D0wn007/yomitoki --skill yomitoki --global --agent codex claude-code ``` この方法では配置とリンクの作成をCLIが行うため、手動配置は不要です。Pythonの検査用依存パッケージは別途、後述の手順で導入します。詳しくは [skills CLIの公式ドキュメント](https://github.com/vercel-labs/skills/blob/main/docs/commands.md) を参照してください。 ### 手動で配置する場合このリポジトリを、使うエージェントのスキル用ディレクトリへ `yomitoki` という名前で配置します。`~/.agents/skills/` は複数のエージェントが共通で読み込むため、ここに置けば1か所で共有できます。 | エージェント | ユーザー全体 | プロジェクト単位 | | --- | --- | --- | | Codex・Gemini CLI・Cursor・GitHub Copilot | `~/.agents/skills/yomitoki` | `.agents/skills/yomitoki` | | Claude Code | `~/.claude/skills/yomitoki` | `.claude/skills/yomitoki` | | Antigravity App・IDE | `~/.gemini/config/skills/yomitoki` | `.agents/skills/yomitoki` | | Antigravity CLI | `~/.gemini/antigravity-cli/skills/yomitoki` | `.agents/skills/yomitoki` | Claude Code と併用する場合は、`~/.agents/skills` に置いた実体へのシンボリックリンクを作ると、更新が両方に反映されます。 ```bash mkdir -p ~/.claude/skills ln -s ~/.agents/skills/yomitoki ~/.claude/skills/yomitoki ``` Antigravity と併用する場合は、`~/.agents/skills` を [公式資料](https://www.antigravity.google/docs/skills) に記載された各製品の配置先にリンクすると、`npx skills add -g` などの更新を共有できます。App・IDE と CLI では配置先が異なるため、以下のリンク作成は利用する製品のものだけ実行します。既存の配置やリンクがある場合は、内容を確認・退避してから移行します。Windows では管理者権限不要で動作するジャンクション（Junction）を使えます。 App・IDE と CLI はそれぞれ別のコードブロックです。利用する製品のブロックだけを実行してください。 macOS・Linux： App / IDE: ```bash mkdir -p ~/.gemini/config (if [ -e ~/.gemini/config/skills ] || [ -L ~/.gemini/config/skills ]; then if [ -e ~/.gemini/config/skills.bak ] || [ -L ~/.gemini/config/skills.bak ]; then echo "退避先が既に存在するため中止します: ~/.gemini/config/skills.bak" >&2 exit 1 fi mv ~/.gemini/config/skills ~/.gemini/config/skills.bak || exit 1 fi ln -s ~/.agents/skills ~/.gemini/config/skills) ``` CLI: ```bash mkdir -p ~/.gemini/antigravity-cli (if [ -e ~/.gemini/antigravity-cli/skills ] || [ -L ~/.gemini/antigravity-cli/skills ]; then if [ -e ~/.gemini/antigravity-cli/skills.bak ] || [ -L ~/.gemini/antigravity-cli/skills.bak ]; then echo "退避先が既に存在するため中止します: ~/.gemini/antigravity-cli/skills.bak" >&2 exit 1 fi mv ~/.gemini/antigravity-cli/skills ~/.gemini/antigravity-cli/skills.bak || exit 1 fi ln -s ~/.agents/skills ~/.gemini/antigravity-cli/skills) ``` Windows（PowerShell）： App / IDE: ```powershell New-Item -ItemType Directory -Force -Path "$HOME\.gemini\config" | Out-Null $link = "$HOME\.gemini\config\skills" if (Test-Path -LiteralPath $link) { if (Test-Path -LiteralPath "$link.bak") { throw "退避先が既に存在するため中止します: $link.bak" } Move-Item -LiteralPath $link -Destination "$link.bak" -ErrorAction Stop } New-Item -ItemType Junction -Path $link -Target "$HOME\.agents\skills" ``` CLI: ```powershell New-Item -ItemType Directory -Force -Path "$HOME\.gemini\antigravity-cli" | Out-Null $link = "$HOME\.gemini\antigravity-cli\skills" if (Test-Path -LiteralPath $link) { if (Test-Path -LiteralPath "$link.bak") { throw "退避先が既に存在するため中止します: $link.bak" } Move-Item -LiteralPath $link -Destination "$link.bak" -ErrorAction Stop } New-Item -ItemType Junction -Path $link -Target "$HOME\.agents\skills" ``` 上記以外の [Agent Skills 対応エージェント](https://agentskills.io/) では、各ドキュメントに記載されたスキルの配置先に置きます。既存のスキルがある場合は内容を確認し、バックアップしてから移行してください。スキルの指示は [SKILL.md](SKILL.md) にあります。`agents/openai.yaml` は Codex の画面表示用の任意設定です。 ### 付属の検査を使う場合 Python 3.10以上を使用してください。Python以外の構文解析に使うtree-sitterはPython 3.10以上が必要です。Python 3.9ではPythonファイルだけを検査できます。Pythonを検査する場合は、対象コードの構文に対応したPythonを使用してください。仮想環境は移動すると動かなくなるため、配置した後のディレクトリで作成します。以下はプロジェクト単位でインストールした場合の例です。ユーザー全体にインストールした場合は `~/.agents/skills/yomitoki`、手動配置した場合はその配置先へ移動してください。 macOSに標準で入っている`python3`（Xcodeのコマンドラインツール付属）は3.9のことがあります。`python3 --version`で確認し、3.9なら3.10以上のPython（例：Homebrewの`python3.12`）で仮想環境を作ります。3.9で作ると、tree-sitterが導入されず、Python以外のファイルが検査エラーになります。 macOS・Linux： ```bash cd .agents/skills/yomitoki python3 --version python3 -m venv .venv .venv/bin/python -m pip install -r requirements.txt ``` Windows（PowerShell）： ```powershell cd .agents\skills\yomitoki python --version python -m venv .venv .venv\Scripts\python.exe -m pip install -r requirements.txt ``` Windowsでは、以降のコマンドの`python3`を`python`に、`.venv/bin/`を`.venv\Scripts\`（Git Bashでは`.venv/Scripts/`）に読み替えます。 ## 実行リポジトリのルートで、セットアップした`.venv`のPythonを使って実行します。 ```bash .venv/bin/python scripts/run_checks.py --json /path/to/project > before.json # 対象コードを修正した後、同じ条件で再検査 .venv/bin/python scripts/run_checks.py --json /path/to/project > after.json .venv/bin/python scripts/compare_reports.py before.json after.json ``` PowerShellで`>`を使って保存するときは、先に`[Console]::OutputEncoding = [System.Text.Encoding]::UTF8`を実行します。Windows PowerShell 5.1では、実行しないと日本語を含む出力が壊れ、比較できません。検査は指摘ありで終了コード`1`、実行失敗で`2`を返します。比較は条件不一致も`2`です。詳しい設定、比較方法、終了コードは [一括検査と前後比較](references/workflow-checks.md) を参照してください。 Pythonファイルの構文指標だけを、追加パッケージなしで検査する場合： ```bash python3 scripts/check.py /path/to/project ``` 閾値は見直し候補を抽出するための初期設定です。指摘なしでも、命名の適切さや挙動の同一性を保証しません。[判断基準](references/principles.md) と [指標の定義](references/mechanical-checks.md) を併せて確認してください。 ## 検証 macOS・Linux： ```bash YOMITOKI_RUFF="$PWD/.venv/bin/ruff" .venv/bin/python -B -m unittest discover -s tests -v .venv/bin/ruff check --isolated --no-cache --select E9,F scripts tests ``` Windows（PowerShell）： ```powershell $env:YOMITOKI_RUFF = "$PWD\.venv\Scripts\ruff.exe" .venv\Scripts\python.exe -B -m unittest discover -s tests -v .venv\Scripts\ruff.exe check --isolated --no-cache --select E9,F scripts tests ``` CIの通常検証は、Ubuntu・Windows・macOSでPython 3.10・3.11・3.12を対象にします。Python 3.9はPython専用検査の互換性確認としてUbuntuで検証し、`match`構文とtree-sitterを使う他言語のテストをスキップします。新規の導入にはPython 3.10以上を使用してください。 Python 3.10以上で`requirements.txt`を導入した場合は、tree-sitter未導入時のテストをスキップします。環境によってはシンボリックリンクのテストもスキップします。 `scripts/`自体は付属検査の既定の閾値と整形設定に合わせていないため、`run_checks.py scripts tests`は指摘を返します。

リポジトリの README を読み込んでいます…

投稿

すべて見る →

Sho | AI × GPU

@sh0d0wn0072026年10月27日 12:17 UTC

Skill公開の投稿コードと PR をレビュー

投稿の要約 · 英語

Reviews naming, control flow, and responsibility in AI-written code, then suggests small readable refactors that keep behavior.

元の投稿

Skill の詳細を見る · yomitoki/skill

このリポジトリの skills

分類待ち

skill

職業分類

説明

更新

yomitoki

未分類

コードの理解にかかる時間を減らすため、命名・条件式・制御フロー・変数・責務・コメント・テストを見直す。「コードを読みやすく」「可読性を改善」「コードを綺麗に」と頼まれたときに使う。Python・C・C++・Java・JavaScript・TypeScriptは付属スクリプトで構文指標を測り、lint・整形やHTML・CSSは言語別ツールで機械検査する。レビューでは改善案を示し、修正依頼では既存の挙動を保つ小さなリファクタリングを行う。

2026-10-27

収集済み skill 1 件中 1 件を表示しています。