用途：update-instructions 是 SpecWeave 提供的技能，用于智能合并 CLAUDE.md 和 AGENTS.md 指令文件，在更新 SpecWeave 管理段落的同时保留用户自定义内容。
主要能力：读取已有指令文件；解析以 <!-- SW:SECTION:X --> 标记的 SW 管理段落；保留 SW 段落之间或之后的用户内容；用最新模板内容更新 SW 段落；将合并结果写回文件。合并分三种情况：全新安装（无文件）时创建含全部 SW 段落与 meta 头的新文件；旧版文件（无 SW 标记）时前置新 SW 内容并在分隔符下保留原内容；已标记文件则原地更新 SW 段落并保留段落间的用户内容。
使用方式：在运行 specweave refresh-marketplace 之后、升级 SpecWeave 版本（npm update -g specweave）之后、CLAUDE.md 或 AGENTS.md 显得过时、或需同步指令文件与最新框架功能时使用。命令为 /sw:update-instructions，或通过 CLI：npx specweave update-instructions。
适用场景：维护 Claude Code 与通用 AI 工具的指令文件，使框架段落保持最新而不覆盖个人定制。
限制与说明：影响文件为 CLAUDE.md 与 AGENTS.md。用户自定义内容应放在 SW 段落之间或最后一个段落之后。开始工作前可检查项目特定经验：cat .specweave/skill-memories/update-instructions.md 2>/dev/null || echo "No project learnings yet"。项目经验由反思系统在开发中识别到纠正或模式时自动捕获。其余细节暂未提供。