效率与协作 · SKILL.md

self-improvement-zh

self-improvement-zh

【效率与协作】捕获学习内容、错误和纠正以实现持续改进。使用场景：(1) 命令或操作意外失败时，(2) 用户纠正 AI 时（'不对，这样错了...', '实际上应该...'），(3) 用户请求不存在的功能时，(4) 外部 API 或工具失败时，(5) AI 意识到其知识过时或不正确时，(6) 发现重复任务的更好方法时。同时建议在执行重要任务前审查学习内容。

独立 GitHub 快照 · 自动分类 · 以原作者文档为准

Ll-lesteryu / openclaw-hot-skills-zhMIT

技能说明

GitHub

name: self-improvement-zh description: "捕获学习内容、错误和纠正以实现持续改进。使用场景：(1) 命令或操作意外失败时，(2) 用户纠正 AI 时（'不对，这样错了...', '实际上应该...'），(3) 用户请求不存在的功能时，(4) 外部 API 或工具失败时，(5) AI 意识到其知识过时或不正确时，(6) 发现重复任务的更好方法时。同时建议在执行重要任务前审查学习内容。" metadata:

自我改进技能

将学习内容和错误记录到 Markdown 文件中以实现持续改进。编码代理稍后可以将这些处理成修复，重要的学习内容会被提升到项目记忆中。

快速参考

情况	操作
命令/操作失败	记录到 `.learnings/ERRORS.md`
用户纠正你	记录到 `.learnings/LEARNINGS.md`，类别为 `correction`
用户想要缺失的功能	记录到 `.learnings/FEATURE_REQUESTS.md`
API/外部工具失败	记录到 `.learnings/ERRORS.md`，包含集成详情
知识过时	记录到 `.learnings/LEARNINGS.md`，类别为 `knowledge_gap`
发现更好的方法	记录到 `.learnings/LEARNINGS.md`，类别为 `best_practice`
简化/强化重复模式	记录/更新 `.learnings/LEARNINGS.md`，包含 `Source: simplify-and-harden` 和稳定的 `Pattern-Key`
与现有条目相似	用 `See Also` 链接，考虑提升优先级
广泛适用的学习	提升到 `CLAUDE.md`、`AGENTS.md` 和/或 `.github/copilot-instructions.md`
工作流改进	提升到 `AGENTS.md`（OpenClaw 工作区）
工具陷阱	提升到 `TOOLS.md`（OpenClaw 工作区）
行为模式	提升到 `SOUL.md`（OpenClaw 工作区）

OpenClaw 设置（推荐）

OpenClaw 是此技能的主要平台。它使用基于工作区的提示注入和自动技能加载。

安装

通过 ClawdHub（推荐）：

clawdhub install self-improvement-zh

手动：

git clone https://github.com/peterskoett/self-improving-agent.git ~/.openclaw/skills/self-improvement-zh

基于 OpenClaw 重新制作，原始仓库：https://github.com/pskoett/pskoett-ai-skills - https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-improvement

工作区结构

OpenClaw 在每个会话中注入这些文件：

~/.openclaw/workspace/
├── AGENTS.md          # 多代理工作流，委托模式
├── SOUL.md            # 行为指南，个性，原则
├── TOOLS.md           # 工具能力，集成陷阱
├── MEMORY.md          # 长期记忆（仅主会话）
├── memory/            # 每日记忆文件
│   └── YYYY-MM-DD.md
└── .learnings/        # 此技能的日志文件
    ├── LEARNINGS.md
    ├── ERRORS.md
    └── FEATURE_REQUESTS.md

创建学习文件

mkdir -p ~/.openclaw/workspace/.learnings

然后创建日志文件（或从 assets/ 复制）：

LEARNINGS.md — 纠正、知识缺口、最佳实践
ERRORS.md — 命令失败、异常
FEATURE_REQUESTS.md — 用户请求的功能

提升目标

当学习内容被证明具有广泛适用性时，将其提升到工作区文件：

学习类型	提升到	示例
行为模式	`SOUL.md`	"简洁明了，避免免责声明"
工作流改进	`AGENTS.md`	"为长时间任务生成子代理"
工具陷阱	`TOOLS.md`	"Git push 需要先配置认证"

会话间通信

OpenClaw 提供工具在会话间共享学习内容：

sessions_list — 查看活动/最近的会话
sessions_history — 读取另一个会话的记录
sessions_send — 向另一个会话发送学习内容
sessions_spawn — 生成子代理进行后台工作

可选：启用钩子

在会话开始时自动提醒：

# 复制钩子到 OpenClaw 钩子目录
cp -r hooks/openclaw ~/.openclaw/hooks/self-improvement-zh

# 启用它
openclaw hooks enable self-improvement-zh

详见 references/openclaw-integration.md。

通用设置（其他代理）

对于 Claude Code、Codex、Copilot 或其他代理，在项目中创建 .learnings/：

mkdir -p .learnings

从 assets/ 复制模板或创建带标题的文件。

在代理文件 AGENTS.md、CLAUDE.md 或 .github/copilot-instructions.md 中添加引用，提醒自己记录学习内容。（这是基于钩子提醒的替代方案）

自我改进工作流

当错误或纠正发生时：

记录到 .learnings/ERRORS.md、LEARNINGS.md 或 FEATURE_REQUESTS.md
审查并将广泛适用的学习提升到：
- CLAUDE.md - 项目事实和约定
- AGENTS.md - 工作流和自动化
- .github/copilot-instructions.md - Copilot 上下文

日志格式

学习条目

追加到 .learnings/LEARNINGS.md：

## [LRN-YYYYMMDD-XXX] category

**Logged**: ISO-8601 时间戳
**Priority**: low | medium | high | critical
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config

### Summary
学习内容的一行描述

### Details
完整上下文：发生了什么，哪里错了，什么是正确的

### Suggested Action
具体的修复或改进建议

### Metadata
- Source: conversation | error | user_feedback
- Related Files: path/to/file.ext
- Tags: tag1, tag2
- See Also: LRN-20250110-001 (如果与现有条目相关)
- Pattern-Key: simplify.dead_code | harden.input_validation (可选，用于重复模式跟踪)
- Recurrence-Count: 1 (可选)
- First-Seen: 2025-01-15 (可选)
- Last-Seen: 2025-01-15 (可选)

---

错误条目

追加到 .learnings/ERRORS.md：

## [ERR-YYYYMMDD-XXX] skill_or_command_name

**Logged**: ISO-8601 时间戳
**Priority**: high
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config

### Summary
失败内容的简要描述

### Error

实际错误消息或输出


### Context
- 尝试的命令/操作
- 使用的输入或参数
- 相关的环境详情

### Suggested Fix
如果可识别，可能解决此问题的方法

### Metadata
- Reproducible: yes | no | unknown
- Related Files: path/to/file.ext
- See Also: ERR-20250110-001 (如果重复)

---

功能请求条目

追加到 .learnings/FEATURE_REQUESTS.md：

## [FEAT-YYYYMMDD-XXX] capability_name

**Logged**: ISO-8601 时间戳
**Priority**: medium
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config

### Requested Capability
用户想要做什么

### User Context
为什么需要它，正在解决什么问题

### Complexity Estimate
simple | medium | complex

### Suggested Implementation
如何构建，可能扩展什么

### Metadata
- Frequency: first_time | recurring
- Related Features: existing_feature_name

---

ID 生成

格式：TYPE-YYYYMMDD-XXX

TYPE: LRN (学习), ERR (错误), FEAT (功能)
YYYYMMDD: 当前日期
XXX: 顺序号或随机 3 个字符（如 001, A7B）

示例：LRN-20250115-001, ERR-20250115-A3F, FEAT-20250115-002

解决条目

当问题被修复时，更新条目：

更改 **Status**: pending → **Status**: resolved
在 Metadata 后添加解决方案块：

### Resolution
- **Resolved**: 2025-01-16T09:00:00Z
- **Commit/PR**: abc123 或 #42
- **Notes**: 所做工作的简要描述

其他状态值：

in_progress - 正在积极处理
wont_fix - 决定不处理（在 Resolution 注释中添加原因）
promoted - 提升到 CLAUDE.md、AGENTS.md 或 .github/copilot-instructions.md

提升到项目记忆

当学习内容具有广泛适用性（不是一次性修复）时，将其提升到永久项目记忆。

何时提升

学习适用于多个文件/功能
任何贡献者（人类或 AI）都应知道的知识
防止重复错误
记录项目特定的约定

提升目标

目标	内容归属
`CLAUDE.md`	所有 Claude 交互的项目事实、约定、陷阱
`AGENTS.md`	代理特定的工作流、工具使用模式、自动化规则
`.github/copilot-instructions.md`	GitHub Copilot 的项目上下文和约定
`SOUL.md`	行为指南、沟通风格、原则（OpenClaw 工作区）
`TOOLS.md`	工具能力、使用模式、集成陷阱（OpenClaw 工作区）

如何提升

提炼学习内容为简洁的规则或事实
添加到目标文件的适当部分（如需要则创建文件）
更新原始条目：
- 更改 **Status**: pending → **Status**: promoted
- 添加 **Promoted**: CLAUDE.md、AGENTS.md 或 .github/copilot-instructions.md

提升示例

学习（详细）：

项目使用 pnpm 工作区。尝试 npm install 但失败了。锁定文件是 pnpm-lock.yaml。必须使用 pnpm install。

在 CLAUDE.md 中（简洁）：

## Build & Dependencies
- Package manager: pnpm (not npm) - use `pnpm install`

学习（详细）：

修改 API 端点时，必须重新生成 TypeScript 客户端。忘记这一点会导致运行时类型不匹配。

在 AGENTS.md 中（可操作）：

## After API Changes
1. Regenerate client: `pnpm run generate:api`
2. Check for type errors: `pnpm tsc --noEmit`

重复模式检测

如果记录与现有条目相似的内容：

先搜索：grep -r "keyword" .learnings/
链接条目：在 Metadata 中添加 **See Also**: ERR-20250110-001
提升优先级 如果问题持续重复
考虑系统性修复：重复问题通常表明：
- 缺少文档（→ 提升到 CLAUDE.md 或 .github/copilot-instructions.md）
- 缺少自动化（→ 添加到 AGENTS.md）
- 架构问题（→ 创建技术债务工单）

Simplify & Harden 反馈

使用此工作流从 simplify-and-harden 技能中提取重复模式，并将其转化为持久的提示指导。

提取工作流

从任务摘要中读取 simplify_and_harden.learning_loop.candidates。
对于每个候选项，使用 pattern_key 作为稳定的去重键。
在 .learnings/LEARNINGS.md 中搜索具有该键的现有条目：
- grep -n "Pattern-Key: <pattern_key>" .learnings/LEARNINGS.md
如果找到：
- 增加 Recurrence-Count
- 更新 Last-Seen
- 添加 See Also 链接到相关条目/任务
如果未找到：
- 创建新的 LRN-... 条目
- 设置 Source: simplify-and-harden
- 设置 Pattern-Key、Recurrence-Count: 1 和 First-Seen/Last-Seen

提升规则（系统提示反馈）

当以下所有条件都为真时，将重复模式提升到代理上下文/系统提示文件：

Recurrence-Count >= 3
至少在 2 个不同任务中出现
在 30 天的时间窗口内发生

提升目标：

CLAUDE.md
AGENTS.md
.github/copilot-instructions.md
SOUL.md / TOOLS.md 用于 OpenClaw 工作区级指导（如适用）

将提升的规则写为简短的预防规则（在编码之前/期间要做什么），而不是长篇事件报告。

定期审查

在自然断点处审查 .learnings/：

何时审查

在开始新的主要任务之前
在完成功能之后
在处理有过去学习内容的区域时
在活跃开发期间每周一次

快速状态检查

# 统计待处理项
grep -h "Status\*\*: pending" .learnings/*.md | wc -l

# 列出待处理的高优先级项
grep -B5 "Priority\*\*: high" .learnings/*.md | grep "^## \["

# 查找特定区域的学习内容
grep -l "Area\*\*: backend" .learnings/*.md

审查操作

解决已修复的项目
提升适用的学习内容
链接相关条目
升级重复问题

检测触发器

注意以下情况时自动记录：

纠正（→ 类别为 correction 的学习）：

"不对，不是这样..."
"实际上，应该是..."
"你错了..."
"那个过时了..."

功能请求（→ 功能请求）：

"你还能..."
"我希望你能..."
"有没有办法..."
"为什么你不能..."

知识缺口（→ 类别为 knowledge_gap 的学习）：

用户提供你不知道的信息
你引用的文档过时了
API 行为与你的理解不同

错误（→ 错误条目）：

命令返回非零退出码
异常或堆栈跟踪
意外的输出或行为
超时或连接失败

优先级指南

优先级	何时使用
`critical`	阻止核心功能，数据丢失风险，安全问题
`high`	影响重大，影响常见工作流，重复问题
`medium`	影响中等，存在解决方法
`low`	轻微不便，边缘情况，锦上添花

区域标签

用于按代码库区域过滤学习内容：

区域	范围
`frontend`	UI、组件、客户端代码
`backend`	API、服务、服务器端代码
`infra`	CI/CD、部署、Docker、云
`tests`	测试文件、测试工具、覆盖率
`docs`	文档、注释、README
`config`	配置文件、环境、设置

最佳实践

立即记录 - 问题发生后上下文最新鲜
要具体 - 未来的代理需要快速理解
包含复现步骤 - 特别是对于错误
链接相关文件 - 使修复更容易
建议具体修复 - 不仅仅是"调查"
使用一致的类别 - 启用过滤
积极提升 - 如有疑问，添加到 CLAUDE.md 或 .github/copilot-instructions.md
定期审查 - 过时的学习内容失去价值

Gitignore 选项

保持学习内容本地（每个开发者）：

.learnings/

在仓库中跟踪学习内容（团队范围）：不要添加到 .gitignore - 学习内容成为共享知识。

混合（跟踪模板，忽略条目）：

.learnings/*.md
!.learnings/.gitkeep

钩子集成

通过代理钩子启用自动提醒。这是选择性加入 - 你必须明确配置钩子。

快速设置（Claude Code / Codex）

在项目中创建 .claude/settings.json：

{
  "hooks": {
    "UserPromptSubmit": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "./skills/self-improvement/scripts/activator.sh"
      }]
    }]
  }
}

这会在每个提示后注入学习评估提醒（约 50-100 个令牌开销）。

完整设置（带错误检测）

{
  "hooks": {
    "UserPromptSubmit": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "./skills/self-improvement/scripts/activator.sh"
      }]
    }],
    "PostToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "./skills/self-improvement/scripts/error-detector.sh"
      }]
    }]
  }
}

可用的钩子脚本

脚本	钩子类型	目的
`scripts/activator.sh`	UserPromptSubmit	在任务后提醒评估学习内容
`scripts/error-detector.sh`	PostToolUse (Bash)	在命令错误时触发

详见 references/hooks-setup.md 进行详细配置和故障排除。

自动技能提取

当学习内容足够有价值成为可重用技能时，使用提供的助手提取它。

技能提取标准

当满足以下任一条件时，学习内容符合技能提取条件：

标准	描述
重复	有 `See Also` 链接到 2+ 个相似问题
已验证	状态为 `resolved` 且有有效修复
非显而易见	需要实际调试/调查才能发现
广泛适用	非项目特定；跨代码库有用
用户标记	用户说"把这个保存为技能"或类似

提取工作流

识别候选项：学习内容符合提取标准

运行助手（或手动创建）：

./skills/self-improvement/scripts/extract-skill.sh skill-name --dry-run
./skills/self-improvement/scripts/extract-skill.sh skill-name

自定义 SKILL.md：用学习内容填充模板
更新学习：将状态设置为 promoted_to_skill，添加 Skill-Path
验证：在新鲜会话中读取技能以确保其自包含

手动提取

如果你更喜欢手动创建：

创建 skills/<skill-name>/SKILL.md
使用 assets/SKILL-TEMPLATE.md 中的模板
遵循 Agent Skills 规范：
- 带有 name 和 description 的 YAML 前置数据
- 名称必须与文件夹名称匹配
- 技能文件夹内没有 README.md

提取检测触发器

注意这些信号表明学习应该成为技能：

在对话中：

"把这个保存为技能"
"我一直遇到这个"
"这对其他项目有用"
"记住这个模式"

在学习条目中：

多个 See Also 链接（重复问题）
高优先级 + 已解决状态
类别：best_practice 具有广泛适用性
用户反馈赞扬解决方案

技能质量门

在提取之前，验证：

解决方案经过测试且有效
描述在没有原始上下文的情况下清晰
代码示例是自包含的
没有项目特定的硬编码值
遵循技能命名约定（小写，连字符）

多代理支持

此技能适用于不同的 AI 编码代理，具有代理特定的激活。

Claude Code

激活：钩子（UserPromptSubmit、PostToolUse）设置：带钩子配置的 .claude/settings.json 检测：通过钩子脚本自动

Codex CLI

激活：钩子（与 Claude Code 相同的模式）设置：带钩子配置的 .codex/settings.json 检测：通过钩子脚本自动

GitHub Copilot

激活：手动（无钩子支持）设置：添加到 .github/copilot-instructions.md：

## Self-Improvement

After solving non-obvious issues, consider logging to `.learnings/`:
1. Use format from self-improvement skill
2. Link related entries with See Also
3. Promote high-value learnings to skills

Ask in chat: "Should I log this as a learning?"

检测：会话结束时手动审查

OpenClaw

激活：工作区注入 + 跨代理消息设置：参见上面的"OpenClaw 设置"部分检测：通过会话工具和工作区文件

代理无关指导

无论使用什么代理，在以下情况下应用自我改进：

发现非显而易见的东西 - 解决方案不是立即的
纠正自己 - 初始方法错误
学习项目约定 - 发现未记录的模式
遇到意外错误 - 特别是如果诊断困难
找到更好的方法 - 改进了原始解决方案

Copilot Chat 集成

对于 Copilot 用户，在相关时将此添加到你的提示中：

完成此任务后，评估是否应使用自我改进技能格式将任何学习内容记录到 .learnings/。

或使用快速提示：

"把这个记录到学习"
"从这个解决方案创建技能"
"检查 .learnings/ 中的相关问题"

MAKE IT PART OF YOUR WORKFLOW

安装技能

TERMINAL

npx skills add l-lesteryu/openclaw-hot-skills-zh --skill self-improvement-zh

复制命令到本地终端执行；安装前请先审查源代码和许可证。

ZIP · 完整技能目录，含资源与许可证

SKILL.md · 仅技能说明原文

仓库 Star: 未同步
许可证: MIT
版本 / 分支: HEAD · a35990eb
仓库更新时间: 未同步

安装前，请检查技能脚本与权限。

源代码

self-improvement-zh

技能说明

自我改进技能

快速参考

OpenClaw 设置（推荐）

安装

工作区结构

创建学习文件

提升目标

会话间通信

可选：启用钩子

通用设置（其他代理）

在代理文件 AGENTS.md、CLAUDE.md 或 .github/copilot-instructions.md 中添加引用，提醒自己记录学习内容。（这是基于钩子提醒的替代方案）

自我改进工作流

日志格式

学习条目

错误条目

功能请求条目

ID 生成

解决条目

提升到项目记忆

何时提升

提升目标

如何提升

提升示例

重复模式检测

Simplify & Harden 反馈

提取工作流

提升规则（系统提示反馈）

定期审查

何时审查

快速状态检查

审查操作

检测触发器

优先级指南

区域标签

最佳实践

Gitignore 选项

钩子集成

快速设置（Claude Code / Codex）

完整设置（带错误检测）

可用的钩子脚本

自动技能提取

技能提取标准

提取工作流

手动提取

提取检测触发器

技能质量门

多代理支持

Claude Code

Codex CLI

GitHub Copilot

OpenClaw

代理无关指导

Copilot Chat 集成

发现更多相关技能

计划执行与检查节点

女娲：花叔原版

仓颉：方法论版 v2.5.0