用途:Work Artifacts 用于把工作锚定到一个工作项(work item),让产物保存在磁盘上,而不是只存在于上下文里。资料强调:活跃产物存放在工作目录中,它是你、用户与其他智能体之间的共享状态;如果理解没有落到磁盘,就不会留存。产出发现、决策与设计产物时应随手写入,并频繁提交,因为会话可能崩溃或被压缩。
主要能力与用法: 查找工作目录:spawn 会自动获得 $MERIDIAN_ACTIVE_WORK_DIR;若该环境变量过期或未设置,可用 meridian work current(环境变量在会话中途不会更新)。 启动工作:并非每次 spawn 都需要工作项,小型直接任务可以不带。需要工作范围产物或生命周期跟踪时: meridian work start "descriptive name" # 创建并附加 meridian work switch descriptive-name # 附加到已有工作项 meridian work # 仪表盘,查看进行中的工作 spawn 会自动继承附加关系。 状态与完成:编排器拥有工作状态,子智能体除非被明确指示,不应修改它,因为并发修改会产生竞态条件。状态值可自由填写,保持当前阶段可见: meridian work update auth-refactor --status designing meridian work done auth-refactor # 归档工作目录,分离会话 meridian work clear # 分离但不归档 只有在你拥有整个生命周期时才执行 work done,而不只是其中一段。打开 PR 并不等于完成工作项,应把状态更新为 pr-open 或 awaiting-merge,并保持活跃直到合并与清理。
产物放置:工作目录(meridian work current)放本工作项的产物;kb($MERIDIAN_CONTEXT_KB_DIR)放项目范围的参考资料。经验规则:属于本工作项 → 工作目录;项目范围 → kb。设计决策写入设计文档,实现决策写入提交信息或行内注释,结构性决策写入工作目录。记录被否决的备选方案,可防止重复提出已考虑过的方案。
限制与补充:资料未提供安装方式、收费、平台支持或效果数据。详细生命周期管理(仪表盘命令、状态转换、完成规则、归档)见 resources/lifecycle.md。