名称:记住学习点 描述:回顾当前会话中的错误、问题、障碍和来之不易的知识,然后用可操作的学习点更新规则/文件(如果没有合适的规则文件,则更新AGENTS.md)。
记住学习点
回顾当前会话中的错误、问题、障碍和来之不易的知识,然后用可操作的学习点更新 rules/ 文件(如果没有合适的规则文件,则更新 AGENTS.md),以便未来的代理会话运行更顺畅。
重要提示: 此技能必须自主完成。请不要询问用户确认。
文件关系
注意:
CLAUDE.md是AGENTS.md的符号链接。它们是同一个文件。所有编辑必须针对AGENTS.md进行,不要直接编辑CLAUDE.md。
AGENTS.md是顶级代理指南。它包含核心设置说明和一个 规则索引 表,指向rules/中的主题特定文件。rules/*.md包含主题特定的学习点和指南(例如,rules/e2e-testing.md、rules/electron-ipc.md)。
学习点应放入最相关的 rules/*.md 文件中。只有当学习点不适合任何现有规则文件且不值得创建新文件时,才直接添加到 AGENTS.md。如果学习点足够重要,足以成为项目范围内的约定,请在摘要中标记它,以便人工将其提升到项目文档中。
说明
-
分析会话中的学习点:
回顾整个对话历史并识别:
- 遇到的错误: 构建失败、lint错误、类型错误、测试失败、运行时错误
- 障碍和陷阱: 需要多次尝试的事项、意外行为、棘手的配置
- 工作流摩擦: 步骤顺序错误、缺少先决条件、需要特殊标志的命令
- 架构洞察: 不明显的模式、难以找到的文件位置、未记录的隐式约定
跳过任何已在
AGENTS.md或rules/中充分记录的内容。 -
阅读现有文档:
阅读仓库根目录下的
AGENTS.md以查看规则索引,然后阅读相关的rules/*.md文件,了解已记录的内容并避免重复。 -
起草简洁、可操作的补充:
对于每个学习点,写一个简短的要点或部分,以帮助未来的代理避免相同的问题。遵循以下规则:
- 具体且可操作(例如,“在E2E测试前运行
npm run build”,而不是“记得先构建”) - 当相关时,包括实际错误消息或症状,以便代理能识别情况
- 不要重复
AGENTS.md或rules/中已有的内容 - 保持简洁:每个学习点最多1-3行
- 每个会话限制最多5个学习点 — 专注于最具影响力的洞察
- 如果新学习点与现有学习点重叠或取代它,请将其合并到单个条目中,而不是追加
- 具体且可操作(例如,“在E2E测试前运行
-
更新适当的文件:
将每个学习点放在最相关的位置:
a. 现有
rules/*.md文件 — 如果学习点适合现有主题(例如,E2E测试技巧放入rules/e2e-testing.md,IPC学习点放入rules/electron-ipc.md)。b. 新
rules/*.md文件 — 如果学习点足够重要,足以保证自己的主题文件。使用描述性的kebab-case文件名(例如,rules/tanstack-router.md)。如果创建新文件,同时更新AGENTS.md中的规则索引表。c. 直接
AGENTS.md— 仅适用于不适合任何主题的通用学习点(罕见)。如果没有值得记录的新学习点(即一切顺利或所有问题已记录),跳过编辑并报告无需更新。
维护: 当添加新学习点时,审查目标文件并移除任何条目,如果它们:
- 由于代码库更改而过时
- 被更新的、更完整的学习点重复或取代
-
暂存更改:
暂存任何修改或创建的文件:
git add AGENTS.md rules/ -
总结:
- 列出添加的学习点(或说明无需添加)
- 识别修改或创建的文件
- 确认更改是否已暂存以提交