用 AI Skill 封装你的工作流：从代码规范到全流程提效实战
用 Skill 文件把重复的”人肉提示词工程”封装成一次编写、永久生效的 AI 工具包——涵盖 6 个开箱即用的模板和 SOUL/SKILL/AGENTS/MEMORY 四文件体系
基本信息
- 来源类型：网页文章（掘金）
- 原文位置：raw/articles/2026-06-10-142854-tg-4452cc.md
- 原文 URL：https://juejin.cn/post/7636672136044281897
- 作者：Rik
- 发布日期：2026-05-06
- 阅读量：3,132
- 消化日期：2026-06-10
核心观点
-
“人肉提示词工程”是 AI 开发的真实痛点：用 Cursor/Windsurf/OpenClaw 一段时间后，开发者会陷入每次对话都要重复声明技术栈（React+TypeScript+Tailwind）、编码规范（不用 var、遵循 ESLint）、Review 检查项（空值处理、错误边界）的循环。本质是用自然语言手动维护一套”规范系统”，每次会话都要重新加载——效率低、不一致、有遗漏、不可复用。
-
AI 世界的四文件体系对应人类组织结构：SOUL.md 对应员工手册（AI 身份认知），SKILL.md 对应岗位 SOP（技能包），AGENTS.md 对应项目规范文档（项目规则），MEMORY.md 对应经验教训库（历史记忆）。这四层构成了 AI 协作的完整上下文资产体系。
-
Skill 文件本质是写给 AI 的 SOP：它是一个 Markdown 文件（通常叫 SKILL.md），放在特定目录下，AI 工具在合适时机自动加载。与每次手动输入 Prompt 不同，Skill 实现”一次编写，永久生效”——跨项目复用、版本化管理（Git 追踪变更）、按需加载不浪费 token。
-
Skill 加载是分层按需的，不是全量塞入：全局 Skill（
~/.cursor/skills/）所有项目生效，适合通用规范；项目级 Skill（项目/.cursor/skills/）只在当前项目生效，适合项目特定规范。AI 根据当前任务内容自动匹配相关 Skill，不相关的不会加载——节省 token。 -
6 个开箱即用的 Skill 模板覆盖主流开发场景：Java Spring Boot 规范（分层架构+统一返回+异常处理+数据库规范）、React+TypeScript 前端规范（函数式组件+状态管理+Tailwind+严格 TS）、Code Review 检查清单（P0 安全性→P1 正确性→P2 性能→P3 可维护性四级）、Git Commit 规范（Conventional Commits 格式）、RESTful API 设计规范（URL+HTTP 方法+状态码+分页+错误返回）、Prompt Engineering 规范（结构化提示词模板）。
实操内容保留
代码/配置
Java Spring Boot Skill 模板核心部分：
### 分层架构
- Controller：参数校验 + 调用 Service + 返回 VO
- Service：业务逻辑，注入 Mapper，事务在这层
- Mapper：继承 BaseMapper<T>，复杂 SQL 用 XML
- DTO：接收前端参数，用 @Valid 校验
- VO：返回给前端的数据结构
### 统一返回格式
所有 API 返回 Result<T>：
{
"code": 200,
"message": "success",
"data": {}
}
### 禁止事项
- 禁止在 Controller 写业务逻辑
- 禁止硬编码魔法数字
- 禁止直接拼 SQL（防注入）
- 禁止 System.out.println（用 log）React + TypeScript Skill 模板核心部分：
### 组件规范
- 使用函数式组件 + Hooks，禁止 Class 组件
- 组件文件名：PascalCase（UserProfile.tsx）
- 每个组件一个文件，不超过 200 行
- Props 必须定义 interface，不用 any
- 导出方式：named export（不用 default export）
### TypeScript 规范
- 严格模式（strict: true）
- 禁止 any，用 unknown 替代
- 接口用 interface，类型别名用 type
- 枚举用 const enum 或 as constCode Review Skill 模板（四级优先级）：
### P0 — 安全性
- [ ] SQL 注入风险
- [ ] XSS 风险
- [ ] 敏感信息硬编码（密码、密钥、Token）
- [ ] 权限校验是否完整
### P1 — 正确性
- [ ] 空值处理（null/undefined/空数组/空字符串）
- [ ] 边界条件（空集合、负数、超大数）
- [ ] 并发安全（竞态条件、死锁风险）
### P2 — 性能
- [ ] N+1 查询问题
- [ ] React 不必要的重渲染
### P3 — 可维护性
- [ ] 命名是否清晰
- [ ] 函数是否过长（>50 行考虑拆分）
- [ ] 重复代码（DRY 原则）操作步骤
Skill 文件的放置与加载：
- 全局 Skill 放在
~/.cursor/skills/或~/.openclaw/skills/（所有项目生效，适合通用规范如代码风格、Git 提交规范） - 项目级 Skill 放在
项目/.cursor/skills/（只在当前项目生效，适合项目特定规范如 API 设计、数据库规范） - AI 根据当前任务内容自动匹配相关 Skill——写 Java 代码时自动加载 java-spring Skill，做 Code Review 时自动加载 code-review Skill
- 不相关的 Skill 不会加载，节省 token
关键概念
- Skill — SKILL.md 文件，写给 AI 的 SOP，本文的核心主题，提供了 6 个实战模板和四文件体系
- AGENTS.md 规范文件 — 项目级规则文件，对应人类组织的”项目规范文档”
- Cursor — 本文提到的 AI 开发工具之一，Skill 文件放置在
.cursor/skills/目录下 - OpenClaw — 本文提到的 AI 开发工具之一，Skill 文件放置在
.openclaw/skills/目录下 - Vibe Coding — 本文隐含的开发范式，用自然语言驱动 AI 写代码，Skill 是让 Vibe Coding 更可控的关键机制
与其他素材的关联
- 与 2026-05-11-skill-sop-for-ai 的关系：冰冰酱从 ACT-R 认知理论定义 Skill 本质，本文从实战痛点出发给出具体模板——两篇形成”理论→实践”互补
- 与 2026-05-28-agents-md-coding-standard 的关系：本文将 AGENTS.md 纳入 SOUL/SKILL/AGENTS/MEMORY 四文件体系中讨论，而该素材专注 AGENTS.md 的工程细节（六章结构、95% 遵循率数据）
- 与 2026-05-27-woshipm-yunshu-skill-practical-guide 的关系：云舒讲”先跑通再封装”的 Skill 构建方法论，本文直接给出 6 个可复制的模板——互补关系
- 与 2026-06-02-woshipm-skill-creation-guide 的关系：流窜AI 讲 Skill 编写方法论（评估驱动开发、Context Rot），本文提供模板级实操——从”怎么写”到”写什么”
原文精彩摘录
用 AI 开发工具（OpenClaw / Cursor / Windsurf 等）一段时间后，你大概率会陷入这个循环：每次开新项目都要说一遍”我用 React + TypeScript + Tailwind”；每次写代码都要补一句”遵循 ESLint 规范，不要用 var”；每次做 Code Review 都要提醒”检查空值处理、错误边界、类型安全”；每次写文档都要说”用中文、用 Markdown、标题不超过三级”。你在用自然语言手动维护一套”规范系统”，每次对话都要重新加载一遍。
Skill 是一个 Markdown 文件（通常叫
SKILL.md），放在特定目录下，AI 工具会在合适的时机自动加载它。你可以把它理解为：给 AI 写的 SOP（标准作业流程）。人类世界的员工手册对应 AI 世界的 SOUL.md（身份认知），岗位 SOP 对应 SKILL.md（技能包），项目规范文档对应 AGENTS.md（项目规则），经验教训库对应 MEMORY.md（历史记忆）。
Skill 的加载是”按需”的，不是全部加载。全局 Skill 所有项目都会检查，适合放通用规范；项目级 Skill 只在当前项目生效，适合放项目特定规范。AI 会根据当前任务内容匹配相关 Skill——比如你在写 Java 代码就自动加载 java-spring Skill，不相关的 Skill 不会加载，节省 token。