specstory-link-trail

SpecStory リンクトレイル

.specstory/history のセッションを確認し、WebFetch ツールの呼び出しを通じて取得されたすべての URL の概要を作成します。開発中にアクセスした外部リソースを監査するのに役立ちます。

仕組み

1. SpecStory の履歴ファイルから WebFetch ツールの呼び出しを解析します
2. URL、ステータスコード、コンテキストを抽出します
3. タイムスタンプ付きでセッションごとにグループ化します
4. 成功した取得と失敗した取得を分けます
5. 重複する URL を取得回数とともに整理します

リンクを追跡する理由

AI 支援コーディングでは、アシスタントがドキュメント、API、リソースをユーザーに代わって取得します。リンクトレイルを使うと、次のことができます。

• アクセスした外部リソースを監査する
• 以前に見たドキュメントページを見つける
• 再試行が必要と思われる取得失敗を確認する
• 調査のパターンを把握する

使い方

スラッシュコマンド

ユーザーの入力	スクリプトの動作
/specstory-link-trail	履歴内のすべてのセッション
/specstory-link-trail today	今日のセッションのみ
/specstory-link-trail last session	最新のセッション
/specstory-link-trail 2026-01-22	指定した日付のセッション
/specstory-link-trail *.md	カスタム glob パターン

スクリプトを直接実行する

# All sessions
python skills/specstory-link-trail/parse_webfetch.py .specstory/history/*.md | \
  python skills/specstory-link-trail/generate_report.py -

# Specific session
python skills/specstory-link-trail/parse_webfetch.py .specstory/history/2026-01-22*.md | \
  python skills/specstory-link-trail/generate_report.py -

# Sessions from a date range
python skills/specstory-link-trail/parse_webfetch.py .specstory/history/2026-01-2*.md | \
  python skills/specstory-link-trail/generate_report.py -

出力

Link Trail Report
=================

Sessions analyzed: 5
Total URLs fetched: 23 (18 successful, 5 failed)

Session: fix-authentication-bug (2026-01-22)
--------------------------------------------
Successful fetches:
  - https://docs.github.com/en/rest/authentication (×2)
  - https://jwt.io/introduction
  - https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401

Failed fetches:
  - https://internal.company.com/api/docs (403 Forbidden)

Session: add-caching-layer (2026-01-21)
---------------------------------------
Successful fetches:
  - https://redis.io/docs/latest/commands
  - https://docs.python.org/3/library/functools.html#functools.lru_cache
  - https://stackoverflow.com/questions/... (×3)

Summary by Domain
-----------------
  github.com: 5 fetches
  stackoverflow.com: 4 fetches
  docs.python.org: 3 fetches
  redis.io: 2 fetches
  (9 other domains): 9 fetches

結果をユーザーに提示する

スクリプトの出力そのものがレポートです。追加の説明を加えず、そのまま提示してください。ただし、次のことは行ってもかまいません。

1. 主な調査結果を強調する — 最も頻繁にアクセスされたドメイン、取得失敗の有無
2. 次の対応を提案する — 「失敗した取得を再試行しますか？」や「これらの中で詳細が必要なものはありますか？」

応答例

Here's your link trail from recent sessions:

[script output here]

I noticed 5 failed fetches - mostly internal URLs that require authentication.
The most accessed domain was github.com (5 fetches), mostly for their REST API docs.

Would you like me to:
- Retry any of the failed fetches?
- Open any of these links?
- Filter to a specific session?

注意事項

• 大きな履歴ファイルにはストリーミング解析を使用します
• URL は履歴内の WebFetch ツールの呼び出しから抽出されます
• 取得回数は、同じ URL に複数回アクセスした場合にその回数を示します
• 取得に失敗した場合、可能であれば HTTP ステータスコードも表示されます