用途:从调用方显式提供的会话、shell、RTK 或 CASS 历史中挖掘重复性“苦役”(toil),输出带证据的排序报告,供调用方决策。触发语为“mine toil”“find repeated operational work”。
主要能力:只读分析所提供来源;归一化重复的人类操作,排除机器回声与生成式重复;聚类等价操作并保留代表性证据引用;按测量到的频率、成本(耗时或 token)与易错率三项乘积打分排序;区分观察与建议。
使用方式:先记录输入来源、时间窗口、过滤条件与查询。对调用方提供的 Codex JSONL,使用确定性辅助脚本而非临时扫描:
python3 skills/toil-mining/scripts/recent_human.py --since 2026-07-12T00:00:00Z
--until 2026-07-16T00:00:00Z /path/to/session-a.jsonl /path/to/session-b.jsonl \
/tmp/recent-human.json
该脚本仅接受显式会话路径与带时区的窗口,提取 event_msg / user_message 记录,输出 source_path、行号、UTC 时间戳与请求文本;按 client_id 去重并保留最早出现;无 client_id 的记录标记为 missing_client_id,不猜测为人类;排除内部上下文标签、refuter 提示与 agent 信封并报告计数。仅读所给 JSONL,仅写 stdout。
阈值与排序:一个聚类至少出现三次且每次可解析到来源引用才算 toil;不足则报告为低于阈值并给出实际计数。排序按频率×成本×易错率的乘积,三项输入须与综合分并列展示;历史无法支撑的因子按下限报告,不取中间值猜测。
输出:仅当调用方要求本地产物时写入 .agents/scratch/toil-mining/YYYY-MM-DD-candidates.md,否则内联返回报告,并列出已检查与未检查来源;不包含负责人、优先级、队列或下一步行动。
限制:不创建工单、不安排自动化、不指定负责人、不修改来源;不读取附件内容、不发现更多会话、不做语义聚类、不打分、不归档工作。其余细节暂未提供。