告别重复劳动：让你的AI助手拥有“记忆”，一次定义，随处复用

你是否曾在与AI助手协作时，经历过这样的“剧情”？

第一幕：艰难的启航
你启动了一个新项目，兴奋地对AI说：“请帮我创建一个标准的Spring Boot项目，要有Web、JPA、Redis依赖，统一异常处理，Swagger文档配置……” 你耐心地等待，AI生成了一份完美的pom.xml和项目结构。完美！

第二幕：似曾相识的循环
一周后，另一个新项目启动。你再次对AI说：“请帮我创建一个标准的Spring Boot项目，要有Web、JPA、Redis依赖，统一异常处理……” 打住！这对话，这描述，是不是和上周一模一样？你不仅重复输入，AI也在重复生成，宝贵的对话轮次（Token）在重复劳动中悄然流逝。

第三幕：版本管理的噩梦
你优化了异常处理逻辑，或在工具类中添加了新方法。现在，你需要在每一个使用过类似代码的项目中，再次向AI描述这些改动，并手动同步。一致性？维护性？想想就头疼。

如果以上剧情让你会心一笑（或苦笑），那么，请认识一下你未来的“效率救星”——《HAFW Skills 全局复用系统》 及其核心指南文档。

---

为什么会有这份文档？—— 解决AI协作中的“失忆”痛点

这份文档的产生，直指当前AI编程协作中的一个核心矛盾：AI的强大生成能力与其“对话式失忆” 之间的矛盾。

AI可以生成任何你描述的代码，但它不会自动记住你最喜欢的项目模板、你公司的工具库规范、你为自己定制的代码生成器。每次新对话、新项目，都是一次从零开始的重建。这导致：

1. Token的浪费：大量提示词消耗在重复描述相同需求上。
2. 效率的瓶颈：宝贵的创意和调试时间，被基础搭建工作占用。
3. 一致性的风险：手动复制粘贴或重新生成，极易引入不一致和错误。

这份文档，就是为了终结这种低效循环而生的。它是一套面向AI智能体（如Claude Code）的自动化“技能”部署手册，其核心使命是：让你精心设计的、可复用的代码模式（我们称之为“Skill”），像安装软件包一样，一次部署，永久生效，在所有项目中即取即用。

这个文档主要是干嘛的？—— 你的AI技能库“装机盘”

简单说，这份文档是一个全自动的安装与配置脚本，专门写给AI执行者（如Claude Code）看的。当你将这份文档交给AI时，会发生以下魔法：

1. AI自动执行：AI会像一名熟练的系统管理员，自动读取文档中的Bash脚本，并在你的本地电脑上执行一系列操作。
2. 创建中央技能库：它在你的用户目录（如 ~/skills-common/）下建立一个全局技能仓库。你可以把任何可复用的代码模板、工具类、生成器脚本放进去，比如：
   • spring-boot-starter/ (你的标准后端模板)
   • vue3-admin-template/ (你的前端管理台模板)
   • my-company-utils/ (你的公司内部工具包)
   • database-migration-generator/ (你的数据库迁移脚本生成器)
3. 建立项目链接：在任何项目根目录下，AI会创建一个 .hafw/skills/ 目录，并以符号链接的形式，将全局技能库里的技能“映射”到当前项目。这意味着，项目里看到的技能，只是指向中央仓库的一个“快捷方式”。
4. 完成配置：同时，它会建立统一的配置文件 (~/.hafw/config.json)，管理整个系统的行为。

整个过程，你只需要说一句：“请根据这个文档帮我安装系统。” 剩下的，AI全包了。

安装之后，你的世界有何不同？—— 从“重复描述”到“直接调用”

安装完成的那一刻，你和AI的协作模式将彻底升级。

过去的你：

“请创建一个Spring Boot项目，需要以下依赖：spring-boot-starter-web, spring-boot-starter-data-jpa, spring-data-redis… 哦对了，还要有全局的Result包装类，异常处理Advice，格式化的日志配置……”

现在的你：

“使用 spring-boot-starter 技能，创建一个用户管理模块的项目。”

AI瞬间理解你的全部要求，因为它现在可以直接引用 ~/skills-common/spring-boot-starter/ 里你预先定义好的一切。Token用在刀刃上，速度提升十倍。

过去的你：

在不同的项目中，反复解释同样的工具函数该怎么写。

现在的你：

“使用 common-utils 技能里的 Validator 工具，校验这个用户输入参数。”

过去的你：

为每个新表，手动或通过重复提示词让AI生成Controller、Service、Mapper、Entity。

现在的你：

“使用 mybatis-plus-generator 技能，为这张products表生成全套CRUD代码。”

核心优势：一次定义，处处复用

1. 零Token复用：技能一旦存入本地仓库，后续调用无需再描述细节，几乎不消耗提示词长度。
2. 实时同步更新：当你改进中央技能库里的某个技能（比如升级了工具类），所有链接了该技能的项目在下一次AI调用时，都能自动享受到最新版本。
3. AI友好：文档的编写方式完全适配Claude Code等AI智能体的操作模式，AI能无缝理解并自动执行。
4. 无侵入性：采用符号链接，不污染项目原始目录，技能库独立管理，干净整洁。

开始你的高效协作之旅

剧情从这里开始转折。你不再需要是那个在每一个新项目起点都重复“挖井”的人。你只需要做一次定义者，搭建好自己的“武器库”。

下次当你启动AI编程助手时，请先递给它这份《HAFW Skills 全局复用系统》文档。几分钟后，你将拥有一个专属于你、听得懂你“黑话”、记得住你所有“套路”的超级编程伙伴。

https://hafw.halo26812.eu.org/repo/HAFW-SKILLS-INSTALL.md

从此，创造，不再从零开始。