| name | agent-logs |
| description | 面向 agents 的执行日志技能。记录时间、用户原始 prompt、上下文摘要、文件改动、git 操作、模块化隔离与备份检查信息。 |
Agent Logs Skill
这个技能用于记录 agent 执行过程的关键审计信息,便于回溯、复盘和交接。
日志主存储为 Markdown 文件,直接落地在仓库根目录:docs/agent-logs/。
并按天做分区(文件夹分层),作为一个小型日志数仓。
记录要点
- 时间(通过 Linux
date 命令获取)
- 用户完整原始 prompt(不截断)
- LLM 执行上下文精简总结
- 改动文件列表
- 是否执行 git 操作
- 是否模块化隔离
- 是否执行备份,以及备份三特性检查
备份三特性定义
这里默认采用以下三项检查:
integrity_ok:备份数据完整性通过(如校验和)
consistency_ok:备份数据一致性通过(逻辑一致)
recoverability_ok:备份可恢复性通过(可演练恢复)
命令用法
所有操作通过脚本完成:
python3 .agents/skills/agent-logs/scripts/agent_logs.py <command> ...
存储位置
- 分区目录:
docs/agent-logs/YYYY-MM-DD/
- 单条日志:
docs/agent-logs/YYYY-MM-DD/log-xxxx-<HHMMSS>.md
- 索引文件:
docs/agent-logs/INDEX.md
- 分区索引:
docs/agent-logs/YYYY-MM-DD/INDEX.md
- 总览导出:
docs/agent-logs/AGENT_LOGBOOK.md
1. 新增日志
python3 .agents/skills/agent-logs/scripts/agent_logs.py add \
--prompt "用户完整原始prompt" \
--summary "本次LLM上下文摘要" \
--git-op yes \
--git-detail "执行了 git add 和 git commit" \
--isolated yes \
--backup yes \
--integrity-ok yes \
--consistency-ok yes \
--recoverability-ok no \
--backup-note "未做恢复演练" \
--auto-files
说明:
--auto-files:自动抓取当前 git 变更文件(已跟踪变更+未跟踪文件)
- 也可用
--files 手工传入文件列表
2. 查看单条日志
python3 .agents/skills/agent-logs/scripts/agent_logs.py get 1
3. 列出最近日志
python3 .agents/skills/agent-logs/scripts/agent_logs.py list --limit 20
4. 导出 Markdown 总览
python3 .agents/skills/agent-logs/scripts/agent_logs.py export
默认导出到:docs/agent-logs/AGENT_LOGBOOK.md