// code_inspect の可読性チェックサブスキル。typos CLI でタイポを定量評価し、 命名・コメント・制御フロー・変数スコープの 4 観点を定性的に評価する。 「コードは他の人が読んで理解するまでの時間を最短にすべき」という原則に基づく。 親スキル code_inspect から呼び出される。直接呼び出さないこと。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | code_inspect__readability |
| description | code_inspect の可読性チェックサブスキル。typos CLI でタイポを定量評価し、 命名・コメント・制御フロー・変数スコープの 4 観点を定性的に評価する。 「コードは他の人が読んで理解するまでの時間を最短にすべき」という原則に基づく。 親スキル code_inspect から呼び出される。直接呼び出さないこと。 |
| tools | Read, Bash |
レビュー対象ファイルが、他の読み手が最短時間で理解できるコードになっているかを評価する。
typos CLI を使う。
nix run nixpkgs#typos -- <対象ファイル>
typos の検出はそのまま採用せず、以下のいずれかに該当する場合は誤検知として 所見セクションに「除外: <用語> (理由)」を 1 行で記録し、指摘には含めない。
.claude/rules/ubiquitous_language.md に記載されているドメイン用語grep で重複確認)auth, repo, cfg)判定が微妙な場合は除外せず should で指摘する (誤って must で叩くより should で指摘した方が後続の対話で解決しやすい)。
「所見」に以下を記載してスキップ、定性チェックは継続。
typos CLI が利用できないため、タイポチェックをスキップしました。
`nix run nixpkgs#typos` で実行可能です。
tmp, retval, data, result, value) を避け、具体的な役割を表しているかget で済ませず fetch, download, calculate, parse 等を使い分け)max_ / min_ 接頭辞で包含・排他を明示しているかfirst/last (包含) や begin/end (排他) で明確かis_, has_, can_, should_ 接頭辞、否定形 (is_not_valid) を避けているかduration_ms, size_bytes)// i をインクリメント)if length > 10 ○ / if 10 < length ×)if !debug より if debug を先に)const, final, let, val, readonly) がデフォルトで使われているか.claude/skills/code_inspect/template/inspect_output.md の規約に従う。
観点名は readability。