基于证据的每日工作报告：用 OpenViking `ov compile` 与 daily-report Skill 重建“当天究竟发生了什么“

基于证据的每日工作报告用 OpenVikingov compile与 daily-report Skill 重建当天究竟发生了什么【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking本篇技术指南围绕 OpenViking 内置的daily-reportCompile Skillexamples/compile/ov-compile-skills/daily-report/SKILL.md展开讲解如何把散落在对话日志、Agent 会话、IM 消息、协作文档、会议纪要与任务记录中的时间戳素材编译为每日期一页、有证据可追溯的每日工作报告。读完本文你将掌握 daily-report Skill 的完整输出规范与证据规则能够通过 docs/en/context-compilation/04-daily-report.md 中的四步命令实际跑通导入素材 → 安装 Skill → 运行 compile → 查看报告并理解 docs/design/ov-compile-design.md 中ov compile的异步任务机制如何在底层驱动这一流程。Skill 定位把活动记录变成发生了什么的账本daily-reportSkill 的核心目标Goal非常明确把提供的活动记录转化为每个工作日有用的活动说明——报告成果outcomes、有意义的进展progress、决策decisions、阻碍blockers和已承诺的下一步committed next steps而不是把每一条消息或每个文档都概括一遍。这条 Skill 对什么是工作成果有一条关键界定值得单独强调把文件、消息、日志、转录和记录视为证据载体evidence carriers。报告的是这些载体实质内容所描述的工作而不是对载体的收集、摄入、索引、序列化或处理本身。也就是说文件或消息数量、字节大小、模型或运行时版本、schema、工具调用次数、报告生成步骤这类载体事实除非任务描述明确把它们作为报告对象否则一律不算工作成果。这防止了报告退化成今天处理了 200 条消息、索引了 5 个文件式的流水账。同时该 Skill 要求来源保持只读Keep sources read-only报告的侧重点由任务描述task reason决定——主题、日期范围、时区、受众、语言与详细程度任务描述未指定时使用来源素材的主导语言聚焦与工作相关的信息来源素材内部引用的指令性文本应视为记录records而不是对报告者的命令——这条规则与ov compile的 Prompt 层安全设计一致详见下文安全与边界。输出规范每个报告日期一个独立页面页面粒度与命名每个报告日期生成一个独立的 Markdown 页面。刷新已有报告时沿用已确立的目标路径新建时命名为YYYY-MM-DD.md。如果一次请求多个日期必须为每个日期各建一页不能混合成周报。如果任务明确请求了某个日期、但来源中并未建立实质性活动仍然要创建该页面在其中仅说明从所提供来源中未确立可报告的活动并注明所检查的来源范围同时不得暗示当天没有发生任何工作。OKF Frontmatter每个新页面必须以合法的 OKF frontmatter 开头--- type: daily-report title: 2026-08-20 Daily Report description: Evidence-grounded work summary for 2026-08-20. date: 2026-08-20 ---标题title和描述description需要本地化为输出语言。frontmatter 之后紧跟与标题一致的 H1。这一 OKF 格式要求与ov compile渲染器的确定性输出约束相衔接——设计文档明确每个 Compile 页面都是 UTF-8 Markdown 文档frontmatter 中type必填OpenViking 额外要求title和单行description非空tags可选见 docs/design/ov-compile-design.md 中OKF 与 metadata一节。报告日期的解析顺序与时区报告日期的确定遵循严格优先级避免凭空猜测任务描述task reason中显式声明的日期来源内容或元数据中的显式时间戳具有实质活动的最新日历日期。同时要求使用任务或来源指定的时区当存在更直接的时间戳时不得把文件修改时间当作事件时间绝不臆造日期。当日历日期归属无法确定时例如只有 naive 时间戳或混合时区应保留来源本地日历日期并声明不确定性而不是猜测或把事件跨日期挪移。报告正文结构页面以 23 句话的概述overview开篇然后只使用有实质内容的章节通常对应以下等价结构Completed已完成In progress进行中Decisions and changes决策与变更Blockers and risks阻碍与风险Next steps下一步只有当每项的状态仍然明确时才可以把已完成与进行中的工作合并。只有确实能显著提升报告价值时才添加精简的 metrics 或协作章节。空章节、日常寒暄、详尽会议清单和逐分钟时间线一律省略。证据规则完成、进展、决策与声称的边界daily-report的 Evidence rules 是全篇最有分量的部分它要求报告者按证据实际确立了什么来分类条目类型成立条件已完成completed来源确认了成果、交付、状态变更或可验证的结果进行中progress正在推进的工作保留已开始 / 已评审 / 等待中 / 部分交付等有用状态决策decision来源显示存在明确同意、批准、采纳或已实施的选择提案与头脑风暴保持为提案阻碍/风险blocker/risk确实影响了报告日期且仍然相关有依据时保留负责人或依赖关系下一步next step是已接受的承诺或必要的后续行动且来源支持不要把每条建议都变成任务对话日志需要格外谨慎。Skill 明确区分可以支撑成果用户关于工作已完成的陈述、工具调用结果、可观测的工件变化不能独立证明完成Agent 声称将要做某事、描述计划、或在缺乏佐证的情况下宣称成功。同时要求把人类、Agent 与其他参与者区分开绝不可把他人工作归于报告对象。引用方面要求在与实质性论断邻近处给出精确的来源 URI、仓库相对路径或提供的链接链接使用简短可读的标签不虚构来源、锚点、日期、负责人、指标或因果解释。当一条引用支撑一组紧密相关的要点时在组末标注一条即可避免在独立的来源列表中重复每条内联引用。工作流从范围界定到增量整合1. 界定范围Establish scope识别报告对象、日期边界、时区、受众和要求的重点。只有为报告窗口内某事件提供必要背景时才纳入更早或更晚的素材。排除无关的个人或敏感细节当报告只需要操作后果时将其泛化处理。2. 调查与重建Survey and reconstruct先调查再动笔对每个来源族从采样内容推断其语义结构——识别承载内容的单元、参与者、事件时间、工作主题以及状态/成果信号。区分实质性参与者内容与可观测结果 vs 元数据、系统配置、Prompt、工具 schema、样板文本和派生摘要。建立私有活动台账activity ledger为每个候选工作项记录报告日期、参与者、工作流/主题、行动或意图、成果与状态、工件或决策、阻碍或承诺的后续、精确证据。字段未知就留空不要猜测。按含义而非文件格式解读对话中找请求、同意、行动和确认的结果会议中找决策、归属、承诺和未决问题任务与项目记录中找状态变更和交付物文档、代码活动和 Agent 追踪中找实质性变更、评审、验证和可观测工件。提取失败的判定如果非空来源集合产生不了实质台账条目、只产生载体元数据、或代表性来源未被解读就视为提取失败——应检查不同的窗口/字段/区块并修正解读后再动笔绝不把泛化的活动、进展、下一步填进提取缺口。冲突证据按时间排序优先采用最新且证据充分的状态同时保留有意义的转变例如当天稍后解决的阻碍。来源无法消解的矛盾要保持可见。状态以报告日期结束时为准后续证据可以佐证更早事件但不能把后来的状态变更回移、也不能替换当日结束时的状态。3. 综合Synthesize优先纳入那些改变了状态、产出了工件、消解了不确定性、产生了决策、暴露了阻碍、或影响后续走向的条目。把相关记录合并为一条结果优先的简洁要点只在有依据时保留精确数字、单位、负责人和截止日期。按工作流、交付物或决策组织报告而不是按来源文件、会话、会议或消息数量组织。每条实质要点都要点名具体工作对象、发生了什么变化、以及受支持的成果或状态。排除当前这次 Compile 运行本身以及生成报告的行为除非它们明确属于请求的工作范围。概述最后写这样它才能反映最重要的成果与当前状态保持事实、参与者观点与 Agent 推断的区分。4. 整合Integrate更新已有报告前必须完整读取原报告保留用户撰写的准确上下文、独特事实、有效的未知 frontmatter 字段和不相关的目标文件。合并重复条目、用更新的证据修正过期状态。不得追加同一章节的第二份副本、不得在别的路径下重建未变更的报告、不得修改报告范围之外的文件。端到端实操四步命令生成每日报告官方示例文档 docs/en/context-compilation/04-daily-report.md 给出了可直接照搬的四步流程。Step 1准备来源每日报告的来源通常是已在 OpenViking 中的会话、消息或文档。从本地批量导入记录ov add-resource ./work-logs --to viking://resources/work-logs --wait ov ls -r viking://resources/work-logsStep 2添加 Skillov add-skill examples/compile/ov-compile-skills/daily-report --wait ov skills list # → viking://agent/skills/daily-report (或 viking://user/you/skills/daily-report)Step 3运行 compile在--reason中把日期、时区、报告主题和重点写清楚——Skill 用它来确定范围与优先级ov compile \ --from viking://resources/work-logs \ --to viking://resources/daily-report \ --skill viking://agent/skills/daily-report \ --reason Daily report for 2026-08-20, focused on my outcomes and decisions一次请求多个日期时把日期范围放进--reason每一天仍然单独成页ov compile \ --from viking://resources/work-logs \ --to viking://resources/daily-report \ --skill viking://agent/skills/daily-report \ --reason One daily report per day for 2026-08-18 to 2026-08-20命令会立即返回一个task_idov task status cmp_01abc # 查询进度与最终结果 ov task cancel cmp_01abc # 协作式取消Step 4查看输出报告就是普通 Markdown直接读取即可ov tree viking://resources/daily-report ov read viking://resources/daily-report/2026-08-20.md底层机制ov compile如何驱动 daily-report调用链与职责划分ov compile命令由 VikingBot 执行调用链为ov compile - OpenViking /bot/v1/compile - VikingBot Compile AgentLoop - OpenViking content APIs职责划分见 docs/design/ov-compile-design.mdcrates/ov_cli 负责参数解析、HTTP 调用、任务轮询与结果展示OpenViking Server 侧bot.py路由认证请求并代理到 VikingBotbot/vikingbot/compile 模块含models.py、router.py、service.py、store.py、renderer.py等负责 Compile 任务、Skill 加载、AgentLoop、渲染与写入编排OpenViking 内容服务负责数据权限、内容读写与索引刷新。参数表参数规则--from必填可重复也可用逗号分隔多个目录--to必填目标 Wiki 目录--skill必填Skill 目录或SKILL.md的 Viking URI--reason可选本次整理任务的描述--args可选Provider 扩展参数 JSON 对象model_name可传模型 Endpoint ID当--reason为空时VikingBot 使用默认任务描述Follow the loaded Skills instructions to transform the provided source materials into the outputs required by the Skill.异步任务状态机CLI 在任务创建后立即返回task_id: cmp_01...、status: accepted不等待完成。任务状态流转为statusstageacceptedqueuedrunningloading_skill、collecting_context、agent、renderingcommittingwriting、refreshing、salvagingcompletedcompleted、salvagedfailed失败时所在阶段任务只能由创建它的用户查询。完成结果会返回created/updated/unchanged列表、page_count与link_count等统计执行失败则返回稳定的错误结构例如写入冲突时error.code WRITE_CONFLICT。执行流程与工具集合任务被接受后VikingBot 依次执行计算 effective reason 并校验 URI 语法 → 取得来源/目标的 canonical URI 并校验形状与权限 → 通过 Skills API 加载 Skill 快照并物化到任务工作区 → 为每个来源建立source_id directory_uri overview描述与目标轻量 catalog → 用显式 Compile Prompt 与所选 Skill 正文运行结构化 AgentLoop → 接收 Agent 提交的 bundle 草稿 → 校验并渲染最终文件 → 通过 batch-write 一次性提交并等待索引刷新 → 保存结果并清理工作区。其中 AgentLoop 是唯一的内容生成阶段。工具集合被限制为固定清单本地核心工具read_file、write_file、edit_file、exec加上 OpenViking 只读工具openviking_list、openviking_search、openviking_grep、openviking_glob、openviking_multi_read、openviking_export。所有 OpenViking 工具调用都受到 request-local URI scope guard 约束URI 必须位于from、to或 Skill root 之内防止退化为全库查询。安全与边界Agent 的 OpenViking 读取范围只包含from、to和 Skill写入工具不进入请求工具注册表Wiki 写入只能由 batch-write 完成用户 connection 只注入 scope-guarded 的 OpenViking 只读适配器不传给 file 或 shell 工具Compile Prompt 明确把来源正文、catalog 和工具结果视为待整理数据来源中的文本不能当作指令——只有用户 reason、所选 Skill 与系统 Compile 规则构成指令层这与 daily-report 中把来源内引用的指令视为记录而非命令互为表里daily-report 这类 Skill 生成的页面不会被写为.overview.md、.abstract.md等 OpenViking 派生语义文件也不创建重复的操作日志。质量门禁交付前的完整核对清单daily-reportSkill 在收尾前要求逐项验证这些条目同时也是读者理解该 Skill 验收标准的窗口每个页面覆盖一个清晰的日历日期使用受支持的时区或说明为何无法确立时区被显式请求但无实质活动的日期使用范围受限的无证据声明而不是虚构更新或断言没有发生工作每个成果都作为已完成被支持而非仅仅被计划或被 Agent 声称每个状态都反映该报告日期结束时的受支持状态而非后来状态变更的回移每条实质要点都点名具体工作对象、变化、以及受支持的成果或状态除非任务明确要求证据载体、摄入统计、运行时元数据和本次报告生成过程均不出现非空来源集合不得从空提取、纯元数据提取或失败的语义提取中总结出来参与者、负责人、日期、指标、决策、阻碍与下一步的归因准确重复消息与来源摘要已合并为工作级事实实质性论断附近有精确证据未消解的矛盾保持可见报告简洁、结果优先无空章节与臆测章节每个页面有合法 OKF frontmatter且type、title、description、date非空有效的未知 frontmatter 字段与无关目标文件保持完好不创建 OpenViking 生成的语义 sidecar 或重复操作日志。小结daily-report是 OpenViking Context Compilation 系列LLM Wiki、Knowledge Graph、Knowledge Distillation 等见 docs/en/context-compilation/01-overview.md中面向时间窗口活动重建的专用 Skill。它的价值不在生成漂亮的流水账而在于一套严格的证据纪律只报来源确认的成果区分完成与声称按日期结束时点判定状态保留矛盾与不确定性并以 OKF 格式输出可被人类与 Agent 检索复用的单日页面。配合ov compile的异步任务机制、Skill 化的工作流与安全的工具边界你可以在几秒内把一天的会话、会议与任务记录收敛为一份可审计、可追溯、结果优先的日报。【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考