Back to Details

specstory-link-trail

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SpecStory Link Trail

SpecStory 链接轨迹

Reviews your 
.specstory/history
sessions and creates a summary of all URLs that were fetched via WebFetch tool calls. Useful for auditing external resources accessed during development.
遍历你的 
.specstory/history
会话，生成所有通过WebFetch工具调用抓取的URL的汇总，适用于审计开发过程中访问的外部资源。

How It Works

工作原理

  1. Parses SpecStory history files for WebFetch tool calls
  2. Extracts URLs, status codes, and context
  3. Groups by session with timestamps
  4. Separates successful fetches from failures
  5. Deduplicates repeated URLs with fetch counts
  1. 解析 SpecStory历史文件中的WebFetch工具调用
  2. 提取 URL、状态码和上下文
  3. 按会话分组并附带时间戳
  4. 区分抓取成功和失败的记录
  5. 去重重复的URL并统计抓取次数

Why Track Links?

为什么需要追踪链接？

During AI-assisted coding, your assistant fetches documentation, APIs, and resources on your behalf. Link Trail helps you:
  • Audit what external resources were accessed
  • Find that documentation page you saw earlier
  • Review failed fetches that might need retry
  • Understand your research patterns
在AI辅助编码过程中，你的助手会代表你抓取文档、API和各类资源。链接轨迹可以帮助你：
  • 审计所有访问过的外部资源
  • 找到你之前浏览过的文档页面
  • 排查可能需要重试的失败抓取请求
  • 了解你的研究行为模式

Usage

使用方法

Slash Command

斜杠命令

User saysScript behavior
/specstory-link-trail
All sessions in history
/specstory-link-trail today
Today's sessions only
/specstory-link-trail last session
Most recent session
/specstory-link-trail 2026-01-22
Sessions from specific date
/specstory-link-trail *.md
Custom glob pattern
用户指令脚本行为
/specstory-link-trail
历史中的所有会话
/specstory-link-trail today
仅今日会话
/specstory-link-trail last session
最近一次会话
/specstory-link-trail 2026-01-22
指定日期的会话
/specstory-link-trail *.md
自定义glob模式

Direct Script Usage

直接调用脚本

bash
undefined
bash
undefined

All sessions

所有会话

python skills/specstory-link-trail/parse_webfetch.py .specstory/history/*.md |
python skills/specstory-link-trail/generate_report.py -
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 -
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 -
undefined
python skills/specstory-link-trail/parse_webfetch.py .specstory/history/2026-01-2*.md |
python skills/specstory-link-trail/generate_report.py -
undefined

Output

输出示例

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
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

Present Results to User

向用户呈现结果

The script output IS the report. Present it directly without additional commentary, but you may:
  1. Highlight key findings - Most frequently accessed domains, any failed fetches
  2. Offer follow-ups - "Want me to retry the failed fetches?" or "Need details on any of these?"
脚本输出本身就是报告，可以直接呈现无需额外说明，但你也可以：
  1. 高亮关键发现 - 访问最频繁的域名、所有失败的抓取请求
  2. 提供后续操作建议 - "需要我重试失败的抓取请求吗？"或者"需要了解其中任意链接的详细信息吗？"

Example Response

回复示例

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?
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?

Notes

注意事项

  • Uses streaming parsing for large history files
  • URLs are extracted from WebFetch tool calls in the history
  • Fetch counts show when the same URL was accessed multiple times
  • Failed fetches include the HTTP status code when available
  • 针对大型历史文件采用流式解析
  • URL从历史记录中的WebFetch工具调用中提取
  • 抓取次数显示同一URL被多次访问的情况
  • 失败的抓取请求会在可用时附带HTTP状态码