name: specstory-link-trail description: 跟踪所有在SpecStory AI编码会话中获取的URL。当用户说“显示我的链接追踪”、“我访问了哪些URL”、“列出获取的链接”或“显示网络获取”时运行。 license: Apache-2.0 metadata: author: SpecStory, Inc. version: “1.0.0” argument-hint: “[历史文件或模式]” allowed-tools: Bash, Read

SpecStory 链接追踪

查看您的 .specstory/history 会话并创建通过 WebFetch 工具调用获取的所有 URL 的摘要。适用于审计在开发过程中访问的外部资源。

工作原理

解析 SpecStory 历史文件以查找 WebFetch 工具调用
提取 URL、状态码和上下文
按会话分组，包含时间戳
分离成功获取和失败获取
去重重复的 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 模式

直接脚本使用

# 所有会话
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/2026-01-22*.md | \
  python skills/specstory-link-trail/generate_report.py -

# 日期范围内的会话
python skills/specstory-link-trail/parse_webfetch.py .specstory/history/2026-01-2*.md | \
  python skills/specstory-link-trail/generate_report.py -

输出

链接追踪报告
=================

分析的会话数：5
获取的 URL 总数：23（18 次成功，5 次失败）

会话：修复身份验证错误 (2026-01-22)
--------------------------------------------
成功获取：
  - https://docs.github.com/en/rest/authentication (×2)
  - https://jwt.io/introduction
  - https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401

失败获取：
  - https://internal.company.com/api/docs (403 Forbidden)

会话：添加缓存层 (2026-01-21)
---------------------------------------
成功获取：
  - https://redis.io/docs/latest/commands
  - https://docs.python.org/3/library/functools.html#functools.lru_cache
  - https://stackoverflow.com/questions/... (×3)

按域名摘要
-----------------
  github.com: 5 次获取
  stackoverflow.com: 4 次获取
  docs.python.org: 3 次获取
  redis.io: 2 次获取
  （其他 9 个域名）：9 次获取

向用户展示结果

脚本输出即报告。直接展示，无需额外评论，但您可以：

突出关键发现 - 最常访问的域名、任何失败获取
提供后续选项 - “是否要重试失败的获取？”或“需要其中任何细节吗？”

示例响应

这是您近期会话的链接追踪：

[脚本输出在此]

我注意到 5 次失败获取 - 主要是需要身份验证的内部 URL。
最常访问的域名是 github.com（5 次获取），主要用于其 REST API 文档。

您是否希望我：
- 重试任何失败的获取？
- 打开任何这些链接？
- 过滤到特定会话？

注意

使用流式解析处理大型历史文件
URL 从历史中的 WebFetch 工具调用中提取
获取次数显示同一 URL 被多次访问
失败获取包含可用的 HTTP 状态码