核心用法
prompt-log 是一款专注于 AI 编程助手会话日志提取的文档型工具。用户通过调用 scripts/extract.sh 脚本,配合本地 .jsonl 格式的会话文件,即可将 Clawdbot、Claude Code 或 Codex 的对话记录转换为结构化的 Markdown 文档。工具支持时间戳过滤(--after//--before)和自定义输出路径(--output),默认输出至 .prompt-log/YYYY-MM-DD-HHMMSS.md`。
显著优点
1. 多平台兼容:原生支持三种主流 AI 编程工具(Clawdbot、Claude Code、Codex),覆盖开发者常用场景。
2. 零代码风险:纯文档型 Skill,无可执行代码,无 eval/exec 等危险函数,安全性极高。
3. 灵活过滤:提供 ISO 8601 时间戳范围筛选,便于精准提取特定时段的对话。
4. 输出可控:支持自定义输出路径,避免文件散落,便于项目归档管理。
5. 来源可信:来自 clawdbot 官方组织(T2 来源),维护者明确,版本可追溯。
潜在缺点与局限性
1. 外部依赖:必须预装 jq 工具,macOS 用户还需注意 gdate 的可用性,环境准备成本存在。
2. 脚本缺失:文档中引用的 scripts/extract.sh 在实际 Skill 包中不存在,用户需自行实现或从其他渠道获取。
3. 功能单一:仅支持读取和转换,无分析、统计或可视化能力,需配合其他工具使用。
4. 格式受限:仅处理 .jsonl 格式,不支持其他日志格式或实时流式处理。
适合的目标群体
- 需要定期归档 AI 编程助手对话记录的开发者
- 团队技术负责人,需审计或复盘 AI 辅助编码过程
- 撰写技术博客或文档,需要引用完整对话上下文的作者
- 研究 AI 编程助手交互模式的科研人员
使用风险
1. 依赖项风险:若 jq 未安装或版本不兼容,功能完全不可用。
2. 输入文件风险:处理来自不可信来源的 .jsonl 文件可能引入恶意构造的数据,建议验证文件来源。
3. 路径注入风险:虽可通过 --output 控制,但若脚本实现不当,可能存在路径遍历隐患(当前 Skill 本身无此问题,但依赖外部脚本实现)。
4. 隐私泄露风险:导出的 Markdown 包含完整对话内容,若包含敏感代码或密钥,需妥善保管输出文件。