# daily-loop-engineering

**Repository Path**: migeking_admin/daily-loop-engineering

## Basic Information

- **Project Name**: daily-loop-engineering
- **Description**: 面向 AI Agent 的每日工作复盘循环体系 — Loop Engineering 方法论（L1→L2→L3 渐进信任）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-02
- **Last Updated**: 2026-08-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# daily-loop-engineering

面向 AI Agent（OpenCode / Claude Code / Codex）的每日工作复盘循环体系。基于 [Loop Engineering 方法论](https://github.com/cobusgreyling/loop-engineering)，让 Agent 每天自动做计划、做复盘，循序渐进完成阶段性任务。

## 核心理念

- **渐进信任模型**：L1（报告模式）→ L2（自动修复 + 人工审核）→ L3（无人值守 + 多重安全措施），根据 Agent 表现逐步开放权限
- **分层记忆**：`STATE.md`（当日状态）→ `plans/` `reviews/`（日循环产物）→ `MEMORY.md`（长期经验积累）
- **分支复盘**：独立于每日复盘，在分支合并前沉淀技术决策与可复用经验

## 目录结构

```
.
├── STATE.md                    # 当前状态（阶段/今日目标/昨日复盘/阻塞项/下一步/信心）
├── MEMORY.md                   # 长期记忆（工作习惯/常见陷阱/高效策略）
├── BACKLOG.md                  # 待办队列（按优先级排序）
├── plans/                      # 每日计划（plans/YYYY-MM-DD.md）
├── reviews/                    # 每日复盘（reviews/YYYY-MM-DD.md）
└── skills/
    ├── daily-plan/SKILL.md     # 早晨计划技能（09:00 触发）
    └── daily-review/SKILL.md   # 晚间复盘技能（22:00 触发）
```

## 使用方式

将本仓库内容放入你的项目 `.loops/` 目录（或作为独立工作区），然后向 Agent 发送以下提示词。

### 第一步：初始化项目（一次性）

```
你是一个 Loop Engineering 专家。请在我当前目录下创建一个名为 `.loops` 的文件夹，并按照以下结构初始化每日工作复盘循环所需的所有文件：

1. 创建 `.loops/STATE.md`，包含以下字段（留空待填充）：
   - current_phase: （当前所处的大阶段名称，例如"项目Alpha冲刺"）
   - today_goal: （今日主要目标）
   - yesterday_review: （昨日复盘摘要）
   - blockers: （阻塞项列表）
   - next_action: （下一步待办）
   - confidence_level: （1-10，对自己完成度的信心）

2. 创建 `.loops/skills/daily-plan/SKILL.md`（见 skills/daily-plan/SKILL.md，原样写入）
3. 创建 `.loops/skills/daily-review/SKILL.md`（见 skills/daily-review/SKILL.md，原样写入）
4. 创建 `.loops/MEMORY.md`（见本仓库模板）
5. 创建 `.loops/BACKLOG.md`（见本仓库模板）
6. 创建 `plans/` 和 `reviews/` 两个空目录

完成后，打印文件树并告诉我一切就绪。
```

### 第二步：每日循环（L1 – 报告模式）

**早晨计划（每天 09:00 触发）**

```
请执行 daily-plan 技能。读取 .loops/STATE.md 和 .loops/BACKLOG.md，生成今天的计划文件 plans/YYYY-MM-DD.md。注意：
- 当前阶段是 [从 STATE.md 读取]
- 昨天的复盘文件是 reviews/YYYY-MM-DD.md（如果存在），请参考其中的"明日建议"
- 如果有阻塞项，在计划中标注解决方案或求助途径

生成后，用一句话总结今天的核心目标，并更新 STATE.md 中的 today_goal。
```

**晚间复盘（每天 22:00 触发）**

```
请执行 daily-review 技能。读取今天的计划 plans/YYYY-MM-DD.md，对比实际完成情况（检查 git log、文件修改、终端历史），生成复盘文件 reviews/YYYY-MM-DD.md。

特别注意：
- 如果某些任务未完成，分析根本原因（是低估复杂度、外部依赖、还是分心？）
- 提取至少一条可复用的正面经验
- 将经验教训追加到 .loops/MEMORY.md 中
- 更新 .loops/STATE.md 中的 yesterday_review、blockers、confidence_level
- 如果 BACKLOG.md 中有任务状态变化，同步更新

完成后，用三句话总结今日收获和明日重点。
```

### 第三步：分支复盘（Branch Review）

```
请执行 branch-review 技能。针对当前 git 分支 [branch-name]，执行以下操作：
1. 读取该分支的所有 commit 消息，归纳出主要工作脉络
2. 对比分支起始时的目标和现在的完成度
3. 识别出该分支上的关键技术决策或设计取舍
4. 写出分支复盘报告，保存到 reviews/branch-[branch-name]-YYYY-MM-DD.md（格式见 skills/ 约定）
5. 将该分支的经验教训提炼成一条或多条，追加到 .loops/MEMORY.md 中，标记为 #[branch-name]
```

### 第四步：从 L1 升级到 L2 / L3（渐进信任）

**L1 → L2：允许自动修复（但需人工审核）**

```
从现在起，将 daily-plan 和 daily-review 提升到 L2 模式。这意味着：
1. 在 daily-plan 阶段，除了生成计划，还可以自动从 BACKLOG.md 中选取一个 P0 任务，创建一个新的 git worktree 并在其中开始实现（但不要提交，只做草案）。
2. 在 daily-review 阶段，除了复盘，还要检查那个 worktree 中的代码质量，给出改进建议，然后删除 worktree。
3. 所有自动生成的代码修改都必须放在独立的 worktree 中，不得污染主工作区。
4. 在 STATE.md 中新增字段 auto_fix_attempts 记录自动修复次数和结果。

请确认你理解了 L2 规则，然后更新 .loops/STATE.md 中的 current_mode 为 'L2'。
```

**L2 → L3：允许无人值守（高风险，需充分验证）**

```
升级到 L3 模式。仅在满足以下条件时才允许无人值守执行：
- 当前任务属于 low-risk 类别（涉及纯文档、注释、格式化、依赖版本号更新的任务）
- 验证命令（如 npm test、go build、pytest）必须全部通过
- 每次执行前检查预算文件 .loops/budget.json（如果不存在则创建，初始预算 5000 tokens/天）
- 每次执行后更新预算消耗，如果超过预算则停止并报告
- 所有自动修改必须创建 PR（draft 模式），并 @mention 我进行最终合并

请在 STATE.md 中设置 current_mode 为 'L3'，并添加字段 l3_safeguards 列出当前生效的安全措施。
```

## 自定义分支模板（按工作类型）

| 工作类型 | 分支复盘额外评估维度 |
|----------|---------------------|
| 代码开发 | 测试覆盖率变化、圈复杂度变化、新增 lint 警告、API 兼容性影响 |
| 文档/调研 | 信息来源可靠性、结论可验证性、是否留下可执行下一步、知识图谱更新（KNOWLEDGE.md） |
| 项目管理 | 时间估计偏差率、沟通成本（会议次数/消息数）、阻塞项解决时效、团队协作效率 |

## 故障恢复

如果 Agent 在一次循环中出现异常（如无限循环、成本超限），执行紧急停止提示词：

```
紧急停止所有循环。读取 .loops/STATE.md 和最近的 run-log，分析故障原因。将分析结果写入 .loops/failures/YYYY-MM-DD-HHMM.md。然后重置 STATE.md 中的 current_mode 为 'L1'。
```

## 升级时机建议

1. 首次运行：先执行"初始化项目"提示词，建立基础设施
2. 日常运行：每天早晚分别执行"早晨计划"和"晚间复盘"，可设置为 cron 任务或手动触发
3. 分支结束时：执行分支复盘提示词，积累长期记忆
4. 连续一周复盘显示 Agent 决策准确率 >80% 且无重大失误 → 可升级到 L2；再稳定两周 → 考虑 L3

## 许可证

[MIT](LICENSE)