SuperAPI AI 工具集

flow-journal

通用与其它

查看项目

更新于 10-16 08:33

技能介绍

用途:在项目工作过程中持续记录决策、需要知道的事实和部署操作,并准备会话接续文档。它不负责需求与任务跟踪,日记也不设“已完成/待办”栏目。

主要文件与目录:使用 .task/<KEY>/ 作为工作目录;无会话或工单指定时,可从分支中的工作标识或需求简称取名。目录名需唯一且不含路径分隔符。工作前先读取已有日记;如旧日记在别处,读作上下文并说明新文件位置,保留旧文件且不维护两份活动日记。.task/ 默认本地,应被 Git 忽略,并遵循项目对该目录的规定。主 agent 负责维护这些文件,汇总其他 agent 的结论并保留用户添加的笔记。

journal.md:在出现第一条有用信息时创建,包含 # PROJ-123 — Journal 及三个空段落:Décisions、À savoir、Mise en production。决策条目写真实日期时间、选择及理由,未采纳的建议不算决策;新决策替代旧决策时划掉旧条目并给出新条目,保留历史。À savoir 记录后续有用事实,如需重启的 worker 或测试环境限制,携带上下文而不粘贴完整工具输出。Mise en production 记录部署操作、环境、顺序与已验证命令;只有实际执行过的操作才可勾选,记录不等于授权执行。信息出现时即时写入,使用环境时间与真实时区;事后补记的旧决策不得编造时间。表述同一决策的补充内容合并,不重复条目。

reprise.md:在阶段结束或会话结束前更新既有跟踪后写入,替换旧接续点,保留仍有效的信息与用户笔记,区分已验证事实与不确定事项。内容含:更新日期、主题、阶段与当前任务;所需文档路径(含日记);未完成工作与未提交改动,不全部归因于 agent;最近验证、结果与待验证内容;问题、阻塞、待复审项及报告路径;已给出的决策与授权及其确切范围;下一项具体行动。只写有助于继续的信息,已完成阶段链接文档而不复制内容,未执行的验证如实标注,非 Flow 工作可注明“hors Flow”。

新会话恢复:读取接续点、日记和相关文档,与现有文件及有用的 Git 状态比对,缺失内容应重建而非假定文件已更新;沿用既有决策与授权范围,无新信息不重复追问已定选择。若可用,flow-ticket 接管工单恢复并使用本技能维护文件。要让该技能在用户未点名时也生效,需在项目说明中加入相应指令。