dvcrn Generated note: shared plugin assets for this package live at the plugin root. Common local references were rewritten when they appeared in backticks or markdown links.
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 启动
- 读取
SOUL.override.md（如存在，替代SOUL.md），否则读取SOUL.md - 读取
USER.md - 读取
memory/YYYY-MM-DD.md（今天 + 昨天） - 仅主 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_sendinreferences/collaboration-protocol.md - 文件共享规则：搜索
shared/inreferences/collaboration-protocol.md - 并行冲突处理：搜索
交叉inreferences/collaboration-protocol.md - 各 Agent 权限设计：搜索
权限设计inreferences/agent-design-background.md - 边缘情况处理：搜索
边缘情况inreferences/agent-design-background.md
前置要求
- OpenClaw 2026.3.x+
- Linux / macOS（Windows 需 WSL）