用途:Deepwork 是用于重型编码会话的编排器工作流,仅适用于明显大型或高风险的工作,例如多个相互依赖的阶段、跨领域架构变更、不宜部分交付的迁移,或需要跨多个专家通道持续协调的任务。不要因为任务涉及多个文件就使用它,也不用于琐碎编辑、快速文档修改、简单缺陷修复或常规有界功能。
主要能力与使用方式:启用后,编排器须以调度器角色管理工作,而非默认实现工人。在 .slim/deepwork/ 下创建并维护本地 markdown 进度文件,代码与文档交付物保存到项目路径(如 src/、docs/),.slim/deepwork/ 仅用于进度文件。创建任务文件如 .slim/deepwork/<short-task-slug>.md 前,先检查 .gitignore 与 .ignore,仅补充缺失条目,避免重复:# .gitignore 加 .slim/deepwork/;# .ignore 加 !.slim/deepwork/ 与 !.slim/deepwork/**。文件不套固定模板,需记录当前目标与理解、来自 @librarian 的研究事实、计划草稿、Oracle 评审预算与门禁、实现阶段与状态、验证结果、未决问题与阻塞项。
流程:实现前先起草计划,划分少量连贯阶段,为每阶段后设强制 @oracle 评审,并在文件中记录阶段顺序、负责人、门禁顺序与理由,向用户分享精简版。每阶段前替换 todo 列表为可执行交付项。执行前决定并行、串行、专家委派与通道拆分。使用调度器纪律:记录任务/会话 ID 与归属边界,等待钩子驱动后台完成,避免阻塞编排器通道,相关作业运行中不进入下一阶段。每阶段后运行验证、更新文件、请求 @oracle 门禁;若改变模块边界、依赖方向或文件位置,并行运行 @explorer 结构扫描。每个门禁仅一次初始评审、最多两次复审,仅当整改实质改变决策或风险时才复审,耗尽后记录剩余风险并由用户决定。@designer 交付的 UI/UX 视为后续阶段的既定设计意图,视觉、响应式、动效等变更须交回 @designer,@fixer 仅做不改变设计的机械跟进。最后进行终验证与简要总结。限制:不适用于常规或小任务;资料未提供成本、平台与其他细节。