背景

用 AI 写代码一段时间后我发现一个很反直觉的问题：我们其实已经有一些“常用方法”，但它们无法复用：

• A 项目好的 AI。在 B 项目完全失忆
• 规则散落在 prompt / 文档 / IDE 配置中，无法版本化
• 每次新项目，都在重复“驯化 AI”

既然代码可以用 Git 管理、用 NPM 分发，为什么 AI 规范还停留在“复制粘贴”？本质问题是的观点是，我一直把规则当“文本”，而不是“代码”。

把规则当代码看

如果把 AI 规则当作代码。它应该具备三个能力：

• 可组合 → 不同规则可以拆分、复用
• 可分发 → 像 npm 包一样安装
• 可演进 → 有版本、有变更记录

否则它就不是工程资产，而只是碎片化经验沉淀。一个规范，如果不能被 install，那它本质上只是不成程序的经验。

Skill 的最小抽象模型

说到那问题来了。一个“可安装的 AI 规范”，在工程上到底长什么样？

最小结构其实比较简单：

my-skill/├── SKILL.md├── rules/├── package.json

但真正的关键不是结构，而是它解决的问题。

1️⃣ rules目录 让 AI “分块理解”，而不是“整体吞咽”

传统方式是把所有规则写在一个 prompt 里但这会导致：

再看拆分之后，

• behavior rules：开发行为约束
• optimization rules：代码质量调整规则

AI 不再“理解一坨规则”，而是按职责加载规则上下文

2️⃣ SKILL.md 让 AI 知道“自己在哪个程序里”

AI 最大的问题不是不会写代码，而是：

SKILL.md 本质是一个“运行时契约”：

name: project-core-standardsdescription: 项目的主要代码规范、行为准则与架构要求version: .author: Admin

它定义的不是规则内容，而是：规则程序的身份边界

3️⃣ package.json 从“规则文件”升级为“能力模块”

一旦进入 npm 程序，规则就发生了本质变化： 从“文档”变成“可安装能力”

从真实使用方式来看。 一行命令安装自定义skills

这套自定义的skills最终是这样被使用的：

npx project-core-standards init

执行后会进入一个交互式初始化流程：

Welcome to Project Core Standards SetupPlease select IDEs you want to generate rules for: Cursor Windsurf Antigravity / Gemini GitHub Copilot Cline / Roo Code Codex All of aboveEnter your choices :

这一步的意义非常关键：同一套规则，可以适配所有主流 AI 编程环境说白了：不再是“适配工具”，而是“统一规则源”

最终 Skill 的形态

最终，我把这套程序封装成了一个 npm 包： project-core-standards

它的主要结构如下：

---name: project-core-standardsdescription: 项目的主要代码规范、行为准则与架构要求。适用于所有需要编写代码、重构或进行代码审查的场景。version: "."author: "Admin"---

两个主要规则。Skill 的真正价值，不是结构，而是规则本身。

. Agent 行为与全局开发规范

涵盖主要开发底线：- commit 规范化- pnpm 作为唯一包管理方式- Vue 项目结构约束- TypeScript 强制类型约束- 数据库变更必须可追踪- 组件必须可复用、不可重复造轮子

这个规则解决的是：AI 写代码“失控”的问题

. 代码简化与调整专家原则

主要目标：保持功能不变的前提下调整代码质量原则包括：- 优先简化逻辑。而不是增加抽象- 删除重复代码，而不是复制模式- 提高可读性优先于“设计模式正确性”- 避免过度工程化- 保持结构一致性

这个规则解决的是： AI 过度设计 / 复杂化代码的问题

说到真正的难点，无损同步机制

分发不是问题，问题是： 如何更新规则，而不破坏项目已有定制？ 这里的设计主要是 Marker：

同步逻辑的观点是，

• 检测 marker → 精准替换区块
• 无 marker → 自动安全注入

再看本质是，局部 patch，而不是文件 overwrite

工程实现关键点，在 CLI 层：

• 使用 `INIT_CWD` 定位真实项目方法
• install 阶段自动触发同步
• 基于 AST + regex 做安全替换

再看主要思想是。把 Git 的 diff 能力，搬进 AI 规则程序

当规则变成基础设施

引入 project_core_standards 后开发流程变成：

以前这方面，

至于现在，

当 AI 成为开发流程的一部分，一个新的层级出现了：

• 应用代码层
• 工程工具层
• AI 规则层

而 Skill 的意义是 ： 让 AI 行为本身，变成可工程化管理的资产

未来可能会变成这样 ：不再“ AI”，而 是 “安装开发规范”。想了解详细的规则内容可以点击这里查看。

---