# Loop 5plus1 Architecture

> 设计或审计完整 Loop 系统的组件架构: 5 大组件 + 1 根脊柱。 当用户需要搭建一个完整的 (而非最小可用的) loop 系统、或审计现有系统的组件完整性时使用。 不适用于: 最小可用 loop 的设计、或单次任务的自动化。 关键 trigger: "设计一个完整的 loop 系统"、"我的 loop 缺什么"、"loop 系统怎么组织"。

- Skill: `kangarooking/loop-5plus1-architecture` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add kangarooking/loop-5plus1-architecture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kangarooking/loop-5plus1-architecture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kangarooking (https://skillmd.com/u/kangarooking)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kangarooking/loop-5plus1-architecture

---


## Source Metadata

Original cangjie-skill frontmatter from the distillation run:

```yaml
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 吗?
□ 连接器: 接入了外部工具吗?
□ 子智能体: 生产和审查分开了吗?
□ 脊柱: 有持久化记忆吗?
```

### Step 2: 补齐缺失组件
- 缺心跳 → 加 cron / webhook
- 缺 Work Tree → 加 git worktree / 独立目录
- 缺 Skill → 把指令写成 SKILL.md
- 缺连接器 → 接入 MCP
- 缺子智能体 → 拆分 maker 和 checker
- 缺脊柱 → 加状态文件 / 看板

### Step 3: 验证组件协同
- 触发 → 执行 → 验证 → 记录 → 下次触发 (完整闭环)
- 每个组件是否正常参与流程?

## B — Boundary (边界)

**不要使用这个 skill 的场景**:

1. **最小可用 loop**: 只需要 `loop-three-elements` 即可
2. **单次任务**: 不需要完整架构
3. **已有稳定系统**: 运行良好的 loop 不需要重构

**作者的盲点与局限**:
- 5+1 架构是 Idoos Money 的原创框架,未经广泛验证
- "脊柱"的概念比较模糊 — 可以是文件、数据库、看板,作者没有给出具体选择指南
- 视频案例全部基于 Claude Code 生态,其他工具可能需要不同组件

**与之相邻但容易混淆的方法论**:
- **微服务架构**: "拆分独立服务"; 本 skill 是"拆分 loop 组件"
- **MVC 模式**: "模型-视图-控制器"; 结构类似但面向 loop 系统