文章目录
-
- 前言：
- [一、Skill、Spec 核心定义、区别、关系](#一、Skill、Spec 核心定义、区别、关系)
-
- [1. 什么是 Spec](#1. 什么是 Spec)
- [2. 什么是 Skill](#2. 什么是 Skill)
- [3. Skill 与 Spec 的核心关系](#3. Skill 与 Spec 的核心关系)
-
- [1. Spec 和 Skill](#1. Spec 和 Skill)
- [2. Skill 依赖 Spec 运行](#2. Skill 依赖 Spec 运行)
- [3. 组合](#3. 组合)
- [二、 如何设计 Skill、Spec](#二、 如何设计 Skill、Spec)
-
- [1. Spec 设计思路（规范层）](#1. Spec 设计思路（规范层）)
- [2. Skill 设计思路（能力层）](#2. Skill 设计思路（能力层）)
- [三、企业中 Skill、Spec 要求](#三、企业中 Skill、Spec 要求)
- 四、总结
前言：
随着人工智能技术飞速发展，AI 编程工具已深度融入日常研发工作。无论是业务组件开发、样式迭代调整，还是单元测试编写、问题排查修复，AI 都能高效辅助开发者完成各类重复、机械性工作，逐步成为开发提效的核心助力。
在企业 AI 工程化落地与团队规范化协作的趋势下，合理搭建 AI Workflow 变得尤为关键。本文将围绕 Cursor 两大核心能力：Skill 与 Spec，进行概念拆解、关系梳理，并结合企业场景，讲解标准化的设计思路、约束规范与落地实践。
一、Skill、Spec 核心定义、区别、关系
1. 什么是 Spec
核心定位 ：规则、边界、要求
Spec 给 AI 规定的强制约束文档、行为规范、业务契约。
用来定义：
- 团队编码规范、项目技术栈约束
- 输出格式、代码风格、目录结构、命名规则
- 禁止做什么、必须遵守什么、业务专属约定
- 注释要求、文档规范、错误处理标准
例如：
- 必须使用 TS + ESLint 严格模式
- 组件必须使用函数式组件
- 禁止使用 any、必须写类型、统一错误捕获
- 新增功能必须同步写注释和使用示例
2. 什么是 Skill
核心定位 ：能力、动作、可执行的技能
Skill 是赋予 AI 的专项能力、工具调用权限、专属工作流动作。
用来定义：
- AI 能做哪些具体事情
- 执行哪些操作，可以调用哪些工具
- 特定场景下的专属解决流程、任务步骤
- 领域专属知识、业务模块开发能力
例如
- 前端组件开发 Skill：快速搭建页面、封装通用组件
- 代码重构 Skill：批量优化老代码、合并逻辑、解耦
- 接口联调 Skill：自动生成请求函数、TS 类型
- 文档生成 Skill：自动输出接口文档、README
3. Skill 与 Spec 的核心关系
1. Spec 和 Skill
- Spec 定义约束、标准、对错
- Skill 则对应能力、效率、能干多少事
2. Skill 依赖 Spec 运行
AI 在使用 Skill 干活时，必须全程遵守 Spec 约束，才能保证产出的代码不混乱、统一
3. 组合
一套通用团队 Spec，可以搭配多个业务 Skill（组件开发、BUG 修复、脚本开发等）
Spec 约束行为，Skill 则提供能力；
所有 Skill 的执行，都必须在 Spec 的规范框架内完成。
二、 如何设计 Skill、Spec
1. Spec 设计思路（规范层）
设计原则：
- 通用统一：团队内共用基础 Spec，保证代码、文档、输出口径一致
- 轻量化不冗余：只编写硬性约束，不堆砌无效的规则
- 可迭代：跟随项目、技术栈升级持续进行更新
- 强落地：每条规则都能落地校验（代码格式、目录结构等）
Spec 必须包含的内容：
- 技术栈约束：制定框架、语言、版本和依赖使用限制
- 编码规范：包括，命名、缩进、语法、禁止语法、强制最佳实践
- 工程目录规范：文件夹分层、文件命名、模块拆分规则
- 产出物规范：代码注释、日志、报错处理、文档输出格式
- 安全&性能约束：禁止全局污染、禁止硬编码、限制循环嵌套、性能要求
2. Skill 设计思路（能力层）
设计原则：
- 场景拆分：按业务 / 任务进行 Skill 拆分，保证每个 Skill 职责单一
- 可复用：跨项目、跨团队通用
- 流程化：固定执行步骤，减少 AI 随机发挥
- 权限可控：限制高危操作（批量删除、强制改核心逻辑）
常用 Skill 拆分维度：
- 业务开发：组件开发、接口开发、CRUD 逻辑
- 质量优化：代码审查、重构、性能优化、BUG 修复
- 工程能力：脚手架生成、脚本编写、CI/CD 配置
- 文档协作：接口文档、更新日志、知识库整理
三、企业中 Skill、Spec 要求
Spec 要求：
- 语言清晰、无歧义，AI 可精准理解并执行
- 区分「强制要求」「推荐建议」两级规则
- 与团队现有 ESLint/Prettier 项目规范，保持对齐
- 禁止模糊描述，全部为可落地、可校验规则
- 区分：全局通用 Spec 和项目专属私有 Spec
Skill 要求：
- 每个 Skill 必须绑定对应 Spec，杜绝无约束输出
- 固定任务流程，输入要求 -> 执行步骤 -> 输出模板
- 屏蔽危险操作，限制大范围修改核心业务代码
- 输出结果标准化，方便团队 review、合并代码
- 支持团队共享、版本管理，避免每人一套私有的 AI 能力
AI Workflow 协作规范：
- 先加载 项目 Spec 再启用 业务 Skill
- 复杂任务 = 多 Skill 组合执行，而非单次乱问
- AI 产出后，必须以 Spec 为标准做人工校验
- 定期沉淀：把高频优质 AI 流程，固化为新 Skill 规则更新到 Spec
四、总结
Spec 是企业 AI 开发的 规范制度 ，保证统一、标准、可控；
Skill 则是企业 AI 开发的 功能工具 ，提升效率、标准化流程；
AI Workflow 核心是：用 Spec 锁住底线，用 Skill 放大产能。