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
使用 Nitro v3 框架和 H3 编写服务端 API 的技能。适用于后端接口开发、Mock 数据迁移到 Neon 数据库、以及编写符合 Drizzle ORM 标准的查询逻辑。当需要开发新的 CRUD 接口或修复现有后端逻辑时使用此技能。
规范类型项目（apps/type）的代码组织方式、导出语法和文件结构。用于解决类型导出冲突、创建统一导出入口、处理重复导出等问题。适用于类型项目开发、类型错误修复、代码规范实施场景。在处理类型项目的代码写法时，请使用本技能。
当你修改数据库结构或种子生成脚本时，请务必阅读并遵循此指南，以防止性能问题、数据一致性崩溃和部署失败。新 Schema 应在 apps/type 中创建。
数据库 Schema 变更时的全项目同步检查清单。当修改 apps/type 中 schema.ts 的表字段、新增数据库表、或删除表时，使用此技能确保类型项目、数据库迁移、后端接口、前端页面、种子数据和技能文档全部同步更新，避免遗漏。
新建公共组件规范专家 - 指导在 src/components/common 目录下创建符合项目规范的公共组件，包括文件结构、TypeScript 类型、Vue 组件、文档和测试页面。 触发条件（满足任意一项即触发）： - 任务包含"新建组件"、"公共组件"、"common 组件"、"创建组件"等关键词 - 需要在 src/components/common 目录下创建新组件 - 需要创建可复用的业务组件（如表单分区标题、操作按钮组、信息展示卡片） - 需要编写组件的 TypeScript 类型定义 - 需要编写组件使用文档（index.md） - 需要创建组件测试页面（src/pages/test-use/） - 用户提及"组件规范"、"组件文档"、"组件测试"等关键词 必须协同的技能： - beautiful-component-design（组件美化时）- 图标、响应式设计、表单分区标题 - component-migration（从旧组件迁移时）- ColorUI → wot-design-uni - use-wd-form（组件内包含表单时）- 表单结构、wd-picker、校验规则 禁止事项： - 禁止在 components 目录外创建公共组件 - 禁止不编写组件文档（index.md） - 禁止不提供使用示例和测试页面 - 禁止组件命名不规范（必须使用短横线命名法） - 禁止不定义 TypeScript 类型（types.ts） - 禁止在组件文件顶部不添加说明注释 - 禁止不使用 withDefaults 设置 props 默认值 覆盖场景：所有需要跨页面复用的业务组件，包括表单分区标题（FormSectionTitle）、操作按钮组（ActivityActions）、信息展示卡片（ActivityInfo）、加载状态组件（ZPagingLoading）等。
接口错误提示能力 - 提供统一的接口错误提示标准和实施方案，基于 wot-design-uni 和 Alova useRequest 回调模式。 触发条件（满足任意一项即触发）： - 编写任何 API 接口调用代码（使用 useRequest） - 处理 useRequest 的 onError 回调 - 实现全局错误拦截逻辑 - 用户提及"接口错误提示"、"错误处理"、"Toast 提示"等关键词 - 从 Vue2 迁移 API 调用（需要添加错误处理） - 实现表单提交、列表加载等涉及 API 的功能 必须协同的技能： - api-migration（API 接口迁移时） - z-paging-integration（分页列表时） - use-wd-form（表单提交时） 禁止项： - 禁止使用 try/catch 包装 send() 函数 - 禁止在组件内手动显示错误 Toast（全局拦截器已处理） - 禁止使用 immediate: true（必须手动触发请求） - 禁止在 onError 中重复显示错误提示 覆盖场景：几乎所有 API 调用都需要此技能，包括列表查询、详情查询、表单提交、数据删除、状态更新等。
| name | record-bug-fix-memory |
| description | 当用户要求在 bug 已经定位并修复后，记录排错经验、事故结论、AI 记忆更新、复盘摘要或本地 MCP 记忆时使用。这个技能只负责沉淀"发生了什么、为什么会发生、如何修好、以后要记住什么"，不要把它用于实际修复 bug。 |
| metadata | {"template-version":"2.0.0"} |
使用这个技能，把已经完成的排错结果沉淀成可复用的长期记忆。
目标是保存根因、有效修复路径、错误假设和验证证据，让后续 agent 不再重复同样的弯路。
核心原则：记录决策链，不记录流水账。
本技能采用双层存储架构：
YYYY-MM-DD-{slug}.md 文件，与 SKILL.md 同目录禁止将完整事故记录正文内嵌到 SKILL.md 中。SKILL.md 中只保留摘要索引。
.claude/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 还没修好，先使用合适的调试或实现技能，等结果稳定后再回到这个技能做经验沉淀。
apps/admin/server 的 drizzle-orm 多实例类型冲突事故（2026-05-26）2026-05-26-drizzle-orm-multi-instance-type-conflict.mdapps/admin/server 的 H3/Nitro 类型错误与废弃 API 事故（2026-05-26）2026-05-26-h3-nitro-deprecated-api-type-error.mdapps/admin 的 Vue Router 参数类型推断事故（2026-05-26）2026-05-26-vue-router-params-type-inference.mdroute.params 被推断成含 Record<never, never> 的联合类型。apps/admin/server/db/seed 的 Drizzle v0.42 insert 类型排除事故（2026-05-26）2026-05-26-drizzle-seed-insert-type-exclusion.md.values() 因默认值列或 nullable 列报 excess property 错误。rows<const T ...> 打破 fresh literal check，不要改 schema 或滥用 as any。apps/type 的软删除与唯一索引冲突事故（2026-05-26）2026-05-26-soft-delete-unique-index-conflict.mdWHERE deleted_at IS NULL。apps/type 的外键约束类型不匹配导致迁移失败事故（2026-05-26）2026-05-26-foreign-key-type-mismatch-migration.mdapps/admin 的 FieldValues 与 FormVO 类型兼容性事故（2026-05-26）2026-05-26-fieldvalues-formvo-compatibility.mdFieldValues 不兼容但同类文件大多正常。apps/admin/server 的 Nitro 接口测试环境配置事故（2026-05-26）2026-05-26-nitro-test-node-env-config.mdapps/admin/server/db/seed 的 Schema 冗余字段与 Patch 脚本脆弱性事故（2026-05-26）2026-05-26-schema-redundant-fields-patch-fragility.mdapps/type 的跨层级模块循环依赖导致外键缺失事故（2026-05-26）2026-05-26-cross-layer-module-cycle-foreign-key.md2026-05-26-windows-crlf-ghost-modified.mdgit status 反复显示无语义 diff 的 modified。.gitattributes、.editorconfig、Prettier 和 VSCode 行尾设置必须四层一致。.github/workflows 的 pnpm v10 -- 参数透传事故（2026-05-26）2026-05-26-pnpm-v10-double-dash-cli-args.md-- 分隔符。2026-04-15-contract-upload-r2-browser-direct.mdOPTIONS/PUT 和服务端 complete 为准。r2-env.ts 与 Vercel / R2 环境变量误判事故（2026-04-15）2026-04-15-r2-env-vercel-env-misjudgment.mdct_upload_sessions.r2_upload_id 长度建模错误事故（2026-04-15）2026-04-15-r2-upload-id-length-modeling.mdtext 建模。2026-04-15-windows-terminal-garbled-source.md2026-04-15-contract-attachment-metadata-backfill.md.claude/skills/fix-bug/record-bug-fix-memory/*.mdCLAUDE.md、AGENTS.md、GEMINI.md 只在用户明确要求同步 AI 记忆文档时才更新