← Back to Skills Marketplace
morrison230

Agent Daily Retro

by morrison230 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
97
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install agent-daily-retro
Description
执行每日复盘,备份文件后收集历史数据,分析总结六维度内容,更新核心配置,写入复盘锁,最后汇报复盘结果。
README (SKILL.md)

SKILL.md

本技能定义了 Agent 每日复盘的标准操作程序。执行复盘时,必须严格按照以下步骤进行,且必须先完成物理落盘操作,再向用户汇报结果。

执行要求

  • 改动所有文件之前,都需要先备份。

  • 例如改动 MEMORY.md 之前,要先复制一份命名为 MEMORY.md.bak.${yyyyMMddHHmmss},作为备份,再进行修改。对 USER.md、SOUL.md、AGENTS.md 等其他核心配置文件的修改同理。

Step 1: 确定时间与范围

  • 确定复盘的 Agent ID(默认情况为 main)。

  • 确定目标日期(格式 YYYY-MM-DD)。如果用户说“昨天”,请根据当前本地时区准确推算昨天的日期。

  • 检查复盘锁:根据目标日期构造锁文件路径(例如目标日期为 2026-02-04,则锁文件为 memory/AGENT_RETRO_DONE_20260204.md)。在执行复盘前,必须先检查该文件是否存在。如果存在,说明该日期的复盘已完成,立即终止复盘并告知用户。

Step 2: 收集历史数据

  • 进入 ~/.openclaw/agents/${agentId}/sessions 目录。

  • 读取该目录下所有带有目标日期时间戳的 .jsonl 或会话记录。

  • 提取当天的所有 user 指令、assistant 回复、工具调用(Tool Calls)及工具结果。

Step 3: 分析与总结

根据提取的聊天记录,必须且仅限总结以下 6 个维度的内容:

  • 昨日动作:昨天你做了哪些事情。

  • 做对的事情:一次完成没有重复对话,或者获得了用户的称赞的事项。

  • 做错的事情:没有一次完成,陷入重复修正,或者被用户批评的事项。

  • 改进点:针对做错的事情,提出具体的、可执行的防范改进点(如何保证以后一次做对)。

  • 用户画像:用户是一个什么样的人(偏好、风格、底线等)。

  • Agent 画像:你是一个什么样的 Agent(暴露出的行为倾向或缺陷)。

Step 4: 记录 Daily Memory

  • 将 Step 3 的完整总结内容,写入工作区目录下的 memory/YYYY-MM-DD.md 文件中。

  • 如果该文件不存在则创建,如果存在则追加。

Step 5: 更新核心配置(核心步骤)

  • 对比更新 MEMORY.md:提取 Step 3 中的关键结论,与工作区下的 MEMORY.md 做对比。新增缺失的结论,修改过时的结论,并将这些变更追加记录到 memory/YYYY-MM-DD.md 的末尾。

  • 更新 USER.md:使用 Step 3 提炼的“用户画像”信息,修改 USER.md,完善上下文。

  • 更新 SOUL.md:使用 Step 3 提炼的“Agent 画像”信息,修改 SOUL.md,强化核心性格与行为边界。

  • 更新 AGENTS.md:使用 Step 3 提炼的“改进点”,修改 AGENTS.md 中的工具约束或战术准则,确保教训被固化。

警告:执行配置更新时,必须使用 read 读取原内容,并使用 edit 或 write 进行真实的物理修改。严禁只在对话中口头承诺修改。

Step 6: 写入复盘锁(天级别防重复)

在上述总结和文件更新完成后,写入复盘锁文件 memory/AGENT_RETRO_DONE_YYYYMMDD.md。例如对于 2026-02-04 的复盘,写入一个名为 AGENT_RETRO_DONE_20260204.md 的空文件或包含完成时间戳的文件即可,用于标记该日复盘已执行。

Step 7: 向用户发送复盘报告

在确认所有文件(1个每日memory + 4个核心配置文件 + 1个复盘锁文件)都已成功更新落盘后,向用户发送复盘概要。 报告内容应简明扼要,说明发现了什么核心问题、提炼了什么规矩,以及哪些文件已被成功修改。

Usage Guidance
This skill appears to do what it says: read conversation logs, summarize six dimensions, update local 'memory' and core files, create a lock file, and report results. Before installing or enabling it, do the following checks: - Review config.json and replace or disable the feishu.webhook: The package ships with a concrete webhook URL and feishu.enabled=true. If you enable the skill without editing this, processed conversation content could be posted to that webhook (potentially exposing sensitive messages). Either set feishu.enabled=false or replace the webhook with your own controlled endpoint. - Inspect the notifier code path: Open the Feishu notifier implementation (not fully shown in the truncated files) to confirm exactly what fields are sent (raw messages, full conversation data, or only summaries). Prefer sending only high-level summaries, not raw chat content or identifiers. - Avoid running cron/jobs as root: INSTALL.md gives example crontab lines and suggests root/sudo. Instead run it as the unprivileged user that owns your ~/.openclaw workspace, and verify file permissions are appropriate. - Backup and test in a safe environment: Because the skill will edit core files (MEMORY.md, USER.md, SOUL.md, AGENTS.md), test on a copy of your workspace first. Confirm the backup behavior works and that edits are correct and not destructive. - Verify what is parsed from session files: Session directories (~/.openclaw/agents/${agentId}/sessions) contain your chat history; ensure you are comfortable with that data being read and summarized. If you want to limit exposure, run the skill only on sanitized or minimal data. - If you are unsure about the webhook URL's ownership or purpose, do not enable outbound notifications and consider removing or replacing the webhook entry before running the skill. If you can confirm the webhook is yours (or disable it), run tests locally on non-sensitive data and review the notifier before enabling scheduled runs. These steps will reduce the risk of accidental data exposure.
Capability Analysis
Type: OpenClaw Skill Name: agent-daily-retro Version: 1.0.0 The skill bundle implements a 'Daily Retro' system for OpenClaw agents, designed to analyze session logs and update core configuration files (MEMORY.md, USER.md, SOUL.md, AGENTS.md) to maintain long-term memory and persona consistency. While the system performs high-privilege operations—including reading private session data, modifying core agent files, and sending summary reports to an external Feishu webhook (open.feishu.cn)—these behaviors are explicitly documented as core features and include safety mechanisms such as mandatory file backups and execution locks. The code is transparent, lacks obfuscation, and the installation instructions (INSTALL.md) correctly advise users to replace the placeholder webhook with their own, indicating no clear malicious intent.
Capability Assessment
Purpose & Capability
The name/description (daily agent retro) align with the actions the code performs: reading session logs, analyzing conversations, writing daily memory, updating core files, creating a lock, and sending a report. Requiring read/write access to ~/.openclaw workspace and agent session files is consistent with the stated purpose.
Instruction Scope
SKILL.md explicitly instructs the agent to read ~/.openclaw/agents/${agentId}/sessions, parse .jsonl conversation logs, back up and edit core files (MEMORY.md, USER.md, SOUL.md, AGENTS.md), create lock files, then report results. That scope matches the purpose, but it also means the skill will access potentially sensitive chat logs and persist modified core configuration files — and the instructions demand 'physical' file writes before reporting, increasing the chance of writing/overwriting local state.
Install Mechanism
No install spec is provided (instruction-only with included code files), so nothing arbitrary is downloaded at install time. Installation docs do recommend cron setup and permissions, but there is no automated remote fetch in the manifest. Lack of an install script reduces supply-chain risk.
Credentials
The skill does not require environment variables or external credentials, but config.json contains an enabled feishu.webhook URL (concrete webhook) and feishu.enabled=true. That means by default the skill is configured to send analysis (which may include extracted user messages and profiles) to an external webhook. Embedding a third-party webhook in shipped config is risky if it is not the user's webhook — it effectively exfiltrates processed conversation content to whoever controls that webhook. The manifest did not declare any network endpoints, and no env vars are required, so the inclusion of an outbound webhook in a shipped config is the primary proportionality concern.
Persistence & Privilege
always:false (good). The skill modifies files in the user's workspace (memory and core config files) and suggests adding a cron job (INSTALL.md) to run daily, including example crontab lines that run as root in /root. Running as root or configuring system cron is not required by the manifest but is suggested in docs; users should avoid running this as root unless intended. The skill does not request or modify other skills' configs in the provided files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install agent-daily-retro
  3. After installation, invoke the skill by name or use /agent-daily-retro
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release defining the daily retrospective SOP for Agents. - Enforces strict backup and physical file update procedures before reporting results. - Introduces a 7-step daily retro workflow: lock check, data collection, structured analysis, memory recording, configuration updates, retro lock, and user reporting. - Mandates actionable summaries across 6 key dimensions: actions, wins, mistakes, improvements, user profile, and agent profile. - Establishes robust file handling with backups and step-wise updates to MEMORY.md, USER.md, SOUL.md, and AGENTS.md. - Implements a lock file system to prevent duplicate retros for the same date.
Metadata
Slug agent-daily-retro
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Agent Daily Retro?

执行每日复盘,备份文件后收集历史数据,分析总结六维度内容,更新核心配置,写入复盘锁,最后汇报复盘结果。 It is an AI Agent Skill for Claude Code / OpenClaw, with 97 downloads so far.

How do I install Agent Daily Retro?

Run "/install agent-daily-retro" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Agent Daily Retro free?

Yes, Agent Daily Retro is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Agent Daily Retro support?

Agent Daily Retro is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Agent Daily Retro?

It is built and maintained by morrison230 (@morrison230); the current version is v1.0.0.

💬 Comments