القائمة
初始化和增量更新 AI 记忆文件（CLAUDE.md、AGENTS.md、GEMINI.md）。 通过交互式选择和差异对比，智能补全记忆项内容。触发条件： 当用户提及初始化记忆文件、更新 CLAUDE.md、同步 AI 记忆、 init-ai-md 等关键词时主动调用。
التثبيت باستخدام 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.
在 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 客户端检查项目状态与触发部署。
初始化或更新 VSCode 配置文件（.vscode/extensions.json 和 .vscode/settings.json）， 并在合并现有配置时把 `files.eol` 明确收敛为 `"\n"`，配合 `.gitattributes`、 `.editorconfig`、Prettier 解决 Windows 上的 CRLF/LF 漂移与 git 幽灵修改问题， 同时补齐大型 monorepo 的 VSCode 启动慢、文件监听、搜索索引与 TypeScript Server 性能优化默认值。 只要用户提到初始化 vscode、编辑器配置、工作区设置、行尾统一、EOL、CRLF/LF、 幽灵修改、团队规范、VSCode 启动慢、大仓库性能、文件监听降噪、搜索索引优化， 都应该使用本技能。
| name | init-ai-md |
| description | 初始化和增量更新 AI 记忆文件（CLAUDE.md、AGENTS.md、GEMINI.md）。 通过交互式选择和差异对比，智能补全记忆项内容。触发条件： 当用户提及初始化记忆文件、更新 CLAUDE.md、同步 AI 记忆、 init-ai-md 等关键词时主动调用。 |
| user-invocable | true |
| metadata | {"version":"0.21.0"} |
本技能用于在项目中快速初始化和增量更新 AI 记忆文件。通过交互式选择和差异对比补全，帮助用户精确管理 AI 记忆文件内容。
.agents/skills/ 目录下的现有技能，在 CLAUDE.md 中创建并维护「本项目的技能表」章节record-bug-fix-memory 等内置技能模板部署到项目的 .agents/skills/ 目录中CLAUDE.md 文件/init 斜杠命令CLAUDE.md 文件以中文编写扫描目标文件：
CLAUDE.md 中所有的二级标题（## xxx）扫描模板目录：
templates/ 目录下的所有模板文件名01.xxx.md、02.xxx.md）对比分析：
必须使用 AskUserQuestion 工具与用户交互：
展示扫描结果：
生成选择问题：
AskUserQuestion 工具的 multiSelect: true 模式[缺失] - 目标文件中不存在[需更新] - 存在但内容不完整[已完整] - 内容已完全一致[缺失]和[需更新]的记忆项询问示例：
请选择需要处理的记忆项：
选项：
- 主动问询实施细节 [需更新] - 内容存在差异，将补全缺失部分
- 编写测试用例规范 [缺失] - 将新增此记忆项
- 报告编写规范 [已完整] - 内容一致，无需更新
- 获取技术栈对应的上下文 [需更新] - 缺少部分链接
等待用户选择：
对用户选择的每个记忆项，执行精细的差异对比：
逐行对比原则：
识别差异类型：
增量补全策略：
示例：
假设目标文件 CLAUDE.md 存在以下内容：
## 获取技术栈对应的上下文
### claude code skill
- 编写语法与格式： https://code.claude.com/docs/zh-CN/skills
- 最佳实践： https://platform.claude.com/docs/zh-CN/agents-and-tools/agent-skills/best-practices
模板文件 99.获取技术栈对应的上下文.md 的内容：
## 获取技术栈对应的上下文
在处理特定技术栈相关的问题时，你应该主动获取对应的上下文文档和最佳实践。
### claude code skill
- 编写语法与格式： https://code.claude.com/docs/zh-CN/skills
- 最佳实践： https://platform.claude.com/docs/zh-CN/agents-and-tools/agent-skills/best-practices
- 规范文档： https://agentskills.io/home
正确的处理方式：
禁止事项：
在完成 CLAUDE.md 内容更新后，检查项目是否需要部署或升级内置技能：
检查技能模板目录：
templates/record-bug-fix-memory/ 目录，确认内置技能模板可用template-version 字段（当前为 2.0.0）检测旧格式遗留（迁移检测）：
.claude/skills/fix-bug/record-bug-fix-memory/SKILL.md.agents/skills/fix-bug/record-bug-fix-memory/SKILL.md 不存在：
[旧格式可迁移].claude/skills/ 整个目录的内容移动到 .agents/skills/，然后删除旧的 .claude/skills/ 目录检查项目现有技能（新格式）：
.agents/skills/fix-bug/record-bug-fix-memory/SKILL.md[可部署]template-version 字段
[需升级][已是最新]判断是否为旧版单层架构：
[需升级]，检查现有 SKILL.md 是否内嵌了大段事故记录正文### 三级标题下是否存在超过 10 行的内容块[需升级 + 需拆分]询问用户：
AskUserQuestion 工具询问用户需要执行的操作[可部署]、[需升级]、[需升级 + 需拆分]、[旧格式可迁移]、[已是最新]执行部署或升级：
情况 A：全新部署（[可部署]）
templates/record-bug-fix-memory/SKILL.md 复制到项目的 .agents/skills/fix-bug/record-bug-fix-memory/SKILL.md情况 B：升级骨架（[需升级]，无内嵌案例）
情况 C：升级 + 拆分（[需升级 + 需拆分]）
### 三级标题 + 正文）YYYY-MM-DD-{slug}.md
情况 D：旧格式迁移（[旧格式可迁移]）
.claude/skills/ 下存在旧格式的技能（v0.19.0 及之前版本使用 .claude 前缀）.agents/skills/ 作为技能目录（v0.20.0+）.agents/skills/ 目录（如不存在）.claude/skills/ 下所有内容完整移动到 .agents/skills/.claude/skills/ 目录.agents/skills/）执行步骤 6 的技能扫描和技能表生成在步骤 5 完成后（无论是否部署了新技能），都需要生成或更新技能表：
扫描项目技能：
.agents/skills/ 目录下的所有 SKILL.md 文件.agents/skills/ 不存在，回退检查 .claude/skills/（旧格式遗留），若存在旧格式则提示用户先执行步骤 5 的迁移操作name 和 description（从 YAML frontmatter 中提取）生成技能表内容：
templates/08.本项目的技能表.md 的格式- `{技能名称}`
- 路径：`{技能相对路径}`
- 用途：{技能描述}
- 触发时机：{从技能 SKILL.md 中提取的使用场景}
- 参考作用：{从技能 SKILL.md 中提取的参考信息}
- 约束：{从技能 SKILL.md 中提取的边界约束}
record-bug-fix-memory：该技能采用双层存储架构，技能表条目必须额外包含存储架构说明和阅读指引，格式如下：
- `record-bug-fix-memory` — `.agents/skills/fix-bug/record-bug-fix-memory/SKILL.md` — bug 修复后的经验与事故记录沉淀（非调试流程本身）。
- **存储架构**：双层存储。SKILL.md 只放流程指导和摘要索引，详细案例存储在同目录下的独立 `YYYY-MM-DD-{slug}.md` 文件中。
- **阅读方式**：使用此技能前，先读 SKILL.md 了解流程，再根据「案例索引」章节按需读取相关的独立案例文件。
- **写入方式**：新增经验时，创建独立案例文件，同时在 SKILL.md 的「案例索引」追加摘要。禁止将完整事故正文写入 SKILL.md。
插入或更新 CLAUDE.md：
技能表位置要求：
AGENTS.md 或 GEMINI.md 文件AskUserQuestion 工具询问用户CLAUDE.md 全量替换这些文件init-ai-md/
├── SKILL.md # 技能说明文件
└── templates/ # 模板文件目录
├── 01.主动问询实施细节.md
├── 02.编写测试用例规范.md
├── 03.报告编写规范.md
├── 04.生成发版日志的操作规范.md
├── 05.沟通协作要求.md
├── 06.终端操作注意事项（防卡住）.md
├── 07.简单任务的高效执行原则.md
├── 08.本项目的技能表.md # 技能表章节模板
├── 09.Karpathy Guidelines.md # Karpathy 编码行为准则模板
├── 10.使用superpower技能的个人偏好.md
├── 99.获取技术栈对应的上下文.md
└── record-bug-fix-memory/ # 内置技能模板
└── SKILL.md # record-bug-fix-memory 技能模板
..mdtemplates/ 目录下除了序号前缀的记忆项模板外，还可以包含子目录形式的内置技能模板：
templates/record-bug-fix-memory/）SKILL.md 文件SKILL.md 遵循 Claude Code Skills 的 YAML frontmatter 规范.agents/skills/{类别}/{技能名}/SKILL.md用户：请帮我初始化 AI 记忆文件
执行流程：
1. 检测到无 CLAUDE.md → 执行 /init 命令
2. 扫描 templates/ 目录，建立可用记忆项清单
3. 使用 AskUserQuestion 询问用户需要哪些记忆项
4. 用户选择后，按序号顺序插入选中的模板内容
5. 检测到无 AGENTS.md/GEMINI.md → 完成
用户：请更新我的 CLAUDE.md 记忆文件
执行流程：
1. 检测到已有 CLAUDE.md → 读取现有内容
2. 扫描现有二级标题，建立现存记忆项清单
3. 扫描 templates/ 目录，建立可用记忆项清单
4. 对比分析，标注每个记忆项的状态（缺失/需更新/已完整）
5. 使用 AskUserQuestion 询问用户需要处理哪些记忆项
6. 用户选择后，对每个选中项执行差异对比和增量补全
7. 检测到存在 AGENTS.md → 询问用户是否同步替换
8. 用户确认后执行替换
用户：更新 CLAUDE.md 中的"获取技术栈对应的上下文"章节
执行流程：
1. 读取 CLAUDE.md 中该章节的完整内容
2. 读取模板 99。获取技术栈对应的上下文。md 的内容
3. 逐行对比，发现：
- 缺失描述段落
- 缺失"规范文档"链接
4. 在对应位置补全缺失内容
5. 保持原有的自定义内容不变
用户：请帮我初始化 AI 记忆文件
执行流程：
1. 检测到无 CLAUDE.md → 执行 /init 命令
2. 扫描 templates/ 目录，建立可用记忆项清单
3. 使用 AskUserQuestion 询问用户需要哪些记忆项
4. 用户选择后，按序号顺序插入选中的模板内容
5. 检查 .agents/skills/ → 不存在 record-bug-fix-memory
6. 使用 AskUserQuestion 询问用户是否部署 record-bug-fix-memory 技能
7. 用户确认 → 创建 .agents/skills/fix-bug/record-bug-fix-memory/SKILL.md
8. 扫描 .agents/skills/ 全部技能 → 生成「本项目的技能表」章节
9. 将技能表插入 CLAUDE.md 的开头位置（一级标题之后、其他二级标题之前）
10. 检测到无 AGENTS.md/GEMINI.md → 完成
用户：请更新我的 CLAUDE.md 记忆文件
执行流程：
1. 检测到已有 CLAUDE.md → 读取现有内容
2. 扫描 templates/ 和已有记忆项 → 对比分析
3. 用户选择更新记忆项 → 执行差异补全
4. 检查 .agents/skills/ → 发现已有 record-bug-fix-memory
5. 扫描 .agents/skills/ → 发现用户新增了 code-style 技能
6. 对比现有技能表 → 识别新增技能
7. 补全技能表，新增 code-style 条目
8. 检测到存在 AGENTS.md → 询问用户是否同步替换
「本项目的技能表」章节的作用是让 agent 在读取 CLAUDE.md 时，能够快速了解项目中可用的技能清单，包括：
这帮助 agent 在合适的场景下主动调用正确的技能，而不需要逐个扫描 .agents/skills/ 目录。
每个技能条目遵循以下格式（参考 templates/08.本项目的技能表.md）：
- `{技能名称}`
- 路径：`.agents/skills/{类别}/{技能名}/SKILL.md`
- 用途：{技能描述，从 YAML frontmatter 的 description 字段提取}
- 触发时机：{从 SKILL.md 的"何时使用"章节提取关键触发条件}
- 参考作用：{技能的辅助参考价值}
- 约束：{技能的边界限制}
AskUserQuestion 询问用户是否移除该条目这是一个专用于 bug 修复经验沉淀的技能，采用双层存储架构。部署后：
.agents/skills/fix-bug/record-bug-fix-memory/SKILL.mdtemplates/record-bug-fix-memory/SKILL.md（template-version: 2.0.0）YYYY-MM-DD-{slug}.md，与 SKILL.md 同目录YYYY-MM-DD-{slug}.md部署或升级 record-bug-fix-memory 后，在 CLAUDE.md 的技能表中生成的条目必须包含以下信息，确保 agent 能正确使用双层架构：
- `record-bug-fix-memory` — `.agents/skills/fix-bug/record-bug-fix-memory/SKILL.md` — bug 修复后的经验与事故记录沉淀（非调试流程本身）。
- **存储架构**：双层存储。SKILL.md 只放流程指导和摘要索引，详细案例存储在同目录下的独立 `YYYY-MM-DD-{slug}.md` 文件中。
- **阅读方式**：使用此技能前，先读 SKILL.md 了解流程，再根据「案例索引」章节按需读取相关的独立案例文件。
- **写入方式**：新增经验时，创建独立案例文件，同时在 SKILL.md 的「案例索引」追加摘要。禁止将完整事故正文写入 SKILL.md。
这段描述确保任何 agent 在读取 CLAUDE.md / AGENTS.md 后，都能准确理解：
在步骤 3 交互选择时，必须按以下格式调用 AskUserQuestion 工具：
header: "记忆项"multiSelect: truelabel 格式：记忆项名称 [状态]description 说明该选项的具体操作[缺失]：目标文件中不存在该二级标题[需更新]：标题存在但内容与模板有差异（缺少行/段落）[已完整]：内容与模板完全一致[缺失] 状态的记忆项 → 在合适位置插入完整模板内容[需更新] 状态的记忆项 → 执行差异对比，仅补全缺失部分[已完整] 状态的记忆项 → 跳过或提示无需更新本技能应在以下场景主动调用：
判断内容需要更新的依据：
详细的模板内容请查看 templates/ 目录下的各个模板文件。