mcpField
S
session-log

session-log

github.com/michalparkola生产力564159 次安装33 周前更新
代码仓库

关于 session-log

session-log 是用于将当前对话整理并追加到每周 Agent 日志文件的技能。它规定日期归属、条目格式及保留已有内容的追加方式。

主要功能

  1. 01总结对话主题与结论
  2. 02按日期组织日志条目
  3. 03标记可复用输出
  4. 04追加内容而不覆盖旧记录

适用场景

  1. 01记录一周内的 Agent 会话
  2. 02整理跨日期对话主题
  3. 03为计划或草稿添加 CHUNK 标记

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/michalparkola/tapestry-skills --skill session-log

安装后在 Claude Code 中输入/session-log确认已加载。

详细介绍

会话日志

总结当前对话,并追加到每周 Agent 日志文件中。

输出位置

YYYY-wWW Agent Log.md

其中 YYYY-wWW 是今天日期对应的 ISO 周数。计算方法:

date +%Y-w%V

格式规则

  1. 按时间倒序排列——最新日期置顶
  2. 每天使用一个 ## 标题——格式:## YYYY-MM-DD
  3. 使用项目符号,不使用子标题——每天的内容中,用普通项目符号 - 主题标题 作为主题分隔符,不要使用 ###。主题行不要加粗,也不要使用其他格式。
  4. 详情使用嵌套项目符号——每条子项目符号写一个句子;如有需要,可以继续嵌套。不要加粗。嵌套时使用 TAB 缩进。
  5. CHUNK 标记——如果某个主题产生了可复用的输出(计划、摘要、框架或消息草稿),添加嵌套项目符号:CHUNK: <描述性标题>
  6. 不要添加说明文字——不要写开场白、不要写“本次会话讨论了……”之类的内容,也不要添加元评论
  7. 追加,不要替换——如果当天的标题已存在,就在其下方添加新的项目符号,不要移除已有内容

示例

## 2026-02-28

- Analiza strategii X vs framework Y + moje obserwacje
  - Strategia jest silna w A i B, słaba w C — brakuje fosy i horyzontu 3+lat.
  - Naming produktu "Rescue" implikuje że kupujący jest ofiarą, co blokuje referencje.
  - Anty-segment nie jest sprawdzalny z zewnątrz — to opis doświadczenia, nie filtr.
  - CHUNK: 3-zdaniowe podsumowanie strategii
  - CHUNK: Scorecard po 6 osiach
- Decyzja: follow-up z klientem
  - Nie wysyłać feedbacku (nie prosił), wysłać link do artykułu jako wartość bez CTA.

分步工作流

1. 确定目标文件
WEEK=$(date +%Y-w%V)

目标:${WEEK} agent-log.md

2. 读取现有文件(如有)

该文件可能已有本周较早会话的记录。先读取文件,以免覆盖内容。

3. 回顾完整对话并确定日期

浏览完整的对话历史,确定:

  • 主题——区分不同主题(将相关的往返交流归为一个主题)
  • 决策——已做出的决定或结论
  • 输出——任何可复用的成果(摘要、计划、消息草稿、框架、评分卡)

日期归属: 对话可能跨越多天。根据以下信号(按优先级排序)确定每个主题的正确日期:

  1. 系统日期提醒,例如“The date has changed. Today's date is now...”
  2. 带日期的文件名,例如,2026-02-26 client email.md 是在该日期创建或讨论的
  3. 会话摘要中的上下文——如果会话从压缩后的对话继续,摘要可能会提及不同工作分别在哪天完成
  4. 默认规则——如果没有日期信号,则使用今天的日期

按主题实际发生的日期分组,而不只是归入“今天”。

4. 写入日志条目

对于有主题的每个日期:

  • 如果文件中已有该日期的标题(## YYYY-MM-DD),就在其下方追加新主题
  • 如果文件中尚无该日期的标题,则按时间倒序插入到正确位置
  • 如果文件不存在,则创建该文件

跨周日期: 如果某个主题所属日期与目标文件不在同一个 ISO 周,请告知用户,并询问是将其添加到当前文件,还是添加到正确周的文件中。

精简规则:

  • 多次相关交流 → 合并为一个主题项目符号
  • 多轮来回修改 → 只保留最终结论
  • 如果用户编辑或更正了内容 → 使用更正后的版本,忽略早期草稿

追加规则:

  • 如果今天的 ## YYYY-MM-DD 标题下已有项目符号,则在末尾添加新内容——绝不要删除或改写已有项目符号
  • 如果本次会话的主题与已有项目符号重叠,则在新主题项目符号下添加新的详情项目符号——不要合并到已有内容中
5. 确认

告知用户记录了哪些内容(仅列主题标题,单行显示)。

重要说明

  • 用户可能偏好某种主题标题风格——如果用户编辑过之前的条目,请沿用该风格
  • 项目符号内容要尽量简短——每条写一个句子,不要用分号串联多个想法
  • CHUNK 应指向对话中实际存在的输出,而不是文件中的内容——它们是供用户稍后查找的书签
  • 不要在日志中写入完整的 chunk 内容——只写标记
  • 语言:与对话所用语言一致(使用用户的语言)

评论

支持 Markdown