← Back to list
reviewing-readability
by thkt
⭐ 3🍴 0📅 Jan 24, 2026
Run in ManusSKILL.md
name: reviewing-readability description: > Code readability review based on "The Art of Readable Code" and Miller's Law (7±2). Triggers: 可読性, 理解しやすい, わかりやすい, 明確, 命名, 変数名, 関数名, ネスト, 深いネスト, 関数設計, コメント, 複雑, 難しい, 難読, Miller's Law, ミラーの法則, 認知負荷, AI-generated, 過剰設計. allowed-tools: [Read, Grep, Glob, Task] agent: readability-reviewer user-invocable: false
可読性レビュー
検出
| ID | パターン | 修正 |
|---|---|---|
| RD1 | processData() (曖昧) | validateUserEmail() |
| RD1 | 誤解を招く識別子 | 意図を示す名前 |
| RD2 | ネスト > 3レベル | ガード句、関数抽出 |
| RD2 | 関数 > 30行 | 分解 |
| RD3 | コメント: // increment i | 削除（自明） |
| RD3 | コメント: // TODO: fix later | Issue作成または今修正 |
| RD4 | 単一実装のインターフェース | 2つ目の実装まで削除 |
| RD4 | ステートレスロジック用クラス | 純粋関数 |
| RD5 | > 5つの関数パラメータ | 設定オブジェクトまたは分解 |
閾値
| 対象 | 推奨 | 最大 |
|---|---|---|
| 関数行数 | ≤30 | 50 |
| ネスト | ≤3 | 4 |
| 関数引数 | ≤3 | 5 |
参考
| トピック | ファイル |
|---|---|
| 制御フロー | references/control-flow.md |
| コメント | references/comments-clarity.md |
| AIアンチパターン | references/ai-antipatterns.md |
| 命名 | references/naming.md |
Score
Total Score
50/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
○LICENSE
ライセンスが設定されている
0/10
○説明文
100文字以上の説明がある
0/10
○人気
GitHub Stars 100以上
0/15
○最近の活動
3ヶ月以内に更新がある
0/10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
○タグ
1つ以上のタグが設定されている
0/5
Reviews
💬
Reviews coming soon