Menu
当用户要求在 bug 已经定位并修复后，记录排错经验、事故结论、AI 记忆更新、复盘摘要或本地 MCP 记忆时使用。这个技能只负责沉淀"发生了什么、为什么会发生、如何修好、以后要记住什么"，不要把它用于实际修复 bug。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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 还没修好，先使用合适的调试或实现技能，等结果稳定后再回到这个技能做经验沉淀。