benson-xie/workbuddy-self-improving-agent

Latest recorded source activity: May 18, 2026 at 14:42

SkillsMP catalog refreshed: November 12, 2026 at 12:52

skills collected: 1

GitHub stars: 3
GitHub forks: 0

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/benson-xie/workbuddy-self-improving-agent.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# self-improving-agent 技能跨项目自我进化技能 - 让 AI 从错误和反馈中持续学习，经验可在项目间贯通。 ## 核心特性 - **智能分类**：晋升时根据内容自动分类到5个核心文件 - 性格、信念、行为边界 → `SOUL.md` - 身份、角色、使命 → `IDENTITY.md` - 主人偏好、互动规则 → `USER.md` - 工作流、操作规范、权限 → `AGENTS.md` - 工具环境、技术经验、项目背景 → `memory.md` - **安全备份**：写入目标文件前自动备份 - **两级晋升**：项目级→用户级→全局，逐级验证 - **全面扫描**：扫描结构化记录 + 日期记忆 + 长期记忆 - **智能去重**：SessionEnd Hook 自动去重，避免重复记录 - **精准检测**：只分析用户发言，排除AI回复，减少误报 ## 目录结构 ``` self-improving-agent/ ├── SKILL.md # 技能说明文档 ├── README.md # 本文件 ├── hooks_config_example.json # Hook 配置示例 ├── scripts/ │ ├── promote.py # 晋升脚本 │ ├── review.py # 审查脚本 │ ├── cleanup.py # 清理脚本 │ ├── init_workspaces.py # 初始化脚本 │ └── session_end_hook.py # SessionEnd Hook 脚本 └── .workbuddy/ └── memory/ # 工作记忆（自动维护） ``` ## 快速安装 ### 1. 复制技能文件夹将整个 `self-improving-agent` 文件夹复制到： ``` Windows: C:\Users\<用户名>\.workbuddy\skills\self-improving-agent\ macOS: ~/.workbuddy/skills/self-improving-agent/ ``` ### 2. 创建记忆目录 ```bash # 用户级（跨项目通用） mkdir -p ~/.workbuddy/self-improve # 项目级（当前工作区） mkdir -p .workbuddy/self-improve ``` ### 3. 初始化模板文件 ```bash cd ~/.workbuddy/skills/self-improving-agent python scripts/init_workspaces.py ``` ### 4. 配置 SessionEnd Hook 在 `~/.workbuddy/settings.json` 中添加： ```json { "hooks": { "SessionEnd": [ { "matcher": "other", "hooks": [ { "type": "command", "command": "python C:/Users/<用户名>/.workbuddy/skills/self-improving-agent/scripts/session_end_hook.py", "timeout": 30 } ] } ] } } ``` ### 5. 在 SOUL.md 中添加自改进配置 ```markdown ## 六、自改进（必须执行，持续成长） ### 配置 - **模式**: Active（默认） - 选项: Passive | Active | Strict ### 执行规则 - **必须**：每次对话开始时，主动加载 `self-improving-agent` 技能（调用 Skill 工具） - **必须**：每次对话加载后，自动运行 `review.py` 检查是否有值得记录的经验 - **必须**：每次任务完成后执行自我反思（评估→识别改进点→判断模式） - **必须**：识别到纠正、错误、功能请求时，记录到项目级 `self-improve/` 对应文件 - **必须**：执行重要操作前，先扫描用户级和项目级 `self-improve/` 目录，检查是否有相关经验 - **必须**：当同一模式出现 3 次以上时，主动询问主人是否晋升到用户级记忆 - **必须**：晋升前征得主人同意（第一级和第二级晋升） - **禁止**：记录密码、API Key、财务信息、个人隐私等敏感内容 ``` ## 自动化任务配置创建三个定时任务： ```bash # 每日 09:00 - 扫描项目级，检查可晋升条目 # 每周五 10:00 - 扫描用户级，检查可沉淀条目 # 每月1日 10:00 - 清理过期条目，归档 ``` 使用 WorkBuddy 的 automation_update 工具创建： ### 每日审查 - 名称：`自改进技能 - 每日晋升审查` - 周期：`FREQ=DAILY;BYHOUR=9;BYMINUTE=0` ### 每周审查 - 名称：`自改进技能 - 每周审查（用户级→全局晋升）` - 周期：`FREQ=WEEKLY;BYDAY=FR;BYHOUR=10;BYMINUTE=0` ### 每月清理 - 名称：`自改进技能 - 每月清理归档` - 周期：`FREQ=MONTHLY;BYMONTHDAY=1;BYHOUR=10;BYMINUTE=0` ## 记忆存储结构 ### 结构化记录（`.workbuddy/self-improve/`） - `LEARNINGS.md` — 学习记录（纠正、最佳实践、知识缺口） - `ERRORS.md` — 错误记录（命令失败、异常、API错误） - `FEATURE_REQUESTS.md` — 功能请求 ### 记忆文件（`.workbuddy/memory/`） - `MEMORY.md` — 长期记忆（提炼的核心经验） - `YYYY-MM-DD.md` — 日期记忆（日常工作记录） ### 审查扫描范围 `review.py` 会扫描以下内容： | 文件类型 | 位置 | 统计方式 | |---------|------|----------| | LEARNINGS.md | `.workbuddy/self-improve/` | 统计 `- **ID**:` 条目 | | ERRORS.md | `.workbuddy/self-improve/` | 统计 `- **ID**:` 条目 | | FEATURE_REQUESTS.md | `.workbuddy/self-improve/` | 统计 `- **ID**:` 条目 | | MEMORY.md | `.workbuddy/memory/` | 统计 `##` 章节 | | YYYY-MM-DD.md | `.workbuddy/memory/` | 统计 `##` 章节（最近7天） | ### 检索优先级 1. 用户级 `self-improve/`（跨项目通用经验） 2. 项目级 `self-improve/`（当前项目特定经验） 3. 5个核心文件（长期记忆） ## 晋升机制 ### 第一级：项目级 → 用户级 **条件**： 1. 同一内容出现 **3 次以上** 2. 跨 **2 个以上不同任务** 3. 状态为 `resolved` 且有修复方案 4. 具有**跨项目适用性** **操作**： - **询问用户确认**："📈 发现一条重复出现的经验，建议晋升到全局记忆，是否同意？" - 用户同意后，格式化为用户级格式，追加到用户级对应文件 - 添加晋升标记：`promoted: YYYY-MM-DD to user-level` ### 第二级：用户级 → 全局（5个核心文件） **条件**： 1. 状态为 `resolved` 2. 出现 **5 次以上** 且时间跨度超过 **7 天** 3. 内容具有高度通用性 **分类写入规则**： | 内容类型 | 关键词示例 | 目标文件 | |---------|-----------|---------| | 性格、信念、行为边界 | 性格、信念、边界、态度、风格、语气 | `SOUL.md` | | 身份、角色、使命 | 身份、角色、使命、名称、定位 | `IDENTITY.md` | | 主人偏好、互动规则 | 主人、称呼、偏好、互动、沟通 | `USER.md` | | 工作流、操作规范、权限 | 流程、步骤、规范、操作、权限、安全 | `AGENTS.md` | | 工具环境、技术经验、项目背景 | 工具、环境、配置、项目、技术、经验 | `memory.md` | **操作**： 1. 晋升前**询问用户确认** 2. 用户同意后，根据内容关键词自动分类 3. **写入前备份目标文件** 4. 格式化为规则形式，写入对应目标文件 5. 添加晋升标记：`promoted: YYYY-MM-DD to global` ## 手动管理命令 | 命令 | 功能 | |------|------| | `📖 我记住了什么` | 显示你从我这里学到了哪些经验 | | `📖 查看学习记录` | 显示用户级和所有工作空间的学习记录摘要 | | `📖 查看最近错误` | 显示最近的错误记录 | | `📖 晋升检查` | 立即执行晋升审查（扫描所有工作空间） | | `📖 扫描工作空间` | 显示所有工作空间及其自改进记录统计 | | `📖 删除记录 [ID]` | 删除指定 ID 的记录 | | `📖 清除所有记录` | 清除所有自改进记录（需确认） | | `📖 切换模式 [Passive/Active/Strict]` | 切换操作模式 | ## 操作模式 - **Passive**：仅记录用户主动纠正或明确反馈 - **Active**：同一模式出现 3 次后主动询问用户是否晋升（默认） - **Strict**：每条记录都需要用户确认后才写入 ## SessionEnd Hook 优化 ### 检测逻辑 - **去重机制**：使用 `seen_contents` 集合，同一对话只记录一次 - **排除AI发言**：只分析用户消息，忽略AI回复 - **上下文清理**：移除代码块、行内代码、特殊字符 - **结构化解析**：解析对话结构，分离用户和AI的发言 ### 检测模式 | 类型 | 检测关键词 | 记录文件 | 说明 | |------|-----------|----------|------| | correction | "不对"、"错了"、"应该是"、"你搞错了" | LEARNINGS.md | 只检测用户发言 | | error | "失败了"、"报错了"、"出错了"、"不行"、"不能用" | ERRORS.md | 只检测用户发言 | | best_practice | "这样做很好"、"对，就这样"、"不错"、"完美"、"可以"、"好的" | LEARNINGS.md | 只检测用户发言 | ### 自动创建 Hook 脚本会自动创建目录和文件，无需手动初始化： - 自动创建 `.workbuddy/self-improve/` 目录 - 自动生成 `LEARNINGS.md` 和 `ERRORS.md` 模板文件 ## 安全边界 ### 禁止记录的内容 - API Key、密码、令牌、SSH 密钥等凭证 - 财务信息（卡号、银行账户、支付密码） - 医疗信息（诊断结果、药物、健康状况） - 生物识别信息 - 第三方个人信息 - 用户明确要求不记录的内容 ### 透明性要求 - 用户可随时通过 "📖 我记住了什么" 查看所有记录 - 每条记录标注来源（何时、在什么任务中学习到的） - 用户可随时删除任意记录 - 晋升前必须征得用户同意 ## 环境变量配置可通过环境变量自定义路径： ```bash # 备份目录（默认：F:/小师妹（龙虾）） SELF_IMPROVE_BACKUP_DIR="F:/小师妹（龙虾）" # 目标文件路径 SOUL_FILE="C:/Users/<用户名>/.workbuddy/SOUL.md" IDENTITY_FILE="C:/Users/<用户名>/.workbuddy/IDENTITY.md" USER_FILE="C:/Users/<用户名>/.workbuddy/USER.md" AGENTS_FILE="C:/Users/<用户名>/.workbuddy/AGENTS.md" MEMORY_FILE="C:/Users/<用户名>/.workbuddy/memory.md" ``` ## 跨 AI 兼容本技能设计为全平台通用。安装时： 1. 将技能包解压到对应用户的技能目录 2. 创建用户级目录：`~/.workbuddy/self-improve/` 3. 创建项目级目录 `.workbuddy/self-improve/` 4. 两机器的经验各自独立积累 ## 版本历史 - **v2.5** (2026-05-13): 审查范围扩展 + Hook脚本优化 - 扩展 review.py 扫描范围，支持日期记忆和长期记忆 - 优化 SessionEnd Hook 脚本，解决误报问题 - 新增去重机制、排除AI发言、上下文清理 - **v2.0** (2026-05-13): 晋升机制改进 - 5个核心文件分类+备份 - **v1.5** (2026-05-13): 工作空间自动发现机制 - **v1.0** (2026-05-08): 初始版本 ## 许可证 MIT License

Loading the repository README…

Skills in this repository

classification pending

skill

occupation

description

updated

self-improving-agent

unclassified

跨项目自我进化技能 - 自动记录纠正、错误、最佳实践，支持两级记忆晋升

Source text: Chinese

2026-05-18

Showing 1 of 1 collected skill.