别再让 AI 裸奔了!用 Skills 让 AI 秒变专属员工
以 Claude Code 为平台,把重复 Prompt 固化为
SKILL.md技能包:讲清存放优先级、frontmatter 触发字段、会议纪要与 AI 日报两案例,以及动态注入、参数、fork 子代理、Token 预算与 MCP/Memory/Skills 协同。
基本信息
- 来源类型:文章(掘金)
- 原文位置:
raw/articles/2026-07-19-184539-tg-64aaa9.md(Telegram stub msg 2100 → baoyu 抓取补全文) - 原文 URL:https://juejin.cn/post/7663426727990706239
- 作者:ReBound
- 发布时间:2026-07-18
- extract:
raw/extracts/20260719-191205/juejin.cn/ai-skills-ai.md(Converter: defuddle) - 消化日期:2026-07-19
核心观点
- AI 使用三阶段,第三阶段才是「专属员工」:第一阶段把 AI 当搜索;第二阶段反复写复杂 Prompt「驯服」AI;第三阶段把「我是谁 / 擅长什么 / 怎么做」蒸馏进
SKILL.md,一次封装、可复用、可组合。作者痛点:代码审查、会议纪要、日报每天重复写 3 遍同类 Prompt,换项目就丢、团队无法共享。 - Skill 是带元数据的模块化指令集,不是聊天记录里的 Prompt:物理形态是文件夹 + 必填入口
SKILL.md(YAML frontmatter + Markdown 指令),可选templates/、scripts/、evals/。存放优先级:企业 managed settings >~/.claude/skills/个人 > 项目.claude/skills/> 子目录嵌套 > 插件命名空间;同名企业优先。Monorepo 可用/apps/web:deploy点选嵌套版。 description是自动触发的唯一开关:好 description 要写清「生成什么 + 用户会怎么说的关键词 + 适用场景」;差 description(如「会议工具」)导致从不自动触发。作者实测:从「会议工具」改成「生成结构化会议纪要」后,触发率约 0 → 90%。有副作用的 Skill(部署/数据迁移)必须disable-model-invocation: true,否则讨论方案时会被误触发。- 两个完整实战模板:① 会议纪要:通读→滤噪音→按议题结构化→行动项表→「不确定就留空」;真实团建转写约 6 分钟录音可抽出经费申请/场地调研行动项。② AI 日报:WebFetch 多源 → 过滤 → 50–100 字中文摘要 →
python ${CLAUDE_SKILL_DIR}/scripts/generate_html.py出 HTML。 - Claude Code 高级能力与 Token 纪律:
!`command`在进模型前注入git diff等实时上下文;$ARGUMENTS/$0参数化;context: fork+agent: Explore子代理隔离;多 Skill 乐高组合(/code-review /fix-issue 123)。Skill 渲染后常驻对话;压缩时每 Skill 约保留前 5000 tokens,多 Skill 共享约 25000 tokens 预算——正文要精简、大参考外置支持文件。评估可用官方 skill-creator 写evals/evals.json做有/无 Skill 与版本 A/B。 - MCP · Memory · Skills 三角:MCP = 接外部工具/数据的「USB」;Memory = 跨会话长期偏好;Skills = 可复用专业技能包。完整工作流:Memory 给上下文 → Skills 给方法论 → MCP 给工具能力。
实操内容保留
代码/配置
目录结构(原文):
.claude/skills/
└── meeting-minutes/
├── SKILL.md # 入口(必须)
├── README.md
├── templates/
│ └── template.html
├── scripts/
│ └── generate.py
└── evals/
└── evals.json存放优先级:企业 > ~/.claude/skills/ > 项目/.claude/skills/ > 子目录/.claude/skills/ > 插件
Frontmatter 核心字段(摘录):
---
name: meeting-minutes
description: 生成结构化会议纪要。当用户提供会议录音文本、讨论记录时使用。
disable-model-invocation: false
user-invocable: true
context: inline # 或 fork
allowed-tools:
- "Bash(git *)"
- "WebFetch"
disallowed-tools:
- "Bash(rm *)"
arguments:
- name: format
description: 输出格式(detailed 或 brief)
required: false
---动态上下文注入(Claude Code):
## 当前代码变更
以下是未提交的 git diff:
!`git diff HEAD`
请分析这些变更的风险点。参数化 Skill:
修复 GitHub Issue #$ARGUMENTS,遵循我们的编码规范。用法:/fix-issue 123
有副作用 Skill 闸门:
---
name: deploy
description: 部署应用到生产环境
disable-model-invocation: true
allowed-tools:
- "Bash(kubectl *)"
- "Bash(docker *)"
---子代理隔离:
---
name: research
description: 深度研究某个技术主题
context: fork
agent: Explore
---支持文件组织(${CLAUDE_SKILL_DIR}):
1. **安全性** - 参考 ${CLAUDE_SKILL_DIR}/rules/security.md
2. **性能** - 参考 ${CLAUDE_SKILL_DIR}/rules/performance.md
3. **可维护性** - 参考 ${CLAUDE_SKILL_DIR}/rules/maintainability.md
输出格式参考:${CLAUDE_SKILL_DIR}/templates/report.mdPrompt 模板
会议纪要 Skill 输出结构(原文固化):
- 会议基本信息(时间 / 参会 / 时长)
- 会议目标(目的 / 背景)
- 会议内容(按议题:讨论内容、主要观点、结论)
- 行动项表(序号 / 任务 / 负责人 / 截止 / 备注)
- 待确认事项
准则:准确性优先;不确定留空;保留原意;按主题非时间序;行动项要具体到谁/做什么/何时。
好 description vs 差 description:
- 好:
生成结构化会议纪要。当用户提供会议录音文本、讨论记录时使用。适用于项目会议、团队讨论、客户电话、规划评审等场景。 - 差:
会议相关/会议工具
AI 日报工作流要点:TechCrunch / The Verge / Hacker News → 抓取 → 热度过滤 → 50–100 字中文摘要 + 标签 → HTML 脚本渲染。
操作步骤
- 在合适作用域创建
meeting-minutes/(或个人/企业级目录),写入SKILL.mdfrontmatter + 正文指令。 - 需要脚本/模板时放到
scripts/、templates/,正文用${CLAUDE_SKILL_DIR}引用。 - 用户侧:
/meeting-minutes或自然语言触发(依赖 description 关键词);粘贴转写或挂文件。 - 有副作用操作加
disable-model-invocation: true;独立重研究用context: fork。 - 用真实 prompt 做有/无 Skill 对比;可用 skill-creator 写
evals/自动化评分与版本 A/B。 - Token:删冗余解释、参考外置、description ≤200 字、不常用 Skill 改手动触发。
设计模式速查(原文)
| 模式 | 要点 |
|---|---|
| 单一职责 | 一个 Skill 一件事;description 出现「A 或 B 或 C」就该拆 |
| 参考 vs 任务 | 参考内容 user-invocable: false;任务内容常 disable-model-invocation: true + 可 fork |
| 乐高组合 | 同时 /skill-a /skill-b args,Claude Code 可多 Skill 同载 |
Token 生命周期(Claude Code 2026-07 文档口径,以官方为准)
用户调用 → 渲染变量/命令 → 作为消息进上下文 → 后续轮次持续存在 → 压缩时每 Skill 约前 5000 tokens → 多 Skill 共享约 25000 tokens 预算(近用优先)。
关键概念
- Skill — 模块化可复用指令集;本文给工程字段、优先级与 Token 纪律
- Claude Code — 主示例平台;动态注入、fork、
${CLAUDE_SKILL_DIR}等为平台特有 - skill-creator — 官方元技能 / 插件:生成与 evals 评估、A/B
- MCP 模型上下文协议 — 与 Skills/Memory 并列的「USB 接口」层
- Claude Memory — 跨会话偏好与项目背景;与 Skills 协同
- 提示词工程 — 三阶段中的第二阶段;本文主张向 Skill 固化跃迁
- AI Agent 智能体 — Explore 子代理、fork 隔离执行
- 动态上下文注入(
!`command`)— Claude Code 特有;进模型前注入命令输出 - Skill Token 预算 — 压缩保留与多 Skill 共享上限
与其他素材的关联
- 与 2026-07-19-juejin-claude-meeting-minutes-skill:同日掘金、同会议纪要场景;To_OC 侧重 skill-creator 安装路径与封装闸门;本文(ReBound)是系统手册:frontmatter 全字段、存放优先级、日报案例、高级技巧、Token/评估与 MCP·Memory·Skills 三角。会议纪要输出结构高度同构(四板块 + 不确定留空 + 团建转写示例)。
- 与 2026-07-11-woshipm-5min-data-dashboard-skill:都强调 skill-creator;看板篇是 ZIP 上传稳样式,本文是 Claude 本地目录 + 自写/生成
SKILL.md+ evals。 - 与 2026-07-18-bnext-ai-agent-reverse-workflow:都区分 Tools/Skill/何时固化;Wesley 用 ROI 闸门,本文用「重复 Prompt / 团队复用 / 副作用手动触发」工程闸门。
- 与 2026-06-17-ai-skill-workflow-封装:同属「给人的 SOP → 给 AI 的 Skill」;本文补 Claude Code 特有运行时(注入、fork、预算)。
- 与 2026-07-19-woshipm-agent-memory-design:Memory 产品四问与本文「Memory 提供上下文、Skills 提供方法论」互补。
- 与 2026-07-19-woshipm-ai-output-failure-diagnosis:「不确定留空」与 description/指令具体化,对应过程层规则与防编造。
原文精彩摘录
Skills 就是你把「我是谁、我擅长什么、我怎么做」这些信息,从临时的对话 Prompt 变成了永久的、可复用的、可组合的技能模块。
description 要包含用户会怎么说的关键词。我一开始写
description: 会议工具,结果 AI 从来不自动触发……改成「生成结构化会议纪要」之后,触发率直接从 0 到 90%。
我曾经把一个数据迁移的 Skill 没加
disable-model-invocation: true,结果 AI 在我讨论数据库方案的时候自动触发了它。
一个完整的 AI 工作流:Memory 提供上下文 → Skills 提供方法论 → MCP 提供工具能力。
2026 年,用 AI 的人分成了两批:一批每次打开对话框都在解释「我是谁」;另一批打开就能干活——有 Skills、有 Memory、有 MCP。