murphe-skills:把失败、纠正与经验沉淀成可复用的 Agent 记忆

前言

长期用 Cursor、Claude Code 等带 Skill 的 Agent 写代码时,同类问题会反复出现:某条命令突然失败、你纠正了模型的理解、外部 API 报错,或者后来找到了更稳的做法。默认对话结束后,这些「教训」往往不会自动进入下一次会话。

下面介绍 SkillHub 社区 Skill murphe-skills(坐标 @user_a694298e/murphe-skills)。它面向 ai-agent 场景,目标是在上述节点把 learnings、errors、corrections 记录下来,支撑持续改进;官方说明还建议在重大任务开始前先回顾已沉淀内容。与单纯拉长 system prompt 或手写笔记不同,它通过通用 SKILL.md 约定,让 Agent 在约定时机主动执行「捕获—回顾」流程。

这是什么

murphe-skills 版本 1.0.0,来源为 community,由 SkillHub 用户 user_a694298e 发布。SkillHub 分类为 ai-agent,标签 requires_api_key=false,表示按页面信息无需额外 API Key。

一句话定位:在命令失败、用户纠正、能力缺口、工具/API 失败、知识过时或发现更好做法时,引导 Agent 记录学习点与修正;并在合适时机(含重大任务前)回顾这些记录。

官方入口:

  • API 坐标页:https://api.skillhub.cn/user_a694298e/murphe-skills
  • SkillHub 展示页:https://www.skillhub.cn/skills/user_a694298e/murphe-skills

(SkillHub 页面统计:评分 100000,下载 809,安装 0——以页面展示为准,会随时间变化。)

核心功能

依据 SkillHub 上的英文简介,可核实的能力边界如下。

  1. 捕获学习内容(learnings)
    在任务推进中发现值得保留的经验时写入 Skill 约定的工作流(具体存储路径与文件格式以安装后的 SKILL.md 为准,本文不臆造)。

  2. 记录错误与纠正(errors and corrections)
    在操作失败或用户明确纠正模型时触发记录,避免同一误解在后续会话中重复出现。

  3. 持续改进(continuous improvement)
    通过累积记录,让 Agent 在类似场景下优先参考既有结论,而不是每次从零推理。

  4. 重大任务前的回顾
    官方说明:Also review learnings before major tasks——在开始较大改动或复杂任务前,先回顾已沉淀内容。

建议启用的时机(原文 Use when)

  1. 命令或操作意外失败。
  2. 用户纠正 Agent(例如 No, that’s wrong…、Actually…)。
  3. 用户提出的能力当前不存在。
  4. 外部 API 或工具调用失败。
  5. Agent 意识到自身知识过时或不正确。
  6. 对重复性任务发现了更好的做法。

安装与启用

SkillHub 提供两种常见路径:用自然语言让当前 Agent 按官方安装文档操作,或用 skillhub CLI 安装到当前客户端的 skills 目录。未装到正确目录时,Agent 可能识别不到 Skill,安装后通常需要重启或重新加载客户端。

方式一:提示词安装(SkillHub 页面推荐)

把下面意图发给正在使用的 AI(Cursor Agent、Claude Code 等),让其读取安装说明并安装本 Skill:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_a694298e/murphe-skills`。

方式二:skillhub CLI

先确认是否已安装 CLI:

command -v skillhub && skillhub --version

未安装时,可按 SkillHub 安装文档执行(完整安装示例):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 murphe-skills 时,必须用 --dir 指向当前 Agent 的 skills 目录。文档强调:省略 --dir 会默认装到 ./skills/,可能不会被当前客户端加载。

skillhub search murphe-skills
skillhub install user_a694298e/murphe-skills --dir <skills 目录>

各客户端常用 skills 路径(摘自 SkillHub 安装文档):

客户端 skills 目录
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或项目下 .agents/skills/

Cursor 与 Codex 路径不同,按你实际使用的客户端选择 --dir,不要混用。

启用后,Agent 在对话中应能根据项目或用户级 skills 目录中的 SKILL.md 触发上述捕获与回顾行为;若未生效,先确认目录与重启,再对照 SkillHub 安装文档排查。

典型用法

公开简介未提供逐步命令示例,可复现的「用法」即:在下列事件发生时让 Agent 按 Skill 规则记录或回顾。

示例 A:命令意外失败

  1. 你在仓库里执行构建或脚本失败。
  2. 向 Agent 说明失败现象,并让它在修复的同时按 murphe-skills 沉淀:失败命令、错误输出、最终有效修复。
  3. 下次同类环境问题时,先请求 Agent「回顾已有 learnings」再改代码。

示例 B:用户纠正理解

用户:No, that's wrong — 我们用的是 pnpm,不是 npm。
期望:Agent 修正当前操作,并将纠正点写入 learnings,避免再次默认 npm。

示例 C:重大任务前回顾

开始大范围重构或迁移前,明确提示:在开始之前,按 murphe-skills 回顾与本项目相关的 learnings。
这与官方 review learnings before major tasks 一致。

以上示例仅复述 SkillHub 公布的触发条件,不虚构具体文件名或内部 API。

适用场景与注意

适合谁

  • 长期在同一仓库或同一团队规范下使用 Agent,希望错误与纠正能跨会话保留。
  • 经常遇到 flaky 命令、第三方 API、或领域约定容易被模型猜错的情况。
  • 愿意在失败或纠正时多花一步「记下来」,以换后续任务更稳。

限制与注意

  • requires_api_key=false 只表示 SkillHub 标签层面不强制 API Key;你项目里调用的外部服务仍可能需要各自密钥。
  • 社区来源(community),行为细节以安装包内 SKILL.md 为准;升级前留意版本号(当前 1.0.0)。
  • 记录质量取决于 Agent 是否遵守 Skill 指令;需要团队约定何时必须沉淀、何时必须回顾。
  • SkillHub 统计中的「安装 0」可能与 CLI 统计口径或页面延迟有关,以你本地 skills 目录是否出现该 Skill 为准。

结尾

murphe-skills 把失败、纠正、能力缺口和更好做法收敛成可回顾的学习记录,适合作为 ai-agent 工作流里的「经验层」。若你已在用 SkillHub,可从坐标 @user_a694298e/murphe-skills 安装,并收藏展示页便于查看版本与说明:

https://www.skillhub.cn/skills/user_a694298e/murphe-skills

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜