运行时依赖
版本
1. Re生成 命令行工具ent: `pnpm 运行 生成:API`
安装命令
点击复制技能文档
自我改进技能日志 记录学习和错误到 markdown 文件中,以实现持续改进。编码代理可以稍后处理这些内容,并将重要的学习成果提升到项目记忆中。
快速参考
情况 操作 命令/操作失败 记录到 .learnings/ERRORS.md 中 用户更正你 记录到 .learnings/LEARNINGS.md 中,分类为更正 用户需要缺失的功能 记录到 .learnings/FEATURE_REQUESTS.md 中 API/外部工具失败 记录到 .learnings/ERRORS.md 中,包含集成细节 知识过时 记录到 .learnings/LEARNINGS.md 中,分类为知识缺口 找到更好的方法 记录到 .learnings/LEARNINGS.md 中,分类为最佳实践 与现有条目类似 使用 See Also 链接,考虑优先级提升 普遍适用的学习 成果提升到 CLAUDE.md、AGENTS.md 和/或 .github/copilot-instructions.md 中 工作流改进 成果提升到 AGENTS.md(clawdbot 工作空间) 中 工具陷阱 成果提升到 TOOLS.md(clawdbot 工作空间) 中 行为模式 成果提升到 SOUL.md(clawdbot 工作空间) 中
设置
在项目根目录中创建 .learnings/ 目录(如果不存在):mkdir -p .learnings 从 assets/ 复制模板或创建带有标题的文件。
记录格式
学习条目
追加到 .learnings/LEARNINGS.md 中:
[LRN-YYYYMMDD-XXX] 类别
记录时间:ISO-8601 时间戳 优先级:低 | 中 | 高 | 关键 状态:待处理 区域:前端 | 后端 | 基础设施 | 测试 | 文档 | 配置摘要
学习内容的简要描述详细信息
完整的上下文:发生了什么,什么是错误的,什么是正确的建议操作
具体的修复或改进措施元数据
- 来源:对话 | 错误 | 用户反馈
- 相关文件:路径/文件.ext
- 标签:标签1,标签2
- 参见:LRN-20250110-001(如果与现有条目相关)
错误条目
追加到 .learnings/ERRORS.md 中:
[ERR-YYYYMMDD-XXX] 技能或命令名称
记录时间:ISO-8601 时间戳 优先级:高 状态:待处理 区域:前端 | 后端 | 基础设施 | 测试 | 文档 | 配置摘要
失败的简要描述错误
实际的错误消息或输出上下文
- 尝试的命令/操作
- 输入或参数
- 环境细节(如果相关)
建议修复
如果可以识别,可能的解决方案元数据
- 可复现:是 | 否 | 未知
- 相关文件:路径/文件.ext
- 参见:ERR-20250110-001(如果是重复的)
功能请求条目
追加到 .learnings/FEATURE_REQUESTS.md 中:
[FEAT-YYYYMMDD-XXX] 能力名称
记录时间:ISO-8601 时间戳 优先级:中 状态:待处理 区域:前端 | 后端 | 基础设施 | 测试 | 文档 | 配置请求的能力
用户想要做什么用户上下文
为什么他们需要它,什么问题他们正在解决复杂度估计
简单 | 中 | 复杂建议实现
如何构建它,可能扩展什么元数据
- 频率:首次 | 重复
- 相关功能:现有功能名称
ID 生成格式 类型-YYYYMMDD-XXX 类型:LRN(学习),ERR(错误),FEAT(功能) YYYYMMDD:当前日期 XXX:顺序号或随机 3 个字符(例如 001,A7B) 示例:LRN-20250115-001,ERR-20250115-A3F,FEAT-20250115-002
解决条目 当问题被修复时,更新条目: 更改 状态:待处理 → 状态:已解决 在元数据后添加解决块:
解决
- 解决时间:2025-01-16T09:00:00Z
- 提交/PR:abc123 或 #42
- 备注:简要描述所做的更改
- 在进行中 - 正在积极处理
- 不予修复 - 决定不处理(在解决备注中添加原因)
- 提升 - 提升到
CLAUDE.md、AGENTS.md或.github/copilot-instructions.md中
提升到项目记忆 当学习内容具有广泛的适用性(不是一次性的修复)时,将其提升到永久的项目记忆中。 何时提升
- 学习内容适用于多个文件/功能
- 任何贡献者(人类或 AI)都应该知道的知识
- 防止重复的错误
- 记录项目特定的约定
提升目标
目标 什么属于那里
CLAUDE.md 项目事实,约定,陷阱(所有 Claude 交互)
AGENTS.md 代理特定的工作流程,工具使用模式,自动化规则
.github/copilot-instructions.md 项目上下文和约定(GitHub Copilot)
SOUL.md 行为指南,交流风格,原则(clawdbot)
TOOLS.md 工具能力,使用模式,集成陷阱(clawdbot)
如何提升
- 将学习内容提炼成简洁的规则或事实
- 添加到目标文件的适当部分(如果需要,创建文件)
- 更新原始条目:
CLAUDE.md、AGENTS.md 或 .github/copilot-instructions.md 提升示例 学习(详细): 项目使用 pnpm 工作空间。尝试使用 npm install 但失败。锁文件是 pnpm-lock.yaml。必须使用 pnpm install。
在 CLAUDE.md(简洁)中:
构建和依赖
- 包管理器:pnpm(不是 npm)
- 使用
pnpm install