← → 翻页 · B 静态 · ESC 索引
Skills · Field Guide
REV.31 · 01 / 20
FROM COGNITION TO PRACTICE

Skills
完全指南

为什么 Skill 是 Agent 时代的能力商品,以及如何安装、设计、维护和创建自己的 Skill。
SOURCE · FEISHU WIKI
→ ARROW / SWIPE
01 · CORE INSIGHT
02 / 20
THE UNCOMFORTABLE TRUTH

Agent 不会抹平差距。
它会放大你已有的一切。

目标清晰、上下文完整、判断力强的人被放大;目标混乱、没有资料和标准的人,也会被放大混乱。

01 · AGENT DIVIDE
03 / 20
K-SHAPED DIFFERENCE

头部用户在搭系统,
普通用户还在问聊天框。

01 HEAD USERS
Build
Systems

理解文档、规则、Memory、Loop、MCP、CLI、权限、安全沙箱与上下文工程。

  • 先组织目标与资料
  • 给 Agent 明确边界
  • 把成功流程沉淀下来
02 CASUAL USERS
Ask
Chatboxes

只知道“Agent 能写代码”,却不知道能力上限来自目标、资料、流程和判断标准。

  • 一次性提出模糊要求
  • 依赖模型临场猜测
  • 结果无法稳定复用
02 · DEFINITION
04 / 20
ONE-LINE DEFINITION

Skill 是
能力商品

REUSABLE · DISTRIBUTABLE · ITERABLE
WHAT IT PACKAGES
NOT AN APP

把专家经验、工作流、品味和工具调用封装成可分发、可复用、可迭代的 Agent 能力单元。

USER SEES

解决什么问题
产出什么结果
怎么使用

SKILL HIDES

MCP / CLI / Workflow
Memory / Loop
模型与上下文工程

THE USER BUYS AN OUTCOME, NOT THE PLUMBING.
02 · FORM FACTOR
05 / 20
PROMPT VS SKILL

一次性指令,
还是可复用的能力包?

01 PROMPT
One-off
Instruction

一次对话里临时提出要求,依赖当下上下文和模型临场发挥。

  • 容易复制,也容易丢失
  • 没有版本与结构
  • 适合简单对话任务
02 SKILL
Capability
Package

提示词、规则、示例、脚本、依赖和资产组成可安装、可维护的目录。

  • 有版本和质量边界
  • 可以跨任务稳定复用
  • 适合复杂工作流
03 · EXTERNALIZE EXPERTISE
06 / 20
A GOOD SKILL NEEDS THREE KINDS OF JUDGMENT
EXPERTISE

把人的
经验
外化

模型不会自动拥有你的行业判断。必须把“什么算好”写成可执行约束。

01
PROFESSIONAL KNOWLEDGE

专业知识

知道行业里哪些结果真正有效,哪些只是看起来像。

02
AI BOUNDARIES

AI 上下限

知道模型哪里稳定,哪里需要脚本、校验和工程兜底。

03
PRODUCT THINKING

产品化思维

理解用户场景、使用门槛、反馈路径与稳定性要求。

03 · CASE STUDY
07 / 20
PPT SKILL · A WORKFLOW, NOT A PROMPT

一份稳定的 PPT,
来自六次判断。

人的演示经验,被固化成每次都会执行的后验检查。
04 · INFORMATION ARCHITECTURE
08 / 20
CENTER SHORT · RADIATION THICK

好 Skill 是一个目录,
不是一份超长说明。

— 01 / ENTRY

SKILL.md

只放高信号流程、判断和加载条件。

— 02 / KNOWLEDGE

references/

重文档与领域材料,按需要渐进读取。

— 03 / LOGIC

scripts/

确定性逻辑交给代码,不让模型重复发明。

— 04 / MATERIAL

assets/

模板、主题、示例、字体与版式骨架。

05 · ARCHITECTURE
09 / 20
THIN HARNESS

编排层
保持

只负责模型循环、上下文管理、安全边界和工具调度。

FAT SKILLS
COMPOUNDING
CAPABILITY LAYER

能力层
不断变厚

承载流程、判断、领域知识、模板、gotchas 与可复用资产。

06 · QUALITY AS CODE
10 / 20
A SKILL IS NEVER FINISHED

质量来自真实失败,
不是第一次写得很长。

01
真实任务试错

先观察 Agent 会在哪里出错。

02
写 Eval

覆盖正例、反例与禁止加载。

03
追加 Gotchas

把失败边界写成“别这么做”。

04
跨模型测试

检查触发、执行与输出差异。

ITERATE
TASK
EVAL
GOTCHAS
TEST
07 · TASTE AS CONSTRAINT
11 / 20
REMOVE THE UGLY OPTIONS

设计 Skill 的价值,
是替用户排除平庸。

01 · COLOR

拒绝纯白纯黑

使用经过校色的纸白与近黑。

02 · PALETTE

只给验证过的主题

不把任意 Hex 选择留给临场猜测。

03 · FOCUS

一个锚点色

避免彩虹渐变、发光与无意义 Blur。

04 · MOTION

动画只服务语义

优先 Transform 与 Opacity。

05 · IMAGE

真实素材优先

摄影和截图是证据,AI 图只是兜底。

06 · LAYOUT

先验证骨架

AI 负责填充、组合与微调。

08 · PRODUCT LAYER
12 / 20
USERS DO NOT BUY TERMINOLOGY
用户不关心概念,
用户关心结果

Skill、MCP、CLI、Plugin 在底层可以不同;产品层应该弱化术语,回答五件事:解决什么、适合谁、怎么用、结果长什么样、失败时怎么办。

PRODUCT PRINCIPLE
展示能力,
不要展示管道。
09 · ECOSYSTEM
13 / 20
NOT A REPOSITORY LIST

每个 Skill,
都应该像一个功能页。

01
解决什么

用结果语言描述,而不是仓库名。

02
适合谁

明确场景、受众与使用门槛。

03
输出长什么样

展示真实结果和使用案例。

04
别人怎么评价

提供评价指标和可信反馈。

05
常见失败

主动暴露边界和 gotchas。

06
如何安装

让用户一句话就能开始。

10 · INDUSTRY FLYWHEEL
14 / 20
REAL WORK COMPOUNDS

真实任务,
会长成行业 Skill。

01
完成真实任务

从一线需求中看见隐性判断。

02
沉淀成 Skill

把流程、模板和边界打包。

03
产出变内容

案例文章带来用户与反馈。

04
反馈升级版本

补充 gotchas、模板与新场景。

COMPOUND
WORK
SKILL
CONTENT
FEEDBACK
11 · QUICK START
15 / 20
YOUR FIRST SKILL

从一句需求,
到一次可验证的交付。

npx skills add vercel-labs/skills@find-skills -g -yFIND → INSTALL → USE
12 · INSTALLATION SCOPE
16 / 20
TWO TYPES OF SKILLS

通用能力放全局,
项目规范留在项目里。

01 GLOBAL
All
Projects

适合 PPT、视频、代码审查、性能优化等跨项目能力。

  • 位置:~/.agents/skills/
  • 安装:命令增加 -g
  • 所有工作区均可发现
02 PROJECT
One
Context

适合代码风格、架构约定、业务知识和项目内安全边界。

  • 位置:项目/.agents/skills/
  • 安装:在项目目录执行
  • 只对当前项目生效
13 · SKILL.MD ANATOMY
17 / 20
THE ENTRY FILE

一份 SKILL.md,
应该回答八个问题。

01
Name

能力标识是什么?

02
Description

什么时候应该加载?

03
Goal

解决什么,不解决什么?

04
Workflow

执行顺序是什么?

05
Rules

哪些判断必须遵守?

06
Output

怎样才算交付完成?

07
Gotchas

哪些错误不能再犯?

08
References

细节去哪里按需读取?

THE PACKAGE
一个目录,不是一条提示词。
CENTER SHORT · RADIATION THICK
14 · CAPABILITY FORMS
18 / 20
CHOOSE BY RESPONSIBILITY

不同形态,
解决不同层的问题。

— 01 / WORKFLOW

Skill

封装有判断的垂直工作流:写作、设计、分析、SOP。

— 02 / CONNECTION

MCP

连接外部服务和上下文:地图、数据库、浏览器、API。

— 03 / TOOLING

CLI

提供确定、通用、跨 Agent 平台的工具执行层。

— 04 / EVENT

Hooks

在文件变更、命令执行等事件前后自动触发。

15 · INTERNAL MECHANISM
19 / 20
PROGRESSIVE DISCLOSURE

三层渐进加载,
让上下文只在需要时变厚。

L1 · SESSION INDEX
注册索引
会话初始化只加载 name 与 description,用低成本完成能力路由。
ALWAYS PRESENT
L2 · ON DEMAND
完整 SKILL.md
当任务与描述匹配时,才把完整流程和规则注入上下文。
TASK MATCHED
L3 · REFERENCES
引用与资产
执行中遇到具体分支,再加载 references、scripts 与 assets。
CONDITIONALLY READ
AI 不需要记住一切,只需要知道去哪里找专业知识。
20 / 20
CLOSING
MANIFESTO

重复两次,
就把它变成
Skill

Agent 时代最稀缺的,是可复用的能力组织方式。

SKILLS COMPLETE GUIDE
END
TAKEAWAYS
03 RULES
01

Skill 是能力商品

用户要的是稳定结果,不是理解全部技术管道。

02

经验必须外化

把流程、品味、边界和失败经验写进系统。

03

质量来自迭代

用真实任务、Eval 与 Gotchas 让 Skill 持续复利。

→ END OF FIELD GUIDE