loop-5plus1-architecture

Source Metadata

Original cangjie-skill frontmatter from the distillation run:

name: loop-5plus1-architecture
description: |
  设计或审计完整 Loop 系统的组件架构: 5 大组件 + 1 根脊柱。
  当用户需要搭建一个完整的 (而非最小可用的) loop 系统、或审计现有系统的组件完整性时使用。
  不适用于: 最小可用 loop 的设计、或单次任务的自动化。
  关键 trigger: "设计一个完整的 loop 系统"、"我的 loop 缺什么"、"loop 系统怎么组织"。
source_book: "Loop Engineering 视频合集"
source_chapter: 视频3 (小木头) / 视频4 (Idoos Money)
tags: [architecture, system-design, components, blueprint]
related_skills: [loop-three-elements, maker-checker, goal-verification]

5+1 循环系统架构 — 完整 Loop 的设计蓝图

R — Reading (原文)

"ados money把它拆成了5块,外加一根脊柱。第一块心跳(定时触发),第二块工作树(work tree,隔离分支),第三块skill(项目规则),第四块连接器(MCP,接入真实工具),第五块子智能体(写代码和审代码分开)。最后就是那根脊柱——支撑起整个loop循环系统的记忆。" — 小木头 (视频3)

I — Interpretation (自述)

任何完整的 Loop 系统都可以拆解为 5 个组件 + 1 根脊柱:

1. 心跳 (Heartbeat): 定时触发器 (cron),到点自动启动循环。
2. 工作树 (Work Tree): 隔离的工作空间,多个 agent 并行时不踩踏。
3. Skill: 项目规则和约束,写入 SKILL.md,每个 agent 自动读取。
4. 连接器 (Connector): 通过 MCP 接入外部工具 (issue 系统、数据库等)。
5. 子智能体 (Sub-agent): 拆分生产和审查,避免自产自检。
6. 脊柱 (Spine): 持久化记忆层,记录历史操作、尝试结果、待办事项。

脊柱是关键: Agent 会遗忘 (上下文有限),所以必须在对话之外建立持久化记忆。

A1 — Past Application (书中案例)

案例1: Boris 的多 Loop 系统 (视频2)

• 心跳: 每 30 分钟触发 support loop
• Work Tree: 每个 agent 独立分支
• Skill: 项目规则写入 agents.md
• 连接器: MCP 接入 Intercom、Stripe、Supabase
• 子智能体: 写代码和审代码分开
• 脊柱: 共享 signals 文件夹

案例2: 选题 Loop (视频3)

• 心跳: 每天早上 8 点 cron
• Work Tree: 独立分支
• Skill: research + topic-score 技能
• 连接器: research API
• 子智能体: topic-score 作为评级 agent
• 脊柱: inbox.md 文件

A2 — Future Trigger (未来触发)

1. 搭建完整 loop 系统时: "我要做一个完整的 X 自动化系统"
2. 审计现有系统时: "我的 loop 缺什么组件?"
3. 从单 loop 扩展到多 loop 时: "怎么让多个 loop 协同?"
4. 团队推广 loop 时: 用这个架构作为"完整 loop 长什么样"的蓝图

语言信号: "设计一个完整的 loop 系统"、"我的 loop 缺什么"、"loop 系统怎么组织"、"多 loop 协同"

与相邻 skill 的区别:

• loop-three-elements: 最小可用单元 (本 skill 是完整系统)
• maker-checker: 子智能体分工的具体实现 (本 skill 是整体架构)
• loop-build-path: 构建步骤 (本 skill 是静态结构)

E — Execution (可执行步骤)

Step 1: 审计现有系统

对照 5+1 清单,逐项检查:

□ 心跳: 有定时/事件触发吗?
□ Work Tree: 有隔离工作空间吗?
□ Skill: 规则写成了 SKILL.md 吗?
□ 连接器: 接入了外部工具吗?
□ 子智能体: 生产和审查分开了吗?
□ 脊柱: 有持久化记忆吗?