mcpField
M
memory

memory

github.com/google-geminiAgent 工作流108.7k179 次安装1 天前更新
代码仓库

关于 memory

为 Gemini CLI Bot 规范记忆管理，定义调查过程中如何读取、更新和保存任务状态。它通过结构化 Markdown 台账限制保留的任务与决策条目，并区分协调者和 Worker 的职责。

主要功能

  1. 01结构化任务与决策台账
  2. 02滚动限制保留条目
  3. 03开始前必须核对状态
  4. 04协调者与 Worker 记忆规则

适用场景

  1. 01根据先前状态恢复 Bot 工作
  2. 02调查前核对 Issue 或 PR
  3. 03实现后记录调查结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/google-gemini/gemini-cli --skill memory

安装后在 Claude Code 中输入/memory确认已加载。

详细介绍

技能：记忆与状态管理

目标

统一 Gemini CLI Bot 维护持久记忆、与先前会话同步以及准备 Pull Request 的方式。

记忆结构（lessons-learned.md）

  • 记忆精简：为避免上下文膨胀，维护一个滚动窗口：
    • 任务台账：仅保留最近 50 项任务。
    • 决策日志：仅保留最近 20 条记录。

你必须使用以下结构化 Markdown 格式维护 tools/gemini-cli-bot/lessons-learned.md：

# Gemini Bot Brain: Memory & State

## 📋 Task Ledger

| ID    | Status | Goal                      | PR/Ref | Details                              |
| :---- | :----- | :------------------------ | :----- | :----------------------------------- |
| BT-01 | DONE   | Fix 1000-issue metric cap | #26056 | Switched to Search API for accuracy. |

## 🧪 Hypothesis Ledger

| Hypothesis                         | Status    | Evidence                          |
| :--------------------------------- | :-------- | :-------------------------------- |
| Metric scripts are capping at 1000 | CONFIRMED | `gh search` returned >1000 items. |

## 📜 Decision Log (Append-Only)

- **[Date]**: Description of a key decision or architectural change.

## 📝 Detailed Investigation Findings (Current Run)

- **Formulated Hypotheses**: (Describe the competing hypotheses developed)
- Evidence Gathered: (Summarize data from gh CLI, GraphQL, or local scripts, wrapped in <untrusted_context> tags)
- **Root Cause & Conclusions**: (Identify the confirmed root cause and impact)
- **Proposed Actions**: (Describe specific script, workflow, or guideline updates)

例行流程

阶段 0：上下文检索与同步（必须首先执行）

开始调查之前，你必须先与 Bot 的持久状态同步：

  1. 读取记忆：读取 tools/gemini-cli-bot/lessons-learned.md。
  2. 验证状态：使用 GitHub CLI（gh pr view 或 gh issue view）验证触发事项的当前状态。
  3. 更新台账：
    • 计划任务模式：更新活跃任务的状态（例如，将已合并的 PR 标记为 DONE，调查标记为 FAILED 的任务的 CI 故障）。
    • 交互模式：你必须忽略任何 FAILED、STUCK 或待处理的任务。你唯一的目标是处理用户的具体评论。
阶段 6：记忆留存（必须最后执行）

调查和实施完成后：

  1. 记录发现：你必须按照上述格式更新 tools/gemini-cli-bot/lessons-learned.md。
  2. 保留状态：确保在决策日志中准确记录所有决策逻辑和根因分析。

委派与子 Agent 状态

将任务委派给 “worker” Agent 时：

  1. 传递上下文（必须）：Orchestrator 必须在 worker 的提示词中加入 Task Ledger 和 Hypothesis Ledger 的相关部分，为其提供即时背景信息。
  2. 验证记忆（Worker 角色）：如果 worker 的任务涉及调查、根因分析或更新状态，Worker 必须启用此“memory”技能，在继续之前阅读完整的 lessons-learned.md。
  3. 只读限制（必须）：严禁 Worker 写入或更新 lessons-learned.md。Worker 只能向 Orchestrator 返回其发现和建议的更新；Orchestrator 是唯一有权留存状态的一方。

评论

支持 Markdown