القائمة
プロジェクトのドキュメントとコードをスキャンしてトレーサビリティグラフを構築する。新しいプロジェクトで最初に実行するか、大きな変更後に再スキャンする際に使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | doc-tracer-scan |
| description | プロジェクトのドキュメントとコードをスキャンしてトレーサビリティグラフを構築する。新しいプロジェクトで最初に実行するか、大きな変更後に再スキャンする際に使用。 |
| allowed-tools | Bash(doc-tracer:*), Read, Glob |
プロジェクトのドキュメントとコードをスキャンして、トレーサビリティグラフを構築します。
which doc-tracer || echo "doc-tracer not found"
インストールされていない場合:
cd /path/to/doc-tracer && go build -o doc-tracer . && sudo mv doc-tracer /usr/local/bin/
引数 $ARGUMENTS で指定されたパスをスキャンします。
# ドキュメントとコードの両方をスキャン
doc-tracer scan $ARGUMENTS
# または個別にスキャン
doc-tracer scan $ARGUMENTS/docs --docs-only
doc-tracer scan $ARGUMENTS/src --code-only
doc-tracer check
doc-tracer serve --port 8080
ブラウザで http://localhost:8080 を開いてグラフを確認。
モノレポや複数リポジトリ構成の場合:
# ドキュメントリポジトリ
doc-tracer scan /path/to/docs-repo --docs-only
# フロントエンドリポジトリ（シンボリックリンクの場合はrealpathで解決）
FRONT_PATH=$(realpath /path/to/frontend)
doc-tracer scan "$FRONT_PATH" --code-only
# バックエンドリポジトリ
BACK_PATH=$(realpath /path/to/backend)
doc-tracer scan "$BACK_PATH" --code-only
tracer.db: SQLiteデータベース（ノードとエッジを格納）スキャン完了: ドキュメント X件, コード要素 Y件スキャン完了: ドキュメント 0件, コード要素 0件
原因: docs/ ディレクトリが存在しない
解決策:
# ディレクトリ構造を確認
ls -la docs/
# なければ作成
mkdir -p docs/{01_要件定義,02_仕様書,03_基本設計,04_詳細設計,05_プログラム設計}
# この2コマンドは常にセットで実行
./doc-tracer scan . && ./doc-tracer check
チェックで問題が出たら必ず解決してから次の作業に進む。
./doc-tracer serve --port 8888
確認ポイント:
以下を全て満たすまでスキャン作業は「完了」ではない:
./doc-tracer scan . でドキュメント件数 > 0./doc-tracer scan . でコード要素件数 > 0（コードがある場合）./doc-tracer check で「問題なし」Markdownドキュメントにトレーサビリティ用のYAMLフロントマターを追加する。新規ドキュメント作成時や、既存ドキュメントにトレース情報を追加する際に使用。
ドキュメントとコードのトレーサビリティ整合性をチェックする。リンク切れ、孤立ドキュメント、構造の問題を検出して修正案を提示。
コード変更後に影響を受けるドキュメントを特定し、更新する。コード修正後やPR作成前にドキュメントの整合性を保つために使用。