Agent skill
static-analysis
静的コード解析と品質メトリクスの設定、複雑度評価、Code Smell検出を支援するスキル。 品質基準の策定から改善優先度付けまでを一貫して整理する。 Anchors: • Clean Code / 適用: 品質基準 / 目的: コード品質の判定 • Code Complete / 適用: 複雑度管理 / 目的: 認知負荷の低減 Trigger: Use when configuring static analysis, defining quality gates, measuring complexity, or triaging code smells. static analysis, complexity metrics, code smells, quality gate
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/static-analysis
SKILL.md
static-analysis
概要
静的解析の対象範囲と指標を定義し、解析結果を改善優先度へ落とし込む。
ワークフロー
Phase 1: 対象範囲と指標の決定
目的: 解析対象と閾値を確定する
アクション:
references/Level1_basics.mdで基礎指針を確認するreferences/threshold-guidelines.mdで閾値を決める- 解析対象の範囲と除外条件を整理する
Task: agents/sa-001-metric-scope.md を参照
Phase 2: 解析実行と検出
目的: メトリクス測定とCode Smell検出を実行する
アクション:
scripts/analyze-complexity.mjsを実行するreferences/complexity-metrics.mdを参照し指標を解釈するreferences/code-smells.mdでSmellを分類する
Task: agents/sa-002-run-analysis.md を参照
Phase 3: トリアージと改善計画
目的: 改善優先度と対応方針を整理する
アクション:
references/Level2_intermediate.mdとreferences/Level3_advanced.mdを参照する- 影響範囲と修正コストを評価する
- 改善計画を作成する
Task: agents/sa-003-triage-findings.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| sa-001-metric-scope | Phase 1開始時 | 対象コード情報、品質目標 | 指標設定表 |
| sa-002-run-analysis | Phase 2開始時 | 指標設定表、対象コード | 解析結果一覧 |
| sa-003-triage-findings | Phase 3開始時 | 解析結果一覧、チーム制約 | 改善優先度表 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
注記: Task名は目的に合わせて定義する
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| 閾値の根拠を明文化する | 合意形成と運用が安定する |
| 言語特性を考慮する | 不適切な一律基準を避けられる |
| 結果をカテゴリで整理する | 改善の優先度が明確になる |
| 定期的に再計測する | 技術的債務の再発を防ぐ |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| 根拠のない閾値設定 | 評価基準がぶれる |
| 解析結果の放置 | 技術的債務が蓄積する |
| 目的外の解析拡張 | ノイズが増え優先度が下がる |
| 修正計画の不在 | 実行に移せなくなる |
リソース参照
scripts/（決定論的処理）
| スクリプト | 機能 |
|---|---|
scripts/analyze-complexity.mjs |
複雑度分析の実行 |
scripts/validate-skill.mjs |
スキル構造の検証 |
scripts/log_usage.mjs |
使用記録の保存 |
references/（詳細知識）
| リソース | パス | 読込条件 |
|---|---|---|
| 基礎指針 | references/Level1_basics.md | 導入時 |
| 実務指針 | references/Level2_intermediate.md | 実務適用時 |
| 応用指針 | references/Level3_advanced.md | CI/CD統合時 |
| 専門指針 | references/Level4_expert.md | 高度な調整時 |
| Code Smell | references/code-smells.md | Smell分類時 |
| 複雑度指標 | references/complexity-metrics.md | メトリクス解釈時 |
| 閾値ガイド | references/threshold-guidelines.md | 閾値設定時 |
assets/（テンプレート・素材）
| アセット | 用途 |
|---|---|
assets/basic-metrics.json |
基本メトリクス定義 |
assets/strict-metrics.json |
厳格メトリクス定義 |
Didn't find tool you were looking for?