用途:在评审或分析流程中捕获可复现证据,让发现可追溯到具体命令、输出或来源,适用于需要审计留痕、可验证结论的场景;快速非正式检查或仅需结构化输出时不适用。
主要能力:按四个步骤组织证据日志。第一步初始化日志,记录会话或评审标识、仓库/分支/提交哈希、分析者身份与范围,并约定引用命名(如 [E1]、[E2])。第二步捕获命令,记录完整命令与参数、相关输出片段、时间戳及工作目录环境。第三步记录引用,登记外部来源、章节、相关性、文档版本及 AI 辅助分析上下文。第四步索引产物,编目截图、图表、报告、查询结果等,提供路径或内联内容并注明保留策略。
使用方式:通过关键词 evidence、proof、trace、audit、reproducible、citation、source、verify 等触发,或出现“展示你的工作”“如何验证”“引用来源”“创建审计轨迹”等提示时自动加载。需完成四个 TodoWrite 项:evidence-logging:log-initialized、evidence-logging:commands-captured、evidence-logging:citations-recorded、evidence-logging:artifacts-indexed。发现中采用统一引用格式,如 Finding: ... [E3, C2]。
限制:资料未提供具体安装命令、平台支持、收费与价格信息;常见问题包括命令未找到(需确保依赖已安装并在 PATH 中)、权限错误(检查文件权限并以适当权限运行)、异常行为(可用 --verbose 启用详细日志)。