当任务完成、解决困难问题、用户要求总结经验/记录项目理解/更新项目规范,或 spec-end/spec-update 需要从当前 Spec 文档判断是否沉淀经验、知识、SOP、工具记忆、长期项目规范时使用。不要用于普通文档摘要、历史记忆检索或已明确内容的直接写入。
记忆写入 Skill,将重大经验写入 spec/context/experience/ 或知识记忆写入 spec/context/knowledge/,并更新对应索引(不写 MEMORY.md)。触发场景:exp-reflect 确认后、手动添加经验或知识。仅处理经验记忆和知识记忆,程序记忆使用 skill-creator,工具记忆直接编辑 Skill。
当一个完整 Spec 的计划、实现、测试阶段都已完成,且角色 spec-ender 进入阶段五收尾时使用: 收集角色经验、触发 exp-reflect、审查项目规范、询问归档,并完成提交、推送、创建 PR。 不要用于功能实现中途、测试未完成时,或 spec-update 的小迭代收尾。
当项目首次接入 Spec 驱动开发 / R&K Flow,需要创建 AGENTS.md、.agents/rules/、 .agents/skills/、spec/ 目录、记忆系统和 Obsidian Vault 时使用。 典型信号:用户说"初始化项目"/"搭建 Spec 环境"/"创建开发环境",或项目根目录缺少 AGENTS.md / spec/。 不要用于已有项目的单个 Spec 开发、功能更新或少量规范修改。
当同一个活跃 Spec 在当前工作分支内需要小迭代、补充需求、修正方案或优化实现,且原 Spec 目录已有 writer/plan.md + executor/summary.md 时使用。默认复用 writer/plan.md 记录的 git_branch,不新建分支。不要用于新功能从零设计、已合并/已关闭分支上的后续需求,或需要独立 PR 的较大变更。
诊断并修复 Spec 执行过程中发现的问题。由角色 spec-debugger 调用。 触发条件:(1) 角色 spec-debugger 接收到 TeamLead 转交的 bug handoff, (2) spec-executor 执行后出现 bug 或 writer/plan.md 中未考虑到的情况, (3) 运行时出现问题、依赖环境或配置问题。 不修改已确认的 writer/plan.md,而是在 debugger/ 下创建独立的诊断文档(debug-xxx.md)和修复总结(debug-xxx-fix.md)。 修复完成后向 TeamLead 提交重新验证请求,由 TeamLead 启动 spec-tester。
严格按 writer/plan.md 执行新功能开发。由角色 spec-executor 调用。 触发条件:(1) 角色 spec-executor 需要按 writer/plan.md 实现代码, (2) 用户说"执行 Spec"/"开始实现", (3) 当前 Spec 目录下存在 writer/plan.md 但没有 executor/summary.md。 注意:v2.0 起移除路径 B(agent-teams)和测试步骤,spec-execute 只有单一职责: 按 writer/plan.md 实现代码,产出 executor/summary.md,并交接给测试阶段。 如果目录下已有 executor/summary.md,应使用 spec-update。
Spec 创建前的信息收集与探索。由角色 spec-explorer 调用。 触发条件:(1) 角色 spec-explorer 需要在 Spec 创建前收集背景信息, (2) 需要检索历史经验(exp-search), (3) 需要探索项目代码库、外部文档或第三方库, (4) TeamLead 通知 spec-explorer 开始工作。