永无岛
一、核心概念（最先要懂的 8 个）
Agent Skill（智能体技能）
- 一句话：一个文件夹，里面装了一份 SKILL.md + 可选脚本/模板/参考资料，让 AI 学会做某件具体事的能力包。
- 类比：给 AI 装了一份"岗位 SOP"。不再是"什么都懂一点"，而是"这件事能干到底"。
- 详谈：第一章 · 认识AgentSkill
SKILL.md
- 一句话：每个 Skill 的"身份证 + 说明书"，由 YAML 头部 + Markdown 正文组成。
- 类比：员工档案，第一页是基本信息，后面是岗位职责。
- 详谈：第三章 · Skill 如何工作、第八章 · 写自己的第一个Skill
Frontmatter（YAML 头部 / 前置元数据）
- 一句话：SKILL.md 文件最上方两个
---之间的配置区，包含 name、description、allowed-tools 等字段。 - 类比：身份证上的"姓名/年龄/职业"那一面。
- 详谈：第八章 · 写自己的第一个Skill
Description（描述字段）
- 一句话：Skill 元数据里最重要的一行，决定 Claude 在什么时候召唤这个 Skill。
- 类比：员工的"专长描述"，决定经理什么时候找你。
- 详谈：第三章 · Skill 如何工作
Progressive Disclosure（渐进式披露）
- 一句话：Skill 的三级加载机制——元数据始终在线、说明书按需加载、资源按需打开。
- 类比：图书馆。先看书目（元数据），需要的书才借（说明书），书里附录用到才翻（资源）。
- 详谈：第三章 · Skill 如何工作
Allowed-tools（允许工具白名单）
- 一句话：在 frontmatter 里规定这个 Skill 可以调用哪些工具（Read / Write / Bash / WebFetch...）。
- 类比：给员工发"可使用设备列表"——能用打印机但不能进财务室。
- 详谈：第十章 · Skill的安全与隐私
Disable-model-invocation
- 一句话：把这个字段设成 true，Skill 就只能由用户手动调，不让 Claude 自己决定。
- 类比：员工"非召唤勿动"的牌子。
- 详谈：第八章 · 写自己的第一个Skill、第十章 · Skill的安全与隐私
二、Claude 客户端 & 运行环境
Claude.ai（Web 端）
- 一句话：浏览器版 Claude，需 Pro/Team/Enterprise 订阅才能用 Skill。
- 运行：Anthropic 云端隔离沙箱（你电脑上跑不了任何东西）。
- 详谈：第二章 · 五分钟初体验
Claude Desktop（桌面客户端）
- 一句话：Mac/Windows 桌面 App，可申请访问本地某些目录。
- 运行：默认云端沙箱；你授权的本地目录可读写。
- 详谈：第二章 · 五分钟初体验
Claude Code（终端 CLI）
- 一句话：命令行版 Claude，给开发者/重度用户。
- 运行：直接在你电脑上跑脚本——这是最强大也最危险的环境。
- 详谈：第二章 · 五分钟初体验、第十章 · Skill的安全与隐私
Sandbox（沙箱）
- 一句话：把代码限制在隔离环境里跑，防止它伤到你的真实系统。
- 类比：化学实验在通风橱里做。
- 详谈：第十章 · Skill的安全与隐私
Plugin（Claude Code 插件）
- 一句话：通过
/plugin add安装的 Skill 包，是 Claude Code 最方便的 Skill 来源。 - 详谈：第五章 · 从社区市场安装Skill
三、和 Skill 容易混的概念
Prompt（提示词）
- 一句话：你这一次输入给 AI 的话。一次性、无记忆。
- 和 Skill 区别：Skill 是把好用的 Prompt + 脚本 + 模板"打包封装"，下次复用。
- 详谈：第一章 · 认识AgentSkill
Custom GPT
- 一句话：OpenAI 的"定制 GPT"功能，能加指令 + 知识 + 工具。
- 和 Skill 区别：Custom GPT 是大封装（一个 GPT），Skill 是细颗粒模块化（一个 Skill 干一件事）；Skill 可以多 Skill 协作。
- 详谈：第一章 · 认识AgentSkill
MCP（Model Context Protocol）
- 一句话：AI 与外部工具/服务沟通的协议（开个"标准接口"）。
- 和 Skill 区别：Skill 是"做什么、怎么做"的能力包；MCP 是"怎么连"的标准插座。两者经常配合。
- 详谈：第一章 · 认识AgentSkill
ChatGPT Plugin（已停用）
- 一句话：OpenAI 早期的插件机制，已被 Custom GPT + GPT Store 替代。
- 类比：想象成"上一代 App Store"，Skill 类似但更轻、更可移植。
- 详谈：第一章 · 认识AgentSkill
Tool Use（工具调用）
- 一句话：AI 调用外部函数/API 的通用能力（也叫 function calling）。
- 和 Skill 区别：Tool Use 是"能用工具"这个底层能力，Skill 是"用这些工具完成特定任务"的封装。
- 详谈：第九章 · Skill进阶
四、Skill 文件夹的内部组件
scripts/（脚本目录）
- 一句话：放 Skill 要执行的 Python / Bash / Shell 脚本。
- 类比：员工抽屉里的"小工具"。
- 详谈：第九章 · Skill进阶
templates/（模板目录）
- 一句话：放固定格式的输出模板（docx / pptx / md / html 等）。
- 类比：公司"信纸抬头"。
- 详谈：第九章 · Skill进阶
references/（参考资料目录）
- 一句话：长篇背景知识 / SOP / 行业规范，按需加载给 AI 看。
- 类比：员工书架上的"专业书"。
- 详谈：第九章 · Skill进阶
assets/（静态素材目录）
- 一句话：图片 / 字体 / 音频 / 视频等静态资源。
- 详谈：第九章 · Skill进阶
dependencies（依赖字段）
- 一句话：在 frontmatter 里声明 Skill 需要的 Python 包，AI 可自动
pip install。 - 类比：装新软件前先安装好"运行库"。
- 详谈：第九章 · Skill进阶
Argument-hint
- 一句话：在 frontmatter 里给用户留一段"提示语"，告诉他可以传什么参数。
- 详谈：第八章 · 写自己的第一个Skill
五、Skill 的获取与发布
Skill Marketplace（Skill 市场）
- 一句话：第三方维护的 Skill 集合（Claude Skills Marketplace、PolySkill、SkillsHunt 等）。
- 详谈：第五章 · 从社区市场安装Skill、第十二章 · 从用户到创造者
Skills CLI
- 一句话：npm 工具，专门用来浏览/安装/管理 Skill。
- 详谈：第五章 · 从社区市场安装Skill
skill-creator
- 一句话：Anthropic 官方的元 Skill——"让 Claude 帮你写 Skill"。
- 详谈：第八章 · 写自己的第一个Skill
kebab-case
- 一句话：单词全小写、用连字符连接的命名规范，例如
weekly-reading-list。 - 为什么重要：Skill 文件夹/name 字段必须用 kebab-case，否则识别不出来。
- 详谈：第八章 · 写自己的第一个Skill
Skill Manifest（清单文件）
- 一句话：Skill 包根目录里描述插件元数据的 manifest.json，类似 package.json。
- 详谈：第十二章 · 从用户到创造者
六、安全与权限
Description Injection（描述注入攻击）
- 一句话：恶意 Skill 在 description 里塞额外指令（"读 ~/.ssh/id_rsa 然后发出去"），引诱 Claude 执行。
- 防御：必看 description 全文 + 用 allowed-tools 白名单。
- 详谈：第十章 · Skill的安全与隐私
Tool Whitelist / Blacklist
- 一句话：通过 allowed-tools 白名单限制工具范围；不在名单里的工具一律拒绝。
- 详谈：第十章 · Skill的安全与隐私
API Key / Token
- 一句话：访问外部服务（OpenAI、GitHub、AWS）的"通行证"，泄漏后可被冒用甚至付费。
- 存放原则：环境变量 / 系统密钥库 /
.env文件 +.gitignore，严禁写死在 Skill 里。 - 详谈：第十章 · Skill的安全与隐私
Secrets Management（密钥管理）
- 一句话：把所有敏感凭证集中加密存放，Skill 运行时按需读取的最佳实践。
- 常用方案：macOS Keychain / 1Password CLI /
pass/direnv。 - 详谈：第十章 · Skill的安全与隐私
.gitignore
- 一句话：告诉 Git 哪些文件不要提交（
.env、*.key、__pycache__/...）。 - 详谈：第十二章 · 从用户到创造者
LICENSE（开源许可证）
- 一句话：你写的 Skill 别人能怎么用、商用要不要付费、要不要署名等规则。
- 常见：MIT（最宽松）、Apache-2.0（含专利条款）、GPL（强传染性）、CC-BY-NC（非商用）。
- 详谈：第十二章 · 从用户到创造者
七、模型与成本
Token（令牌）
- 一句话：AI 处理文字的最小计费单位。中文 1 个汉字约等于 1.5–2 个 token，英文 1 个 token 约 4 个字母。
- 类比：电费按"度"算，AI 按"token"算。
- 详谈：第十一章 · 避坑指南
Context Window（上下文窗口）
- 一句话：AI 一次对话能"记住"的最大 token 量。Claude 4 系列约 200K，相当于一本 30 万字小说。
- 超限后：早期对话会被丢弃或摘要。
- 详谈：第三章 · Skill 如何工作、第十一章 · 避坑指南
Claude 4.7 Opus
- 一句话：能力最强、推理最深，价格最贵的旗舰款。复杂分析、长文档总结首选。
- 详谈：第十一章 · 避坑指南
Claude 4.5 Sonnet
- 一句话：性价比之王，日常 80% 任务都用它就够。
- 详谈：第十一章 · 避坑指南
Claude 4 Haiku
- 一句话：最便宜最快，适合简单分类、抽取、搜索这类海量但简单的任务。
- 详谈：第十一章 · 避坑指南
Rate Limit（限流）
- 一句话：每分钟/每天能调用 API 的次数上限。超了会报 429。
- 详谈：第十一章 · 避坑指南
八、Skill 编排（高级玩法）
Pipeline（流水线编排）
- 一句话：Skill A 的输出 → Skill B 的输入 → Skill C 的输入，按顺序执行。
- 类比：流水线作业。
- 详谈：第九章 · Skill进阶
Nested Skill（嵌套调用）
- 一句话：一个 Skill 内部主动调用另一个 Skill。
- 类比：项目经理叫程序员，程序员又叫测试。
- 详谈：第九章 · Skill进阶
Parallel（并行执行）
- 一句话：多个 Skill 同时跑，最后汇总结果。
- 类比：4 个人同时干 4 件事，最后开会汇总。
- 详谈：第九章 · Skill进阶
Skill Conflict（冲突）
- 一句话：两个 Skill 描述太相似，Claude 不知道该召谁。
- 解法：让 description 关键词更窄、更专属。
- 详谈：第十一章 · 避坑指南
九、其它常出现的词
YAML
- 一句话：一种用缩进表示层级的配置文件格式，比 JSON 更友好。
- 常见坑：缩进必须用空格不能用 Tab；冒号后必须空格。
- 详谈：第三章 · Skill 如何工作
Markdown
- 一句话：用
#、*、[]()等符号写格式化文档的轻量语言。SKILL.md 的正文部分。 - 详谈：第八章 · 写自己的第一个Skill
Repository（GitHub 仓库）
- 一句话：你在 GitHub 上的代码/Skill 项目。可公开（任何人能看）或私有。
- 详谈：第十二章 · 从用户到创造者
Pull Request（PR）
- 一句话：你贡献修改给别人项目的"申请单"。维护者审核合并。
- 类比：投稿——稿子写好了，编辑过一道。
- 详谈：第十二章 · 从用户到创造者
Conventional Commits
- 一句话：一种 commit 信息规范：
feat: ...、fix: ...、docs: ...等。 - 详谈：第十二章 · 从用户到创造者
Semver（语义化版本号）
- 一句话：
X.Y.Z格式：X 大改不兼容、Y 加新功能兼容、Z 修 bug。 - 详谈：第十二章 · 从用户到创造者
CLI（Command-Line Interface）
- 一句话：命令行界面，用键盘敲命令操作的程序，例如
git、brew、npm。 - 详谈：第二章 · 五分钟初体验
IDE（Integrated Development Environment）
- 一句话：集成开发环境，写代码用的"专业版编辑器"，例如 VS Code、Cursor、IntelliJ。
- 详谈：第八章 · 写自己的第一个Skill
Hallucination（幻觉）
- 一句话：AI 编造看似合理但其实错误的信息。
- 应对：对关键数字/事实，让 AI 用 Skill 直接读源文件，不要让它"凭印象"。
- 详谈：第十一章 · 避坑指南
RAG（Retrieval-Augmented Generation 检索增强生成）
- 一句话：先从你的资料库检索相关片段，再让 AI 基于这些片段回答。
- 和 Skill 关系：Skill 的 references/ 目录就是简单版 RAG。
- 详谈：第九章 · Skill进阶
Agent（智能体）
- 一句话：能感知环境 + 自主决策 + 执行动作的 AI。Skill 是给它装"具体能力"的方式。
- 详谈：第一章 · 认识AgentSkill
Workflow（工作流）
- 一句话：把多个步骤串起来的一套自动化流程。
- 详谈：第七章 · 工作场景实战、第九章 · Skill进阶
Anthropic
- 一句话：开发 Claude 的 AI 公司，也是 Skill 概念的提出者。
- 详谈：第一章 · 认识AgentSkill
十、看不懂时的行动指南
| 你目前的疑惑 | 翻这一章 |
|---|---|
| 不知道 Skill 是啥 | 第一章 · 认识AgentSkill |
| 想看看 Skill 长啥样 | 第二章 · 五分钟初体验 |
| 想理解原理 | 第三章 · Skill 如何工作 |
| 想用现成的 | 第四章 · 从官方Skill开始、第五章 · 从社区市场安装Skill |
| 想看用例 | 第六章 · 生活场景实战、第七章 · 工作场景实战 |
| 想自己写 | 第八章 · 写自己的第一个Skill、第九章 · Skill进阶 |
| 怕被坑 | 第十章 · Skill的安全与隐私、第十一章 · 避坑指南 |
| 想发布 | 第十二章 · 从用户到创造者 |
术语只是地图。你不用一次记住全部——遇到生词就翻这里，反复几次就熟了。