메뉴
Trail の 3DB(memory-core/doc-core/trail)を横断分析し、前回からのデルタに基づく開発健全性レポートと(閾値超なら)改善提案を生成する。「/anytime-dev-health」「定期分析」「開発健全性」「dev health」「健全性レポート」の指示、または週次スケジュールからの起動で使用する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | anytime-dev-health |
| effort | medium |
| description | Trail の 3DB(memory-core/doc-core/trail)を横断分析し、前回からのデルタに基づく開発健全性レポートと(閾値超なら)改善提案を生成する。「/anytime-dev-health」「定期分析」「開発健全性」「dev health」「健全性レポート」の指示、または週次スケジュールからの起動で使用する。 |
更新日: 2026-07-11
Trail が蓄積する 3 つのローカル DB を横断分析し、前回からの変化（デルタ）に基づく健全性レポートを出力する。変化が閾値を超えたシグナルだけ改善提案に昇格させる（毎回同じ指摘を繰り返さないのが本スキルの肝）。
<workspace>/.anytime/trail/db/{trail.db, memory-core.db, doc-core.db}SHORTCUT: 意図的簡略化マーカー（台帳化・no-trigger 検出。判定はスキル同梱 shortcutMarkers.cjs に一本化し、CI ゲート scripts/check-shortcut-markers.mjs＝npm run check-skills と同一実装）。規約は ~/.claude/rules/code-quality.md 2.1。~/.claude/projects/<project>/memory/*.md）の再発シグナル（スキル同梱 recurrence.cjs）。「同種の罠 2 回再発で constraint 昇格」「スキル乖離 2 回でスキル本文反映」の昇格候補を機械提示する。検出のみで自動書き込みはしない（メモリ領域は保護領域。作成はユーザー承認後）。/Shared/anytime-markdown-docs/（report/_signals/ ＝スナップショット、report/ ＝健全性レポート、proposal/ ＝閾値超の改善提案）plan/20260622-periodic-dev-health-analysis.ja.md を参照。node:sqlite で完結し MCP 非依存（headless claude -p でも完走する）。スキル同梱の集計スクリプトを実行し、signals snapshot(JSON) を得て保存する。
mkdir -p /Shared/anytime-markdown-docs/report/_signals
node .claude/skills/anytime-dev-health/grounding.cjs > /Shared/anytime-markdown-docs/report/_signals/<YYYYMMDD>.json
<YYYYMMDD> は snapshot の generatedAt を JST に変換した日付。保存先 _signals/ は初回未作成のため上記 mkdir -p で必ず先に用意する。errors 配列を必ず確認する。空でなければ（スキーマ変化等でクエリが失敗している）、その旨をレポート冒頭に明記し、該当シグナルは「測定不能」として扱う（誤った 0 を真値にしない）。report/_signals/ から今回より前の最新スナップショットを 1 つ選び、主要メトリクスを今回と比較する。比較対象メトリクス:
| メトリクス | 源 | 悪化方向 |
|---|---|---|
Opus コスト占有率 costWindow30d.opusCostSharePct | trail | 上昇 |
cache_read 占有率 costWindow30d.cacheReadSharePct | trail | 上昇 |
1000msg 超セッション数 costWindow30d.sessionsOver1000Msgs | trail | 上昇 |
未対処 finding quality.unaddressedFindings | memory | 上昇 |
reviewer 空 quality.reviewerEmpty | memory | 上昇 |
bug:review 比 quality.bugToReviewRatio | memory | 上昇 |
未解決 drift drift.unresolved と drift.byType | memory | 上昇 / 新種別出現 |
embedding 充足率 docCore.embeddingCoveragePct | doc-core | 低下 |
孤立 doc docCore.orphanDocs | doc-core | 上昇 |
cc>15 関数数 hotspotOver15 と hotspots top | trail | 上昇 / 新規高 cc 関数 |
SHORTCUT 技術負債 techDebt.shortcutMarkers / techDebt.noTriggerMarkers | source | 上昇 / no-trigger 増 |
スキル健全性 skillHealth.brokenRefs / staleOver90 / unused30d | source+trail | 上昇 |
再発シグナル recurrence.danglingClusters / recurrence.uncoveredBugFiles | memory dir + memory | 新規クラスタ出現 / 増加 |
再発の「2 回」判定: recurrence.danglingClusters の同一 target、または skillHealth.brokenRefs 対象の同一スキルが前回スナップショットにも存在していたら「2 回目」とみなし、R023（constraint メモリ昇格）/ R024（スキル本文反映）の発火候補として §4 の提案へ昇格する。grounding はステートレスに現在値のみ出力し、連続判定は本デルタ比較で行う。
各メトリクスを 新規発生 / 悪化 / 改善 / 横ばい に分類する。
前回スナップショットが無い（初回）場合は全メトリクスを「初期値」として記録し、デルタ比較はスキップする。
累積指標を増加判定に使わない: コスト・セッション系は cost.*（全期間累積）ではなく costWindow30d.*（直近 30 日窓）でデルタを見る。cost.opusCostSharePct / cost.cacheReadSharePct / activity.sessionsOver1000Msgs は全期間累積で単調増加しかせず、「増加＝悪化」判定が活動のある限り構造的に発火する（偽陽性）。cost.* は現状値の参照用に残す。新メトリクスを追加する際は「累積か期間か・悪化判定と整合するか」を必ず確認する。
/Shared/anytime-markdown-docs/report/<YYYYMMDD>-dev-health.ja.md を出力する。anytime-markdown-output スキルの書式（frontmatter type: report）に従う。
構成:
title / date / type: report / lang: ja / author / excerpt）出力後 bash ~/.claude/scripts/validate-markdown.sh <file> で検証する。
下記いずれかを満たすシグナルがあれば、anytime-proposal スキル（既定 lightweight・1 提案 = 1 論点）で改善提案を生成し proposal/<YYYYMMDD>-<topic>.ja.md に出力する。満たさなければレポートのみで終了。
昇格閾値（いずれか）:
drift.unresolved が前回比 +20% 以上。docCore.embeddingCoveragePct が 90% を下回る、または前回比 10pt 以上低下。quality.unaddressedFindings が前回比 +10 以上、または quality.reviewerEmpty が増加して全レビューの過半。hotspots に前回スナップショットに無い cc>200 の新規関数が出現。costWindow30d.opusCostSharePct（30 日窓）が前回比 +5pt 以上、または costWindow30d.cacheReadSharePct が 99% 超で costWindow30d.sessionsOver1000Msgs（30 日窓）が増加。累積の cost.* では機械的に発火するため窓値で判定する。techDebt.noTriggerMarkers が前回比 +5 以上、または techDebt.noTriggerSharePct が 50% 超（昇格経路なき簡略化が支配的）。skillHealth.brokenRefs が 1 以上（参照切れの放置）、または staleOver90 が前回比増かつ unused30d が総数の過半（棚卸し要否の判断材料）。recurrence.danglingClusters に前回スナップショットと同一の target が残存（2 回目の観測 = constraint メモリ作成を提案）、または recurrence.uncoveredBugFiles に新規ファイルが出現（教訓化されていない再発バグ領域）。提案には対象 target / referrers / ファイルを明記し、メモリ作成自体はユーザー承認後に行う。deep モード（
anytime-proposal --deep専門観点パネル）はコストが高いため、複数の重大シグナルが同時悪化した場合か、ユーザーが明示した場合のみ使う。定期実行の既定は lightweight。
errors を返したら silent に 0 を採用しない（測定不能として明示）。本スキルはスケジューラ非依存の可搬コア。週次自動実行の配線（Desktop Scheduled Task 等）は plan/20260622-periodic-dev-health-analysis.ja.md の「スケジューリング」を参照。手動でも /anytime-dev-health で実行できる。
/Shared/anytime-markdown-docs 配下のドキュメントを新規作成・執筆する時に、type（spec/tech/test/manual/proposal/plan/review/report）ごとの記載内容（何を書くか）・フォルダ構成・索引 index.[lang].md の自動生成運用を定義する。設計書（spec）の書き方・component spec の 2 ファイル分離・E2E シナリオ表・技術解説記事（tech。「技術記事を書いて」「ブログ記事を作成」「解説記事を書いて」等）の構成テンプレート・執筆ガイドライン・文体・生成ワークフロー・試験設計書（「試験設計書」「テスト設計書」「テストケースを設計」「テスト観点で洗い出し」「テスト計画」「QA 設計」等。7 ペルソナ観点・技法・自動化判定）・プランファイルの「変更対象ファイル」節・索引再生成が必要な時に使用する。構文・フロントマター・整形は anytime-markdown-output、既存設計書の読み方・辿り方は anytime-spec-lookup を使う。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
コードレビュー結果を出力する際の Markdown 書式（memory-core ingest パーサ対応）。### N. タイトル＋重大度/カテゴリ/対象の3メタデータ＋行頭の問題:/提案: マーカーで指摘を構造化する。レビュードキュメント・code-reviewer subagent 出力・requesting-code-review/security-review の指摘を書く時に使用する。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
Markdown ドキュメント（spec/tech/test/manual/proposal/plan/review/report）を出力・編集する際の構文・フロントマター・整形規約。/Shared/anytime-markdown-docs/ 配下に .md を作成/更新する時、見出し・テーブル・コードブロック・脚注・アドモニション・図表・フロントマター(type/c4Scope 等)を書く時、Markdown 出力仕様を確認する時に使用する。
anytime-markdown の設計書（/Shared/anytime-markdown-docs/spec）を低トークンで辿るためのナビゲーション手順。索引(index.ja.md) → 対象 frontmatter → 型付き related を必要な深さだけ辿る progressive disclosure。設計書の調査・参照・関連ドキュメント探索・「どの spec を読むべきか」を判断する時に使用する。