用途:审计 Dosu MCP 的 read_knowledge 调用对智能体会话轨迹的影响,从历史日志中找出亮点与失败,并输出 HTML 报告。
主要能力:
- 清点本地智能体日志,默认过去 30 天、全部项目;适配 Cursor、Claude、Codex,并有通用 JSON/JSONL walker(支持 Devin、Continue、Windsurf、DOSU_AGENT_LOG_DIRS 等)。
- 提取每次 read_knowledge 调用及其工具结果,按是否与问题和解决方案相关逐个判定,而非要求智能体唯一引用。
- 每条亮点需带 Review session 控件,在报告内打开时间线转录查看器,区分用户任务、发给 Dosu 的查询、返回知识、智能体后续推理与动作;结果不可恢复时明确标注“Result payload unavailable in this log source”。查看器为自包含 HTML 弹层,无网络依赖,支持键盘导航、Esc 关闭、代码块与复制按钮。
- 无效果、空、被拒的调用不隐藏,收在底部折叠的 No effect 区块并各自带查看器。分类 outcome 仅限 relevant、off_topic、empty、rejected、overflow、error、distracting,不使用 unused。
使用方式: DAYS=30 python3 "$SKILL_DIR/scripts/extract_read_knowledge.py" --days "$DAYS" --all-projects --out /tmp/rk-calls.json python3 "$SKILL_DIR/scripts/generate_impact_report.py" --findings /tmp/rk-findings.json --out /tmp/read-knowledge-impact.html --open 默认 30 天、全部项目;仅当用户明确说“本仓库”“上周”“仅 Claude”时才改参数(--days 按调用时间而非文件修改时间过滤)。运行前清空 /tmp/rk-calls.json、/tmp/rk-findings.json 与旧报告,且每次重新提取、重新分类,不复用旧结果。
限制:
- 该技能只做报告,不调用 write_knowledge。
- 不向用户追问智能体、日期范围、项目或粒度,一律用默认值。
- 报告中不得写入密钥、PII、原始日志转储;不编造提取器未发现的调用;不暴露原始文件系统路径;其他工具只保留有界预览,不输出完整原始载荷。
- 若提取到 0 次调用,仍生成空报告并停止。
- Cursor JSONL 转录常缺失工具结果载荷,此时查看器如实显示结果不可用;超大结果在可能时从 agent-tools/*.txt 旁文件恢复。
- 最终面向用户的输出为 HTML 报告加简短数字摘要。