opsx-worklog — 任务现场记录
定位
维护项目内 .agent/WORKLOG.md。它是短期现场层：帮助意外中断后恢复当前任务，不是长期知识库、不是变更日志、也不是会话交接快照。
三层分工：
| 层级 | 文件 | 目的 |
|---|---|---|
| 现场 | .agent/WORKLOG.md |
当前任务分钟到小时级现场 |
| 快照 | .agent/SESSION_HANDOVER.md |
下次会话入口，由 opsx-handover 维护 |
| 沉淀 | README / ARCHITECTURE / ROADMAP / PRINCIPLES / docs | 长期知识，由 opsx-tidyup 或即时编辑维护 |
使用时机
在以下情况维护 WORKLOG：
- 开始非平凡任务：多步骤、跨文件、可能中断、需要后续验证。
- 完成一组文件修改：记录改了什么、还有什么未验证。
- 发现阻塞或改变方向：记录原因和下一步。
- 任务仍在进行中但可能稍后 handover：记录当前现场，供
opsx-handover读取。 - 准备 tidyup：标出哪些事实已稳定、建议同步到哪些文档。
普通单问单答、小改动、一次性解释，不需要创建或更新 WORKLOG。
工作流
- 找到项目根目录。
- 检查
.agent/WORKLOG.md是否存在；不存在则按references/worklog-template.md创建。 - 读取现有 WORKLOG，判断当前任务是否已有现场。
- 只更新必要段落：通常是「当前现场」「最近记录」「未同步事实 / TBD」。
- 保持滚动：删除或压缩已经沉淀到稳定文档的旧内容。
- 回复用户时简要说明 WORKLOG 更新了什么。
写入规则
- 每条记录控制在 3-8 行。
- 使用绝对日期时间：
YYYY-MM-DD HH:mm。 - 写清楚已读文件、已改文件、当前阻塞和下一步。
- 不记录 secrets、tokens、私钥、本地敏感路径。
- 不把长期结论只留在 WORKLOG；稳定后应同步到稳定文档。
- 不做 append-only 流水账；旧现场要滚动清理。
推荐结构
默认结构见 references/worklog-template.md。如果项目已有 WORKLOG 格式，优先尊重项目现有格式，只做最小兼容更新。
清理规则
详见 references/cleanup-rules.md。核心原则：
- 保留当前未完成任务现场。
- 保留未同步事实、阻塞点、未验证风险。
- 压缩已完成且已沉淀的条目。
- 删除已经没有恢复价值的旧流水账。
与其他 skill 的关系
opsx-handover：优先读取 WORKLOG 生成会话快照。opsx-tidyup：从 WORKLOG 提炼稳定事实，并反向清理已同步条目。
完成回复格式
已更新 `.agent/WORKLOG.md`：
- 当前现场：<一句话>
- 已记录：<关键文件/阻塞/下一步>
- 仍待同步：<如有，建议同步到哪个稳定文档>
