⚡

SpecStory会话摘要 specstory-session-summary

这个技能用于自动总结SpecStory AI编码会话，以站立会议格式输出，帮助开发者回顾工作历史、准备日常会议、跟踪进度和理解完成的任务。关键词：SpecStory, AI编码, 会话总结, 站立会议, 工作管理, 进度跟踪, 代码审查, 项目管理工具。

项目管理 0 次安装 0 次浏览 更新于 3/7/2026

名称：specstory-session-summary 描述：以站立会议格式总结最近的SpecStory AI编码会话。当用户想要从.specstory/history回顾会话、准备站立会议、跟踪工作进度或理解完成的工作时使用。 许可证：MIT 元数据： 作者：SpecStory 版本：“1.0”

上下文

您将分析最近的SpecStory会话历史文件，以提供站立会议风格的摘要。

提供的参数：$ARGUMENTS（默认：5个会话，或“today”仅限今天的会话）

您的任务

步骤1：查找最近会话

首先，检查SpecStory历史文件夹是否存在并列出最近的会话文件：

ls -t .specstory/history/*.md 2>/dev/null | head -20

如果没有.specstory/history文件夹或为空，响应：

在此目录中未找到SpecStory会话历史。

SpecStory自动保存您的AI编码会话以供后续参考。要开始记录您的会话，请从https://specstory.com安装SpecStory

然后停止 - 不要继续后续步骤。

如果找到会话，继续分析。如果参数是“today”，则过滤为今天的日期。否则使用提供的数字（默认5）。

步骤2：读取和分析每个会话

会话文件可能非常大，可能包含多个用户请求。使用这种分块阅读策略：

步骤2a：理解会话结构

首先，grep所有用户消息标记以查看会话范围：

grep -n "_\*\*User\*\*_" <file> | head -10

这显示用户消息的行号，帮助您理解：

  • 提出了多少个不同的请求
  • 在哪里读取每个请求的上下文

步骤2b：基于结构进行策略性阅读

  1. 开头（前500行） - 使用offset=0, limit=500读取

    • 捕获初始请求，即使包含粘贴的代码/日志
    • 可能包括显示所采用方法的早期助手响应

  2. 结尾（最后300行） - 通过Bash使用tail -300 <file>

    • 包含最终结果和结论
    • 显示任务是否完成或挂起

  3. 文件操作 - Grep修改：

    grep -E "(Edit|Write)\(" <file>

步骤2c：对于多请求会话

如果步骤2a中的grep显示多个用户消息在远距离行号（例如，行50、800、1500），这表示多个不同的任务。对于这些会话：

  • 围绕每个用户消息行号读取（例如，offset=795, limit=100）
  • 总结2-3个主要任务，而不仅仅是第一个

提取此信息：

  1. 目标：来自_**User**_块的用户请求
    • 对于单任务会话：一个主要目标
    • 对于多任务会话：列出2-3个主要任务
  2. 结果：从对话结尾确定：
    • ✅ 完成 - 任务成功完成
    • 📚 研究 - 信息收集，无代码更改
    • 🔧 进行中 - 工作开始但会话中途结束
    • ❌ 放弃 - 用户改变方向或放弃
    • 🚧 阻塞 - 以未解决错误或阻塞结束
  3. 文件：来自Edit/Write工具使用的修改文件（仅提取文件名）
  4. 关键决策：在对话中查找：
    • 明确选择（“决定”、“选择”、“而不是”）
    • 权衡讨论
    • 架构或设计结论

步骤3：格式化输出

将每个会话呈现为：

### {YYYY-MM-DD HH:MM} - {来自主要目标的简要标题}
**目标**：{1句话总结用户想要的内容}
**结果**：{emoji} {简要结果描述}
**文件**：{逗号分隔列表，或“无”如果仅是研究}
**关键洞察**：{如果有，显著决策或学习}

对于多任务会话，调整格式：

### {YYYY-MM-DD HH:MM} - {整体主题或主要任务}
**任务**：
  1. {第一个任务} - {结果emoji}
  2. {第二个任务} - {结果emoji}
**文件**：{逗号分隔列表}
**关键洞察**：{如果有，显著决策或学习}

步骤4：总结部分

在所有会话后添加：

---
**模式**：{注意任何重复主题、多次触及的文件、进行中的工作}
**未完成**：{任何以TODO、阻塞或不完整工作结束的会话}

指南

  • 保持每个会话摘要最多5-6行（多任务会话稍多）
  • 从用户目标推断标题，而非文件名
  • 对于文件，优先显示仅文件名，而非完整路径
  • 跳过仅是快速问题而无实际工作的会话
  • 对于多任务会话，总结最多3个主要任务；将次要任务分组为“各种小修复”
  • 简洁 - 这是用于快速每日回顾，而非详细文档
  • 如果文件读取失败或太大，使用能提取的内容；不要完全跳过会话

示例输出

## 会话摘要（最近3个会话）

### 2025-10-18 11:42 - 调查聊天CRDT存储
**目标**：理解为什么聊天索引CRDT不包含线程
**结果**：📚 解释了离线/在线同步的双重存储设计
**文件**：threads.json, crdt-debug/4X/, crdt-debug/aT/
**关键洞察**：两个存储层（CRDT + JSON）服务不同的同步场景

### 2025-10-18 11:09 - 处理代码审查评论
**目标**：修复代码审查中的清晰度问题
**结果**：✅ 重构了normalizeChatIndexDoc函数
**文件**：chat.go, automerge-bridge.js
**关键洞察**：用toPlainString助手替换了复杂的规范化

### 2025-10-11 14:30 - Automerge架构深度探索
**目标**：记录Automerge文档如何按时间构建
**结果**：📚 研究完成，提供了演练
**文件**：automerge-bridge.js, document.go（仅读取）

---
**模式**：3个会话专注于CRDT/聊天子系统；automerge-bridge.js重复触及
**未完成**：未检测到