用途
Trails 是一个用于会话连续性的技能，帮助在多次会话之间保留工作上下文。它通过结构化的交接笔记（handoff）和自由格式日志（log）来记录工作进展、研究发现和决策，使后续会话能够无缝继续之前的工作。
主要能力
Trails 提供三个核心命令：
/trail:handoff：创建结构化的交接笔记，用于会话连续性。/trail:log <slug>：创建带时间戳的自由格式日志笔记。/trail:read [options]：读取最近的 trail 笔记。
交接格式
交接笔记是会话连续性的原子单元，应在每次会话结束时创建。格式如下：
# Handoff
> YYYY-MM-DD HH:MM · Session `<short-id>`
## Done
- Completed item 1
- Completed item 2
## State
Current state of work:
- What's in progress
- What's blocked
- Key decisions made
## Next
- [ ] First priority task
- [ ] Second priority task
- [ ] Lower priority item
交接原则：
- Done：使用过去时，具体成就。
- State：使用现在时，当前情况。
- Next：使用复选框列出可操作项。
- 可扫描：他人应能在 30 秒内掌握会话内容。
- 诚实：记录阻塞、不确定性和开放问题。
日志格式
日志是自由格式笔记，用于捕获任何值得保留的内容。格式如下：
# Title Derived From Slug
> YYYY-MM-DD HH:MM · Session `<short-id>`
[Freeform content - research findings, technical discoveries,
meeting notes, ideas, observations, etc.]
日志使用场景：
- 研究发现和文档
- 技术发现和陷阱
- 会议笔记和决策
- 想法和观察
- 调试会话和根本原因
日志原则：
- 描述性 slug：如果没有提供标题，将用作标题。
- 自由标签：使用 frontmatter 标签提高可发现性。
- 链接上下文：引用 issue、PR 或其他笔记。
- 面向未来：为没有上下文的读者（包括未来的自己）编写。
使用方式
子代理上下文
作为子代理工作时，传入父会话 ID 以分组相关笔记：
# Handoff with parent context
bun ${CLAUDE_PLUGIN_ROOT}/skills/trails/scripts/handoff.ts \
--session "$CHILD_SESSION" \
--parent "$PARENT_SESSION"
# Log with parent context
bun ${CLAUDE_PLUGIN_ROOT}/skills/trails/scripts/log.ts \
--slug "api-findings" \
--session "$CHILD_SESSION" \
--parent "$PARENT_SESSION"
这会在子目录中创建笔记：.trail/notes/YYYY-MM-DD/<parent-session>/
读取笔记
# Today's notes (all types)
/trail:read
# Just handoffs
/trail:read --type handoff
# Just logs
/trail:read --type log
# Last 3 days
/trail:read --days 3
# Limit output
/trail:read --lines 100
目录结构
.trail/
├── notes/
│ └── YYYY-MM-DD/
│ ├── handoff-YYYYMMDDhhmm-<session>.md
│ ├── YYYYMMDDhhmm-<slug>.md
│ └── <parent-session>/ # Subagent notes
│ ├── handoff-YYYYMMDDhhmm-<child>.md
│ └── YYYYMMDDhhmm-<slug>.md
├── plans/ # Implementation plans
└── artifacts/ # Research, ADRs, etc.
文件名约定
模式：[prefix-]YYYYMMDDhhmm[-suffix].md
| 类型 | 前缀 | 后缀 | 示例 |
|---|---|---|---|
| Handoff | handoff | session ID | handoff-202601221430-f4b8aa3a.md |
| Log | 无 | slug | 202601221430-api-research.md |
时间戳（YYYYMMDDhhmm）是锚点——即使文件被移动，仍保持可排序和可移植。
适用场景
- 会话结束时创建交接以保持连续性。
- 研究过程中在日志中捕获发现。
- 子代理工作时通过父会话链接保留上下文。
- 任何需要为未来会话留下 trail 的时候。
会话开始仪式
恢复工作时：
- 运行
/trail:read --type handoff查看最近的交接。 - 检查 Next 部分中的待办任务。
- 从上次会话中断的地方继续。
会话结束仪式
结束会话前：
- 运行
/trail:handoff创建交接笔记。 - 填写 Done、State 和 Next 部分。
- 足够具体，以便新会话能够无缝继续。
限制
资料中未提供关于收费、价格、平台支持范围或具体效果的信息。