DevLoop Workflow — 多 Agent 协作系统

产品驱动开发闭环 — 开箱即用的多 Agent 协作系统，覆盖从产品热点探索到开发测试上线的完整生命周期。

Agent 清单

Agent	ID	Emoji	职责
Product	devloop-product	🎯	每日 AI 热点探索、产品方向讨论、PRD 生成
Core Dev	devloop-core-dev	🧠	架构设计（7 维度）、设计文档、Dev 调度
Dev	devloop-dev	⚡	精准编码、多实例并行、按设计文档实现
Test	devloop-test	🧪	测试先行、Bug 趋势追踪、代码审查
Marketing	devloop-marketing	📣	商业化调研、宣传策略、文案制作
Research	devloop-research	🔬	深度调研、竞品分析、技术评估

核心工作流

阶段一：产品发现
  [Cron 触发] → 🎯 Product（热点探索 + 历史对比）

阶段二：方向讨论与 PRD
  用户 ↔ 🎯 Product 多轮讨论 → 确认方向 → 生成 PRD
       → 通知 🧠 Core Dev + 📣 Marketing

阶段三：设计与调度
  🧠 Core Dev（7维度讨论→设计文档→复杂度评估→调度）
       → 分配任务给 ⚡ Dev (×N)
       → 通知 🧪 Test 准备测试规格

阶段四：测试先行
  🧪 Test（读取设计文档 → 生成测试规格 → 通知 Dev 参考）

阶段五：编码实现
  ⚡ Dev ×N（严格按设计文档编码 → Conventional Commits → 报告完成）

阶段六：测试与合并
  🧪 Test（代码审查 + 测试执行 + Bug 记录）
  🧠 Core Dev 确认质量 → 合并到 main
       → 📣 Marketing（上线宣传）

完整的阶段细节、消息路由表和并行冲突预防规则，参见 references/collaboration-protocol.md。

通用工作规范

Session 启动

1. 读取 SOUL.override.md（如存在，替代 SOUL.md），否则读取 SOUL.md
2. 读取 USER.md
3. 读取 memory/YYYY-MM-DD.md（今天 + 昨天）
4. 仅主 session：读取 MEMORY.md

首次启动：若 BOOTSTRAP.md 存在，按其指引初始化后删除。

记忆管理

类型	路径	说明
每日笔记	memory/YYYY-MM-DD.md	当日工作日志（平面文件，不建子目录）
主题笔记	memory/YYYY-MM-DD-<suffix>.md	按主题的专项日志
长期记忆	MEMORY.md	跨 session 持久知识（仅主 session 加载，含私人上下文）

想记住的东西必须写文件。"心里记住"在 session 结束后消失。

Agent 协作

通过 sessions_send 通信。共享文件通过各自 workspace 的 shared/ 目录（只读消费，不修改，不用 ../ 路径）。

自定义

优先级：SOUL.override.md > SOUL.md > 各 Agent .md

安全

• 不泄露私人数据
• 破坏性命令先确认
• trash > rm

模板文件

所有模板位于本 skill 的 assets/templates/ 目录。Agent 首次创建文件时，读取对应模板并按实际内容填充。

模板文件	用途	使用者
project-structure.template.md	项目知识库结构	Product, Marketing
design-doc.template.md	功能设计文档	Core Dev
design-index.template.md	设计文档索引	Core Dev
test-spec.template.md	测试规格文档	Test
daily-report.template.md	每日测试报告	Test
bug-tracker.template.md	Bug 追踪数据库	Test
review-notes.template.md	PR 审查笔记	Test
bug-trend.template.md	Bug 趋势汇总（MEMORY.md 用）	Test
memory-tracking.template.md	调研方向追踪表（MEMORY.md 用）	Product, Marketing

参考资料

需要深入了解时，加载以下 references 文件：

文件	何时加载	内容
references/collaboration-protocol.md	需要了解 Agent 间通信细节、消息格式、文件共享规则、完整工作流阶段细节时	完整协作协议、消息路由表、共享目录约定、并行冲突预防
references/agent-design-background.md	需要理解设计决策背景、处理边缘情况时	各 Agent 的设计理念、权限说明、边缘情况处理方案

快速查找关键信息：

• Agent 间消息格式：搜索 sessions_send in references/collaboration-protocol.md
• 文件共享规则：搜索 shared/ in references/collaboration-protocol.md
• 并行冲突处理：搜索 交叉 in references/collaboration-protocol.md
• 各 Agent 权限设计：搜索 权限设计 in references/agent-design-background.md
• 边缘情况处理：搜索 边缘情况 in references/agent-design-background.md

前置要求

• OpenClaw 2026.3.x+
• Linux / macOS（Windows 需 WSL）