SuperAPI AI 工具集

timeline-report

写作与研究

查看项目

更新于 10-16 07:20

技能介绍

用途:该技能根据 claude-mem 持久记忆时间线,生成项目完整开发史的叙事分析报告,标题为“Journey Into [项目名]”。当用户要求写时间线报告、分析项目历史、总结完整开发历史或讲述项目故事时使用。

前置条件:claude-mem worker 必须正在运行,且项目已有 claude-mem 观测记录。需解析 worker 端口,方式为优先读取 CLAUDE_MEM_WORKER_PORT 环境变量,其次读取 ~/.claude-mem/settings.json,最后回退到按 UID 计算的默认端口 37700 + (uid % 100),并在后续 curl 调用中复用 $WORKER_PORT。

使用方式:先确定项目名(通常为目录名;若为 git worktree 则使用父项目名);通过 curl -s "http://localhost:${WORKER_PORT}/api/context/inject?project=PROJECT_NAME&full=true" 获取完整压缩时间线;估算 token 数,超过 100K tokens 时需用户确认;使用 Task 工具部署子代理进行分析,可查询 ~/.claude-mem/claude-mem.db 获取 Token 经济数据;最后将报告保存为 ./journey-into-PROJECT_NAME.md 或用户指定路径,并报告保存位置、token 成本、日期范围和观测数量。

报告内容:涵盖项目起源、架构演进、关键突破、工作模式、技术债、挑战与调试历程、记忆与连续性、Token 经济与记忆 ROI、时间线统计及经验总结等部分,按时间顺序分析整个时间线。

限制:时间线过大(如 50,000+ 观测)可能超出上下文限制,建议按时间窗口分段分析;worker 未运行或项目名错误会导致空响应或错误;worker 端口解析对多账户和自定义端口环境必要。