Check Agent SKILL v1.0.0

技術詳細: 各Stepの詳細手順、検出ルール、依存グラフスキーマ。

役割境界

•この SKILL.md は技術仕様（入出力・判定基準・実装詳細）の正本。
•実行手順は同フォルダの WORKFLOW.md を参照。

📝 Step詳細

Step 1: SCAN 📁

目的: 対象ファイルの収集

code

対象ディレクトリ:
- .agent/workflows/     # ワークフロー定義
- .agent/rules/         # ルール定義（存在すれば）

対象ファイル:
- WORKFLOW.md
- SKILL.md
- *.py（スクリプト）
- *.yaml, *.json（設定）

除外:
- __pycache__/
- *.pyc
- .git/

Step 2: ANALYZE 🔗

目的: 依存グラフ構築

code

依存グラフスキーマ:

Node（ファイル）:
{
  "id": "workflows/check/WORKFLOW.md",
  "type": "workflow",      # workflow | skill | script | config
  "path": "絶対パス",
  "last_modified": "ISO日時"
}

Edge（参照関係）:
{
  "from": "Node ID",
  "to": "Node ID",
  "evidence": "参照元の行内容",
  "confidence": 0.0-1.0,    # 参照確度
  "location": {
    "file": "参照元ファイル",
    "line": 行番号
  }
}

参照検出パターン:

パターン	例	confidence
明示的パス	`./scripts/foo.py`	1.0
相対参照	`SKILL.md`	0.9
import文	`from core import x`	0.8
名前一致	同名ファイル	0.5

Step 3: DETECT 🔍

目的: ルール評価・問題検出

検出ルール一覧

ルールID	カテゴリ	説明	重要度
`orphan_file`	孤立	どのWORKFLOWからも参照されないファイル	LOW
`broken_path`	パス不整合	存在しないパスへの参照	HIGH
`duplicate_def`	重複	同じ機能の重複定義	MEDIUM
`outdated_format`	形式	古いフォーマット（frontmatter欠落等）	LOW
`missing_skill`	欠損	WORKFLOW.mdはあるがSKILL.mdがない	MEDIUM
`empty_workflow`	空	内容がほぼ空のワークフロー	LOW

Finding構造

yaml

finding:
  id: "finding_001"
  rule_id: "broken_path"
  severity: "HIGH"        # HIGH | MEDIUM | LOW
  target:
    file: "対象ファイル"
    line: 行番号
  message: "問題の説明"
  suggestion: "修正案"
  auto_fixable: true      # 自動修正可能か

Step 4: PROPOSE 📋

目的: 問題提案・plan_id発行

code

提案フォーマット:

## 🔍 /check 結果

**plan_id**: `check_20260205_153000`
**検出数**: 3件（HIGH: 1, MEDIUM: 1, LOW: 1）

### 🔴 HIGH: broken_path
- **ファイル**: `.agent/workflows/foo/SKILL.md`
- **行**: 15
- **問題**: `./scripts/bar.py` が存在しない
- **修正案**: パスを修正または参照を削除

### 🟡 MEDIUM: missing_skill
- **ファイル**: `.agent/workflows/baz/`
- **問題**: WORKFLOW.mdはあるがSKILL.mdがない
- **修正案**: SKILL.mdを作成

---
**承認する場合**: 「APPROVE」と入力してください
**修正しない場合**: そのままスキップします

Step 5: APPROVE ✅

目的: ユーザー承認確認

code

承認判定:
- 「APPROVE」→ Step 6へ進む
- 「APPROVE HIGH」→ HIGHのみ修正
- それ以外 → 終了（提案のみ）

Step 6: EXECUTE 🔧

目的: 承認されたfindingsの修正実行

code

実行ルール:
1. auto_fixable: true のfindingのみ自動修正
2. auto_fixable: false は修正案を提示のみ
3. 各修正後にログ出力
4. 全修正完了後にサマリー表示

🛡️ 安全策詳細

•
破壊的操作の禁止
- •ファイル削除は提案のみ、実行しない
- •大規模変更は警告表示
•
ロールバック情報
- •修正前の内容をログに記録
- •必要に応じて手動復元可能
•
スコープ制限
- •.agent/ 配下のみ対象
- •プロジェクトコードには触れない

💡 Rules

•6-Step順次実行
•提案のみで終了可能
•HIGH優先で報告
•破壊的操作は実行しない
•Language: 日本語

ログ記録（WorkflowLogger統合）

[!IMPORTANT] 実行時は必ずWorkflowLoggerで各フェーズをログ記録すること。詳細: WORKFLOW_LOGGING.md

python import sys; sys.path.insert(0, '.agent/workflows/shared') from workflow_logging_hook import logged_main, phase_scope

ログ保存先: _logs/autonomy/{agent}/{YYYYMMDD}/