القائمة
当用户要求在 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。 |
| template-version | 2.0.0 |
| metadata | {"author":"openspec","version":"1.0","generatedBy":"1.1.1"} |
使用这个技能，把已经完成的排错结果沉淀成可复用的长期记忆。
目标是保存根因、有效修复路径、错误假设和验证证据，让后续 agent 不再重复同样的弯路。
核心原则：记录决策链，不记录流水账。
本技能采用双层存储架构：
YYYY-MM-DD-{slug}.md 文件，与 SKILL.md 同目录禁止将完整事故记录正文内嵌到 SKILL.md 中。SKILL.md 中只保留摘要索引。
.agents/skills/fix-bug/record-bug-fix-memory/
├── SKILL.md # 流程指导 + 摘要索引
├── 2026-03-28-unocss-color-safelist.md # 详细案例
├── 2026-03-29-nitro-dual-runtime.md # 详细案例
└── ... # 更多案例文件
YYYY-MM-DD-{slug}.md2026-03-28-unocss-config-driven-color-safelist.md# YYYY-MM-DD {事故简述}
## 1. 问题现象
{从用户视角看，哪里坏了}
## 2. 实际根因
{真正出错的地方}
## 3. 关键误导点
{哪个错误假设或误导信号浪费了时间}
## 4. 有效修复
{真正解决问题的改动}
## 5. 验证方式
{证明修复成功的证据}
## 6. 后续约束
{未来 agent 必须先检查什么、避免什么}
### {事故简述}（YYYY-MM-DD）
- 详细案例：`YYYY-MM-DD-{slug}.md`
- 适用场景：{一句话描述触发条件}
- 关键约束：{一句话核心教训}
在以下场景使用这个技能：
以下情况不要使用这个技能：
开始写记忆前，必须能回答下面六个问题：
如果有任何一个问题答不上来，先完成排错，不要提前写记忆。
gotcha、decision 或 problem-solutionCLAUDE.md、AGENTS.md、GEMINI.mdYYYY-MM-DD-{slug}.md，按必填结构写入详细内容。如果这次 bug 与仓库已有事故模式相似，写记忆时不要遗漏下面这些额外信息：
未来写事故记录时，优先记录可重复验证的证据，而不是模糊措辞。
pnpm exec tsc --noEmit 输出中相关错误为 0fresh dev.stderr 为空修复文件均无类型错误输出pnpm install 后依赖版本一致，peer dependency 无冲突应该没问题了看起来像是好了把根级 AI 记忆经验吸收到技能里，不等于把技能写成修复手册。下面这些内容不应该成为这个技能的主体：
这个技能只负责记忆沉淀和总结。
它不能替代调试、实现、测试和修复工作流。如果 bug 还没修好，先使用合适的调试或实现技能，等结果稳定后再回到这个技能做经验沉淀。
此章节在初始化时为空。随着项目中实际的 bug 修复经验积累，按照第 2.4 节的格式逐步补充摘要索引。 详细案例内容写入同目录下的独立 md 文件，不要写在这里。
.agents/skills/fix-bug/record-bug-fix-memory/*.mdCLAUDE.md、AGENTS.md、GEMINI.md 只在用户明确要求同步 AI 记忆文档时才更新