static-analysis
支持静态代码分析、质量指标设置、复杂度评估和代码异味检测的技能。一贯地整理从制定质量标准到改善优先级排序的过程。锚点:• 《代码整洁》 / 适用:质量标准 / 目标:判断代码质量• 《代码完整》 / 适用:复杂度管理 / 目标:降低认知负荷触发:在配置静态分析、定义质量门、测量复杂度或处理代码异味时使用。
📖 中文导读:支持静态代码分析、质量指标设置、复杂度评估和代码异味检测的技能。一贯地整理从制定质量标准到改善优先级排序的过程。锚点:• 《代码整洁》 / 适用:质量标准 / 目标:判断代码质量• 《代码完整》 / 适用:复杂度管理 / 目标:降低认知负荷触发:在配置静态分析、定义质量门、测量复杂度或处理代码异味时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: static-analysis description: | 静的コード解析と品質メトリクスの設定、複雑度評価、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 allowed-tools: - Bash - Read - Write - Edit - Glob - Grep
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 |
厳格メトリクス定義 |