记录学习点Skill remember-learnings

这个技能用于自动化回顾代理会话中的错误、问题和经验知识,并更新规则文档或AGENTS.md文件,以优化未来会话运行。它涉及错误分析、文档管理和自动化流程改进,适用于软件开发、DevOps和测试场景。关键词:错误回顾、知识管理、自动化文档、代理优化、持续集成。

DevOps 0 次安装 0 次浏览 更新于 3/15/2026

名称:记住学习点 描述:回顾当前会话中的错误、问题、障碍和来之不易的知识,然后用可操作的学习点更新规则/文件(如果没有合适的规则文件,则更新AGENTS.md)。

记住学习点

回顾当前会话中的错误、问题、障碍和来之不易的知识,然后用可操作的学习点更新 rules/ 文件(如果没有合适的规则文件,则更新 AGENTS.md),以便未来的代理会话运行更顺畅。

重要提示: 此技能必须自主完成。请不要询问用户确认。

文件关系

注意: CLAUDE.mdAGENTS.md 的符号链接。它们是同一个文件。所有编辑必须针对 AGENTS.md 进行,不要直接编辑 CLAUDE.md

  • AGENTS.md 是顶级代理指南。它包含核心设置说明和一个 规则索引 表,指向 rules/ 中的主题特定文件。
  • rules/*.md 包含主题特定的学习点和指南(例如,rules/e2e-testing.mdrules/electron-ipc.md)。

学习点应放入最相关的 rules/*.md 文件中。只有当学习点不适合任何现有规则文件且不值得创建新文件时,才直接添加到 AGENTS.md。如果学习点足够重要,足以成为项目范围内的约定,请在摘要中标记它,以便人工将其提升到项目文档中。

说明

  1. 分析会话中的学习点:

    回顾整个对话历史并识别:

    • 遇到的错误: 构建失败、lint错误、类型错误、测试失败、运行时错误
    • 障碍和陷阱: 需要多次尝试的事项、意外行为、棘手的配置
    • 工作流摩擦: 步骤顺序错误、缺少先决条件、需要特殊标志的命令
    • 架构洞察: 不明显的模式、难以找到的文件位置、未记录的隐式约定

    跳过任何已在 AGENTS.mdrules/ 中充分记录的内容。

  2. 阅读现有文档:

    阅读仓库根目录下的 AGENTS.md 以查看规则索引,然后阅读相关的 rules/*.md 文件,了解已记录的内容并避免重复。

  3. 起草简洁、可操作的补充:

    对于每个学习点,写一个简短的要点或部分,以帮助未来的代理避免相同的问题。遵循以下规则:

    • 具体且可操作(例如,“在E2E测试前运行 npm run build”,而不是“记得先构建”)
    • 当相关时,包括实际错误消息或症状,以便代理能识别情况
    • 不要重复 AGENTS.mdrules/ 中已有的内容
    • 保持简洁:每个学习点最多1-3行
    • 每个会话限制最多5个学习点 — 专注于最具影响力的洞察
    • 如果新学习点与现有学习点重叠或取代它,请将其合并到单个条目中,而不是追加
  4. 更新适当的文件:

    将每个学习点放在最相关的位置:

    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 — 仅适用于不适合任何主题的通用学习点(罕见)。

    如果没有值得记录的新学习点(即一切顺利或所有问题已记录),跳过编辑并报告无需更新。

    维护: 当添加新学习点时,审查目标文件并移除任何条目,如果它们:

    • 由于代码库更改而过时
    • 被更新的、更完整的学习点重复或取代
  5. 暂存更改:

    暂存任何修改或创建的文件:

    git add AGENTS.md rules/
    
  6. 总结:

    • 列出添加的学习点(或说明无需添加)
    • 识别修改或创建的文件
    • 确认更改是否已暂存以提交