用途:维护共享工作流日志,仅在用户明确触发,或其它技能/工作流提供日志路径或要求日志时使用。目标是让下一轮流程无需阅读聊天记录即可继续,只记录无法从关联产物或当前 diff 中直接看出的工作流状态。
位置:日志创建在 docs/workflows/YYYY-MM-DD_HH:MM_<workflow-name>_<short-name>.md;若 docs/workflows/ 不存在则先创建。
规则:行动前先读当前日志;## Timeline 只追加;## Current State、## Scope、## Artifacts、## Open Findings 可变;链接源请求(有 plan/design 产物时链接它,否则复制用户请求);## Artifacts 只放产物链接;变更开始前记录基线(base ref、起始脏文件或明确范围边界);链接每个创建或消费的产物;不把实现文件列为产物;记录偏离预期计划、任务、设计或先前交接之处;记录可能导致后续重复错误的发现;明确记录发现处置;不复制已存在于关联产物中的内容;不粘贴命令输出,只记录命令、结果和产物链接;不依赖聊天历史。
应写内容:工作流状态与下一轮;源请求与评审基线;产物链接(计划、评审、审计、裁决、截图、测试报告);派发裁判及其 worker 使用的 provider、模型线与推理级别;偏离;未来轮次必须考虑的非显然发现;影响后续阶段的决策;未决发现及处置;影响下一步的验证命令与结果;阻塞、升级与未解决交接说明。不应写:diff 已显示的文件列表、常规命令输出、产物已捕获的通用总结、不影响下一步的风格说明、实现产物。
状态行:每条时间线条目必须恰好包含一个状态行:STATUS: DONE、STATUS: BLOCKED: <reason> 或 STATUS: ESCALATE: <reason>。缺少输入或前置条件失败用 BLOCKED,需要人工决策用 ESCALATE。
结构:包含 # Workflow Log: <Name>,以及 ## Current State、## Scope、## Artifacts、## Open Findings、## Decisions and Deviations、## Timeline 等小节,字段与格式按资料给定。发现处置使用 fix now、follow-up、waiver;裁判综合时还可记为 duplicate、out of scope、rejected with evidence、blocked。任何实质性发现不得无声消失。
限制:资料未提供安装方式、平台、收费或价格信息。