| name | health-check |
| description | ドキュメントと実装の整合性を定期検査する。ユーザーが「ヘルスチェック」「整合性チェック」「/health-check」と言ったとき、またはサイクル完了後の点検を頼まれたときに使う。検出のみで修正はしない(報告のみ)。 |
| disable-model-invocation | true |
ドキュメント整合検査(報告のみ)
ドキュメント・スキル・CI と実装の乖離を検出して報告する。
絶対条件: 報告のみ。 このスキルの実行中はいかなるファイルも修正しない。修正はユーザーの優先度判断を経て、別途指示を受けてから行う(「ついで修正」の混入防止)。
検査項目
- SPEC.md と実装 — コマンド一覧・振る舞い・DB スキーマの記述が実装と一致するか(Tauri コマンドの増減、スキーマ定義(
CACHE_SCHEMA/ensure_schema)、ソート仕様などを突き合わせる)
- ルート CLAUDE.md — 記載コマンドが実行可能か、言及するファイルパスが実在と一致するか(ディレクトリ構成図は廃止済み。フォルダ構成は各フォルダの
CLAUDE.md が単一権威)
- フォルダ CLAUDE.md(
src/ src-tauri/ e2e/)— 記述が現在のコードと一致するか、移動・消失したファイルへの言及がないか
- docs/ —
ui-guidelines.md・locale-customization.md の規約が実装と一致するか
- スキルの化石検出 — 各
.claude/skills/*/SKILL.md 内のコマンド・パス・バージョン表記・モデル名が現在も有効か
- CI とチェックリスト —
.github/workflows/ci-build.yml のステップと /commit のチェックリストが整合するか(CI にあってローカルに無いチェック、またはその逆)
- 生成型 —
src/types/generated/ にコミット漏れ・実装に対応しない孤児ファイルがないか(cargo test --workspace 後に git status --porcelain src/types/generated/ で確認)
- RETROSPECTIVE.md — ネクストアクションが issue 化または消化されているか(
gh issue list と突き合わせる)
- 足場(scaffolding)の残存 — 撤去条件つきで書かれた仮設コード(「後続タスクで置き換え」「仮実装」等)がサイクルを跨いで生存していないか(
grep -rniE 'TODO|FIXME|後続タスク|後で(削除|置き換え|実装)|仮実装|仮置き' src src-tauri crates)。ヒットが撤去待ちか、恒久的な備考かを区別して報告する(placeholder 等は UI 属性・i18n キーで恒常ヒットするため意図句に絞っている)
- 常時ロード文脈の再肥大化 — ルート CLAUDE.md に、モデルが既に持つ一般則・ハーネス既定の言い直し・スキル本文や
package.json から導出できる記述が再流入していないか。各見出しを「repo 固有の落とし穴か / 既定を上書きする指示か」で判定し、どちらでもないものは生存コピーの所在(スキル名・ファイル)を添えて報告する
出力形式
| # | 検査項目 | 判定 | 根拠 |
|---|
| 1 | SPEC.md と実装 | ✅ / ⚠️ | file:line と乖離内容 |
| … | … | … | … |
⚠️ の項目には修正の当たり(どのファイルをどう直すべきか)を 1 行で添える。修正自体は行わない。