用 claude-smart 将代理修正转为持久技能
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的指引,安装 @user_3c6cb52e/turn-agent-corrections-into-durable-skills-with-claude-smart 到你的 AI 助手。
技能介绍
Agent 在工作中最常见的痛点之一,是反复犯同样的错误。你明确告诉过 Claude 这个 repo 必须用 pnpm dev:all 启动完整本地栈,但它下次仍然先试 npm run dev,导致服务缺失。又比如 Prisma 升级到 6.0 破坏了订单流程的嵌套写入,你让它回滚,但它下次还会尝试。这类修正如果只留在当前对话的上下文里,session 结束就丢失了。
核心思路:把临时纠正变成可复用的偏好
claude-smart 的设计不是做聊天机器人的记忆插件,而是把代理在实际工作中学到的工作模式按范围持久化:
- 偏好(Preferences):跨项目的个人工作习惯,例如 "我倾向用 pnpm 而不是 npm" 或 "PR 描述用中文写"
- 项目技能(Project Skills):绑定到特定 repo 的硬性规则,例如 "这个仓库必须用
pnpm dev:all" - 共享技能(Shared Skills):可被多个项目复用的修复模式或操作约定
这些存储在本地的 ~/.reflexio/ 和 ~/.claude-smart/ 目录中,后续会话中自动检索并注入相关偏好,让代理不再从零开始猜测。
关键工作流:从信号到技能
- 捕获修正信号:当代理尝试失败、用户明确回滚或口头纠正时,系统记录这次交互。例如 "npm run dev 只启动前端,导致服务缺失" 就被捕获为候选偏好。
- 分类与存储:按偏好范围(全局、项目级、共享)分别写入对应的存储层。项目级规则优先于全局偏好生效。
- 检索与注入:下次启动代理时,会查询相关技能库,把匹配的偏好注入到系统提示中。当你再次进入那个 repo,
pnpm dev:all的规则会优先被采纳。
适用边界
- 依赖本地 CLI:需要
claude、codex或opencode等目标主机在PATH中,否则技能无法被调用。 - 不是万能记忆:偏好系统只会记录它能理解的可执行规则,模糊的 "记得我喜欢简洁的代码" 这类表述难以被结构化为技能。
- 数据隔离:存储完全在本地,跨机器或团队需要手动同步共享技能层,不会自动上传。
- 学习成本:偏好质量取决于初始示例的质量。如果一开始给的指导模糊,后续检索也会继承这个模糊性。
使用场景
- 接手一个本地启动必须用 `pnpm dev:all` 的项目,代理曾反复试错后手动修正。
- 部署环境依赖检查与回滚时,代理需要记住哪类版本组合会导致订单流程失败。
- 将项目级代码风格和测试命令偏好同步给 Claude Code、Codex 等多个代理。
- 记录跨会话仍生效的团队约定,如错误排查路径或本地栈启动方式。
适合人员
- 需要让代理记住项目特定启动和调试规则的后端工程师。
- 维护多代理工具链、希望避免跨会话重复纠正的开发团队。
- 负责记录团队内部环境约定的基础设施维护者。
- 经常用不同 CLI 代理处理同一项目、需要共享偏好的开发者。