菜单
当用户要求在 bug 已经定位并修复后，记录排错经验、事故结论、AI 记忆更新、复盘摘要或本地 MCP 记忆时使用。这个技能只负责沉淀"发生了什么、为什么会发生、如何修好、以后要记住什么"，不要把它用于实际修复 bug。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when 需要为 pnpm monorepo 从零接入 relizy + bumpp 组合发版方案，或处理 init relizy、init bumpp、接入发版、monorepo 发版初始化、relizy + bumpp、 relizy.config、bump.config、changelog.config、独立版本、GitHub Release 自动化。
当 Windows 或 PowerShell 的 agent team 会话结束后，出现疑似孤儿 node 进程、可证明归属当前 run 的残留 MCP 或开发服务器子进程、残留 Node 监听器，或多代理自动化后的 Node 进程归属不清时使用。 Use when Windows or PowerShell agent-team sessions leave suspected orphan node processes, stale MCP or dev-server children provably owned by the current run, lingering Node listeners, or unclear Node ownership after multi-agent automation.
当复杂开发、修复、重构、迁移、验证或 OpenSpec change 需要跨可恢复 checkpoint 持续推进、 需要在上下文丢失后恢复，或需要把进度与失败记录写入持久文件时使用； 当用户要求生成 Claude Code `/goal`、Codex `/goal` 或 do-long-task 长任务提示词时也使用。 不要用于一次性短改、问答、简单格式化、changeset、发版日志或纯计划讨论。 Use when a complex development, fix, refactor, migration, verification, or OpenSpec change must be advanced across resumable checkpoints, recovered after context loss, or executed with durable progress and failure notes; also use when the user asks to generate a Claude Code `/goal`, Codex `/goal`, or do-long-task prompt. Do not use for short one-off edits, Q&A, simple formatting, changesets, release notes, or pure planning.
Use when 需要处理 pnpm 包管理、workspace 命令、npm/npx/yarn 到 pnpm 的替换、Windows 或 PowerShell pnpm 故障、Corepack 管理的 pnpm、NVM Desktop 切换 Node 后的路径错位、全局包更新、ERR_PNPM_UNEXPECTED_VIRTUAL_STORE、virtual-store-dir 混淆、PNPM_HOME/global-dir/store-dir 诊断，或 pnpm install/update/rebuild 排障；English: handling pnpm package management, workspace commands, npm/npx/yarn replacement, Windows or PowerShell pnpm failures, Corepack-managed pnpm, NVM Desktop Node switches, global package updates, ERR_PNPM_UNEXPECTED_VIRTUAL_STORE, virtual-store-dir confusion, PNPM_HOME/global-dir/store-dir diagnosis, or pnpm install/update/rebuild troubleshooting.
初始化和增量更新 AI 记忆文件（CLAUDE.md、AGENTS.md、GEMINI.md）。 通过交互式选择和差异对比，智能补全记忆项内容。触发条件： 当用户提及初始化记忆文件、更新 CLAUDE.md、同步 AI 记忆、 init-ai-md 等关键词时主动调用。
在 pnpm workspace 组织的 monorepo 或独立仓库中完成 Vercel 部署的辅助型技能。 先按"部署形态"分层（monorepo 子包 / 独立仓库），再按框架（Nuxt、Nitro、Vite、UniApp H5） 给出模板。覆盖 Root Directory、Output Directory、Build Command、package.json 脚本与 turbo.json 任务链配置，解决 pnpm workspace 依赖解析和产物路径问题。本地配置完成后可 排查 vercel.json 覆盖、多项目配置污染和 .vercel/project.json 绑定问题，并结合支持 Vercel MCP 的 AI 客户端检查项目状态与触发部署。
| name | record-bug-fix-memory |
| description | 当用户要求在 bug 已经定位并修复后，记录排错经验、事故结论、AI 记忆更新、复盘摘要或本地 MCP 记忆时使用。这个技能只负责沉淀"发生了什么、为什么会发生、如何修好、以后要记住什么"，不要把它用于实际修复 bug。 |
| license | MIT |
| compatibility | Requires a project with AI memory documents (CLAUDE.md / AGENTS.md / GEMINI.md) and optional Memorix MCP access. |
| template-version | 2.0.0 |
| metadata | {"author":"openspec","version":"1.0","generatedBy":"1.1.1"} |
使用这个技能，把已经完成的排错结果沉淀成可复用的长期记忆。
目标是保存根因、有效修复路径、错误假设和验证证据，让后续 agent 不再重复同样的弯路。
核心原则：记录决策链，不记录流水账。
在以下场景使用这个技能：
以下情况不要使用这个技能：
开始写记忆前，必须能回答下面六个问题：
如果有任何一个问题答不上来，先完成排错，不要提前写记忆。
CLAUDE.md、AGENTS.md、GEMINI.mdgotcha、decision 或 problem-solution默认规则：只要这条经验会影响整个仓库里的未来 agent，就优先写入三个根级 AI 记忆文档，不要埋进包级备注里。
每条记忆至少要覆盖这六件事：
使用简洁、面向未来复用的结构：
问题现象：...根因：...关键误导点：...有效修复：...验证方式：...后续约束：...这些句子应该帮助未来 agent 快速做对事，而不是复述完整排错过程。
双层存储架构下，详细事故记录不写入 SKILL.md，而是存放在同目录的独立案例文件中。
每条案例文件命名格式：YYYY-MM-DD-{slug}.md，例如 2026-03-15-cursor-phantom-modify.md。
案例文件建议包含以下章节：
仓库级事故记录已拆分为独立案例文件，按时间排序如下：
2026-03-01-git-phantom-modifications-cursor.md — 本 monorepo 的 Git 状态与 Cursor「幽灵修改」
2026-03-01-crlf-loop-phantom-modified.md — Windows CRLF 残留导致「循环幽灵 modified」
2026-04-01-codex-memorix-mcp-startup.md — Windows 下 Codex 无法拉起 Memorix MCP
2026-04-01-codex-memorix-roots-list.md — Codex 与 Memorix 的 roots/list 兼容问题
2026-06-30-consola-node24-esm-resolve.md — consola@3.4.2 在 Node.js 24 CI 下导致 automd 崩溃；前期尝试 pnpm patch 与运行时 index.js 垫片，最终通过 CJS wrapper 绕过 automd CLI 入口彻底规避
2026-07-02-git-commit-broken-rename.md — AI agent 在执行 git-commit 分门别类拆分时将文件移动误判为删除+新增两个独立提交，导致 rename 追踪断裂；修复方式为 soft reset + 合并暂存重提交
2026-07-02-git-commit-skill-violation.md — AI agent 在 git-commit 分门别类拆分时连续违反技能规范：emoji 错误（style 用 💅 而非 🌈）、publish 发版遗漏 6 个版本文件、反复 reset 补救导致 rebase 冲突；修复方式为先查阅 commit-types.ts 再提交、同步全部版本文件、stash 无关文件后 rebase
2026-07-02-use-vercel-deploy-skill-pitfalls.md — 新建 use-vercel-deploy-in-monorepo skill 时因未先验证 Git 仓库连接、未追溯 bin 来源、通用 skill 写死 AI 客户端名称、模板形态与脚本不一致导致多次返工；修复方式为 Vercel CLI/API 实锤核对、按部署形态分层、明确依赖来源、删除硬编码、统一模板逻辑
2026-07-02-sync-local-global-agents-skills-design-pitfalls.md — 新建 sync-local-global-agents-skills 通用 skill 时把仓库源码路径与安装后路径混用，脚本位置、SKILL.md 示例、测试文件引用均出现偏差；修复方式为脚本迁入 skill 目录、文档使用相对路径、删除 monorepo 专属引用、重写计划与代码一致
新增事故记录时，先创建独立案例文件，再在本索引追加一行摘要。禁止将完整事故正文直接写入 SKILL.md。
如果这次 bug 与仓库已有事故模式相似，写记忆时不要遗漏下面这些额外信息：
未来写事故记录时，优先记录可重复验证的证据，而不是模糊措辞。
pnpm exec tsc --noEmit 输出中相关错误为 0fresh dev.stderr 为空修复文件均无类型错误输出pnpm install 后依赖版本一致，peer dependency 无冲突应该没问题了看起来像是好了把根级 AI 记忆经验吸收到技能里，不等于把技能写成修复手册。下面这些内容不应该成为这个技能的主体：
这个技能只负责记忆沉淀和总结。
它不能替代调试、实现、测试和修复工作流。如果 bug 还没修好，先使用合适的调试或实现技能，等结果稳定后再回到这个技能做经验沉淀。