软件技术分享

关于电子游戏的方方面面

Claude：自定义技能／可复用流程入门

作者

想把同一套流程反复用稳：用 Skills 打包步骤，Projects 放常驻背景；别把一次性闲聊塞进技能。

要点

  • 官方叫法是 Skills（技能）：一个文件夹，核心是必填的 SKILL.md（YAML 里写 name／description＋正文步骤）；可选 references/、assets/、scripts/。证据：高（Create custom skills）。
  • Claude 不会一开始通读全部技能：先看名称与 description，任务对上再加载 SKILL.md，需要时再打开附属文件。description 写清“做什么＋何时用”。证据：高（Skills overview）。
  • 落点分三路（白话对照）：claude.ai／桌面 → Customize > Skills 上传 ZIP；Claude Code → ~/.claude/skills/（个人）或项目 .claude/skills/；API／工作区 → Skills API 上传后挂到 agent。证据：高（Help Center＋Claude Code Docs＋Platform overview）。
  • Skills vs Projects：Skills＝按任务匹配才加载的可复用流程；Projects＝该项目聊天里常驻的背景知识与项目说明（Set project instructions）。“每条对话都要遵守”的规矩优先放偏好／项目说明，不要硬塞进 Skill。证据：高。
  • 前置：Code execution／创建 and edit files（界面文案以你账号为准）需开启，Skills 跑在代码沙箱里。套餐：文档概览写 Pro／Max／Ultra／Team／Enterprise；Help Center 另写含 Free——套餐覆盖以你界面为准，待核。
  • 打包坑：ZIP 顶层必须是 技能名/SKILL.md，目录名与 frontmatter name 一致；name 仅小写字母／数字／连字符，≤64；description ≤1024。证据：高。
  • 证据强度总表：结构与三阶段加载＝高；菜单路径 Customize > Skills＝高（Help）；Free 是否完整可用 Skills＝待核；个别按钮文案随 UI 改版＝以你界面为准。

正文

场景

你每周都要：按固定提纲改更新说明、对照品牌色出一页演示、或按团队模板开 Issue。于是你把同一段长提示复制来复制去——漏一步、换对话就丢。官方给的解法叫 Skills：把“可复用流程”收成文件夹，Claude 在任务对得上时自动加载；需要常驻背景（素材库、项目口径）再用 Projects。两者不是同一个开关。

可跟做步骤／可抄工作流

证据强度：高（claude.com Skills 文档＋Help Center＋Claude Code Docs）；套餐与个别按钮文案标待核／以你界面为准。

  1. 先判断：Skill，还是 Project／偏好？

– 同一任务反复做、要同一套步骤／清单／模板 → Skill。

– 该项目所有聊天都要同一背景与行为 → Project instructions＋知识库。

– 真正“每一条对话都要” → 个人偏好／项目说明，不要塞进 Skill（官方明确：Skill 只在任务匹配时加载）。

– 要拉外部实时数据 → MCP／连接器；Skill 可以教“怎么用连接器”，本身不代替连接。

  1. 最小可跑：只写一个 SKILL.md
my-patch-notes/
└── SKILL.md
---
name: my-patch-notes
description: 把补丁说明改成玩家可读更新说明。在用户提到更新说明、补丁、版本公告或 patch notes 时使用。
---

# 更新说明流程

1. 只依据用户粘贴的原文；缺版本号就写“原文未写”。
2. 先给 ≤80 字结论，再列 3–5 条改动要点。
3. 禁止编造外链、日期与“玩家评分”。
4. 输出用中文弯引号，专名首次白话解释。

– description 要同时写清做什么和何时触发（这是加载前 Claude 唯一看到的决策信息）。

– 目录名必须等于 name。

  1. 需要模板／长参考时再加文件夹（官方示例树）
brand-guidelines/
├── SKILL.md
├── references/voice-and-tone.md
├── assets/slide-template.md
└── scripts/check_contrast.py

– 长背景放 references/，模板放 assets/，可靠代码放 scripts/；在 SKILL.md 对应步骤里点名路径，Claude 才会按需打开。

– 主文件建议控制体量（文档建议 SKILL.md 主文不宜过长，细节外置）。

  1. 装到 claude.ai／桌面

1) 确认 Settings 里 Code execution／文件创建编辑已开（Team／Enterprise 可能要 Owner 在组织能力里开）。

2) 在含技能文件夹的上一级执行打包，保证 ZIP 内是 my-skill/SKILL.md：zip -r my-skill.zip my-skill/。

3) 打开 Customize > Skills → “+” → Create／Upload a skill → 上传 ZIP → 打开开关。

4) 用会触发 description 的自然语言试一次；也可在输入框打 / 手动点选技能（以你界面为准）。

5) 不触发就改 description，写进用户会说的词。

  1. 装到 Claude Code（终端）

– 个人全局：~/.claude/skills//SKILL.md

– 仓库共享：项目内 .claude/skills//SKILL.md（可提交 Git）

– 用自然语言触发，或 /技能名 直接调用。

– 已登录同一 Claude 账号时，账号里启用的技能可同步进 Claude Code（文档写明版本与 syncClaudeAiSkills 等开关——以你本机文档／设置为准，待核细节）。

  1. Projects 侧“常驻可复用”怎么叠

– 建 Project → Set project instructions 写口径、格式、禁编造。

– 右侧知识库上传反复用的素材；聊天之间默认不共享上下文，除非进了知识库。

– 流程步骤仍用 Skill；项目背景用 Project——官方对照表就是这个分法。

  1. 30 秒自检

– description 能否让陌生人判断“何时该用”？

– ZIP／目录是否顶层带文件夹？

– 是否把“每次聊天都要”的规矩误塞进 Skill？

– scripts／依赖是否来自可信来源？（Help：只装可信技能，防提示注入与数据外泄风险）

真实用户诀窍／反例

  • 诀窍：一个 Skill 一件事。 官方建议多个聚焦技能可组合，优于一个万能大包。
  • 诀窍：先说明文，脚本后置。 能用步骤说清就别先塞代码；脚本路径可用 ${CLAUDE_SKILL_DIR}（Claude Code／Cowork 场景）。
  • 诀窍：用真实请求测触发。 上传后专门试“会触发／不该触发”两类句子，只改 description 往往比改正文更管用。
  • 反例：把整本员工手册塞进单个 SKILL.md。 每次加载都吃上下文；应拆 references 并按步骤引用。
  • 反例：ZIP 直接压了散落的 SKILL.md。 官方：根上裸文件不被识别。
  • 反例：技能里写死 API Key。 分享＝密钥扩散；外连用连接器、各自登录。
  • 反例：用 Skill 代替事实来源。 流程可复用，数字与引语仍要核（见本室《幻觉校验清单》）。

适用边界

  • 本稿覆盖：claude.ai／桌面自定义 Skills 入门、与 Projects 分工、Claude Code 目录落点；不展开 API 计费数字或企业审核工单细节。
  • Free 是否与付费档同等可用 Skills：Help 与 overview 表述不完全一致 → 待核／以你界面为准。
  • UI 文案（Capabilities 新旧名、Create skill 按钮）可能改版 → 以当前界面为准。
  • 他人分享／第三方技能：启用前读 SKILL.md 与脚本；组织扫描与分享策略因计划而异。
  • Skill 不能消灭幻觉，也不能替代你对对外稿的人工终核。

【来源与编译】

  • Skills overview｜Claude.ai Documentation｜三阶段加载；与 Projects／Plugins／MCP 对照；Capabilities 前置
  • Create custom skills｜Claude.ai Documentation｜目录结构、SKILL.md 字段、ZIP 打包、测试与最佳实践
  • Use skills in Claude｜Claude Help Center｜Customize > Skills、上传、套餐与 Code execution、安全提示
  • Agent Skills overview｜Claude Platform Docs｜预置文档技能、API／Claude Code 路径摘要
  • Extend Claude with skills｜Claude Code Docs｜~/.claude/skills/ 与项目 .claude/skills/、/skill-name
  • How can I create and manage projects?｜Claude Help Center｜Set project instructions、知识库、Free 最多五个项目
  • Understanding Claude’s personalization features｜Claude Help Center｜项目说明适用场景
  • 本文说明：编译“何时用 Skill／如何最小搭建／三端落点／与 Projects 分工”；未捏造额度数字；Free 覆盖与部分同步开关标待核。