技术文档

技能包遵循 Agent Skills 开放标准——本质上是一个装着说明文件的普通文件夹。这一页讲清它在哪些 AI 上能跑、怎么装、怎么换成你自己单位的模板。

什么是 Agent Skills

一个技能就是一个文件夹，结构长这样：

技能文件夹/ ├── SKILL.md 必需。说明「这个技能做什么、什么时候用」 ├── scripts/ 可选。确定性的脚本，AI 调用后只拿结果 ├── templates/ 可选。Word / Excel 模板 └── references/ 可选。长文档，用到才读

AI 启动时只读 SKILL.md 开头的名称和描述（约一百个字），几乎不占用上下文。只有当你的话跟描述对上了，它才会去读正文；正文里提到脚本时才去执行。这套「按需加载」的机制，让你可以同时装很多技能而不拖慢它。

标准是开放的。该规范于 2025 年底发布，此后主流 AI 编程助手陆续原生支持，同一个技能包不用改就能换平台——这也是本站技能能承诺「不挑平台」的底气。

支持哪些 AI

按能力分三类。选平台的唯一标准：这个技能要不要碰文件。

一类 · 原生读取 SKILL.md，放进技能目录即可

平台	装在哪	跑脚本	读本地台账	说明
Claude Code推荐	~/.claude/skills/	完整	✓	网络和依赖不受限，本站全部技能的首选环境
OpenAI Codex CLI	技能目录	完整	✓	标准发布后数周内跟进支持
Cursor2.4 及以上	技能目录	完整	✓	直接解析 SKILL.md
Gemini CLI Google Antigravity	技能目录	完整	✓	2026 年 1 月起正式集成该标准
Cline / OpenCode GitHub Copilot	技能目录	完整	✓	Cline 需开启实验开关

二类 · 支持技能，但运行环境受限

平台	装在哪	跑脚本	读本地台账	说明
Claude 网页版	设置 → 功能，上传 zip	沙箱内	需手动上传	需 Pro 及以上并开启代码执行；技能不跨端同步，要单独上传
Claude API	Skills API 上传	沙箱内	需随请求传入	沙箱无网络、不能装依赖包，只能用预装库

三类 · 没有技能机制，只能降级使用

平台	怎么用	跑脚本	读本地台账	说明
Kimi · 豆包 DeepSeek 网页版 ChatGPT 网页版	把 SKILL.md 正文当提示词粘贴，或做成智能体的知识库	否	否	没有文件系统，模板套不上、Word/Excel 出不来。只能生成文字内容，再自己贴进模板

本站技能要读你的台账、套你的模板、输出 Word 和 Excel，所以必须跑在有文件系统的一类平台上。纯聊天产品能帮你写出纪要正文，但没法把它填进你单位的公文模板里——这是能力缺失，不是适配没做好。

怎么安装

三步，不用懂代码。以 Claude Code 为例，其他一类平台步骤相同，只是技能目录位置不一样。

STEP 01

下载并解压

点技能页面的下载按钮，拿到一个 zip。解压出来是一个文件夹。

sp-01-meeting-minutes/ ├── SKILL.md ├── scripts/ └── templates/

STEP 02

放进技能目录

把整个文件夹复制过去。目录不存在就自己建一个。

Windows C:\Users\你的用户名\.claude\skills\ macOS / Linux ~/.claude/skills/

文件夹名不能改，也不能再套一层。

STEP 03

重启后直接说话

完全退出再打开。然后像跟同事交代活儿一样说一句：

帮我生成 7 月的周例会纪要

第一次用会问几个基础信息，答一次就存下来。

还要装 Python 依赖

技能里的脚本需要几个库来读写 Word 和 Excel。装一次，全部技能通用：

pip install python-docx python-pptx openpyxl

如果提示找不到 pip，说明还没装 Python。到 python.org 下载安装，安装时务必勾选 Add Python to PATH。

换成你自己单位的模板

这是最实用的一节。每个技能都是「模板 + 脚本」两层，脚本负责逻辑，模板负责长相—— 你把自己单位的模板放进去，产出就是你们的格式。

技能按两级顺序找模板，命中即停：

1. 技能文件夹/templates/ ← 你放的，优先 2. 通用模板库/ ← 兜底

把模板复制到技能的 templates/ 目录，文件基名保持一致，版本号往上加一位
需要自动填的位置写成双大括号：{{会议日期}}、{{纪要编号}}
字段名用中文，见名知意即可，具体清单在每个技能的说明文件里
签字栏保持空白，不要放占位符

只认双大括号。单大括号写法（如 {填这里}）脚本不认，会被当成普通文字原样留在成品里。技能在填之前会先体检模板，发现没有占位符或有单大括号，会直接拒绝生成—— 宁可报错，也不交给你一份打开才发现是空的表。

SKILL.md 规范速查

自己写技能时的硬性约束：

项	要求
name	最长 64 字符；只能小写字母、数字、连字符；不得包含 claude 或 anthropic；必须与文件夹名一致
description	非空，最长 1024 字符。必须同时说清「做什么」和「什么时候用」——这是 AI 判断要不要触发的唯一依据
正文	建议控制在 5000 个 token 以内，更长的内容拆到 references/ 里按需加载
脚本	放 scripts/，AI 执行后只有输出进入上下文，代码本身不占

描述写「主动」一点。AI 目前倾向于少触发技能。与其写「生成会议纪要」，不如写「当用户提到写／生成／起草周例会纪要、安全例会纪要、例会记录时，务必使用本技能，即使用户没说技能两个字」。

装不上？先查这四条

路径多了一层——正确的是「技能目录 / 技能文件夹 / SKILL.md」，解压时容易多套一层同名文件夹
文件夹名被改过——必须和 SKILL.md 里的 name 一字不差，中文名、空格、大写字母都会导致扫描不到
没有完全退出——关窗口不算，要确认进程全部结束再重新打开
依赖没装——技能能触发但脚本报错，多半是缺 python-docx 之类的库

常见问题

技能包是什么？

就是一个普通文件夹，里面有一个 SKILL.md 说明文件，可能还有脚本和模板。放进 AI 助手的技能目录，它就会在需要时自己读取。不是插件，不需要安装程序。

我用豆包 / Kimi / DeepSeek，能用吗？

只能降级用。这些是聊天产品，没有文件系统和代码执行，套不了你的 Word 模板，也读不了本地台账。可以把技能说明当提示词用，让它帮你写正文，但填进模板这一步得自己做。

会不会把我的台账传到你们服务器？

不会。技能包下载到你自己电脑上运行，全程本地，本站没有任何上传入口。

技能装了但 AI 找不到，怎么办？

九成是两个原因：文件夹名被改过，或者多套了一层目录。正确路径是「技能目录 / 技能文件夹 / SKILL.md」，中间不能多一层。改完要完全退出 AI 助手再打开。

为什么技能名不能带 claude 或 anthropic？

这是 Agent Skills 标准的硬性规定，属于保留词。技能名还要求全小写字母、数字和连字符，最长 64 个字符，不符合会直接扫描不到。