时间表报告

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用

当用户提出以下要求时使用:“编写时间线报告”“[项目]之旅”“分析我的项目历史记录”“完整项目报告”

先决条件

claude-mem 工作线程必须正在运行。该项目必须记录claude-mem 观察结果。解析工作端口(在开始时执行一次,并在下面的每个curl调用中重用$WORKER_PORT):这会尊重CLAUDE_MEM_WORKER_PORTenv,然后是~/.claude-mem/settings.json,然后回退到每个UID默认值37700 + (uid % 100)——与工作线程本身选择其端口的方式相匹配。多帐户设置 (#2101) 和任何覆盖默认端口的用户 (#2103) 是必需的。

第 2 步:获取完整时间线

使用 Bash 从 claude-mem Worker API 获取完整的时间线:这将返回整个压缩的时间线——项目完整历史记录中的每个观察、会话边界和摘要。响应是针对 LLM 消耗进行优化的预格式化降价。代币估算:完整的时间线大小取决于项目的历史: 小型项目(< 1,000 个观察):20-50K 代币 中型项目(1,000-10,000 个观察):50-300K 代币

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@thedotmack · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第1步:确定项目名称

如果从上下文中不明显,请询问用户要分析哪个项目。项目名称通常是项目的目录名称(例如“tokyo”、“my-app”)。如果用户说“此项目”,则使用当前工作目录的基本名称。工作树检测:在使用目录基名之前,检查当前目录是否是 git 工作树。在工作树中,数据源是父项目,而不是工作树目录本身。运行:

02
第 2 步:获取完整时间线

使用 Bash 从 claude-mem Worker API 获取完整的时间线:这将返回整个压缩的时间线——项目完整历史记录中的每个观察、会话边界和摘要。响应是针对 LLM 消耗优化的预格式化降价。代币估算:完整的时间线大小取决于项目的历史: 小型项目(< 1,000 个观察):~20-50K 代币 中型项目(1,000-10,000 个观察):~50-300K 代币

03
第 3 步:估计代币数量

在继续之前,估计所获取的时间线的令牌计数(大约每 4 个字符 1 个令牌)。向用户报告此情况:如果时间线超过 100K 代币,请等待用户确认后再继续。

04
第 4 步:使用子代理进行分析

部署具有完整时间线和以下分析提示的代理(使用任务工具)。将整个时间线作为上下文传递给代理。还应该指示代理在`~/.claude-mem/claude-mem.db`处查询 SQLite 数据库中的代币经济部分。代理提示: -- 发现令牌总数 SELECT SUM(discovery_tokens) FROM Observations WHERE project = 'PROJECT_NAME'; -- 具有可用上下文的会话(不是第一个会话)

05
第 5 步:保存报告

将代理的输出保存为 markdown 文件。默认位置:或者如果用户指定了不同的输出路径,则使用它。

06
第 6 步:报告完成

告诉用户: 报告的保存位置 大致的代币成本(输入时间线 + 输出报告) 涵盖的日期范围 分析的观察结果数量

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。