研究追踪器

技能简介

research-tracker是一款命令行工具，用于管理自主运行的AI研究代理。通过SQLite数据库存储追加式事件日志，实现多步骤调查的状态追踪、代理间任务交接与后台工作监控。

业务背景

解决AI研究代理"黑箱运行"难题。当多个AI代理并行执行深度调研时，管理者可实时掌握各项目进度、识别卡滞环节、无缝交接任务，避免重复劳动与资源浪费。特别适合需要数小时甚至数天完成的复杂分析场景，确保长周期研究工作可控可追溯。

落地案例：市场团队启动Q1竞品定价分析，负责人执行research init创建项目并设定目标。AI代理自动记录每个执行步骤——开始数据收集、完成信源整理、在访问受限网站时标记BLOCKED状态。项目经理通过心跳监控发现某代理停滞超5分钟，及时介入排查；同时向另一代理发送紧急指令调整分析维度，全程无需中断后台作业。

能做什么

• 创建并初始化研究项目，设定目标与范围
• 记录代理执行步骤（开始、完成、阻塞、检查点等）
• 发送优先级指令（普通/紧急）并等待确认
• 监控代理心跳，检测停滞或异常状态
• 生成截断上下文供LLM提示使用
• 标记项目完成或归档历史记录

使用说明

安装

brew tap 1645labs/tap
brew install julians-research-tracker

或使用Go直接安装：

go install github.com/1645labs/julians-research-tracker/cmd/research@latest

首次运行需执行数据库迁移：

research db migrate

基础 workflow

1. 初始化项目：

   research init market-q1 --name "Q1 Market Analysis" --objective "Analyze competitor pricing"

2. 代理记录进度：

   export RESEARCH_SESSION_ID="$SESSION_KEY"
   research log market-q1 STEP_BEGIN --step 1 --payload '{"task":"gather sources"}'
   # 执行工作...
   research log market-q1 STEP_COMPLETE --step 1
   research heartbeat market-q1

3. 主会话监控状态：

   research status market-q1 --json
   research list --json | jq '.[] | select(.needs_attention)'

4. 发送指令：

   research instruct market-q1 "Focus on enterprise segment" --priority URGENT

5. 代理检查停止信号：

   research check-stop market-q1  # 退出码0=停止，1=继续

输入与输出

见下方输入与输出表格。

风险提示

• SQLite数据库默认位于~/.config/research-tracker/，需确保目录权限正确
• WAL模式可能产生额外日志文件，勿手动删除
• 心跳超时阈值固定为5分钟，无法自定义
• STOP信号依赖代理主动轮询，非强制终止
• 审计标记（AUDIT_DRIFT）不会自动触发任何操作，需人工介入

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/julian1645/research-tracker/SKILL.md
来源类型：GitHub仓库