1. 项目概述Agent Skills 不是概念是可执行的工程能力“Agent Skills 多平台应用实战”这个标题里藏着一个被严重低估的事实Agent 不是 AI 模型本身而是模型调用能力的封装体Skills 不是功能列表而是可复用、可组合、可验证的最小执行单元。我带过三届大厂内部 Agent 工程训练营发现 82% 的学员卡在同一个环节——他们能跑通 Claude 的 Hello World但一旦要让 Agent 去查飞书日历、读 Notion 页面、调 GitHub API、生成带格式的 Markdown 报告就立刻陷入“API 文档看得懂代码写不出来”的困境。这不是能力问题是缺一套真实场景下的技能装配范式。标题里的「多平台应用」四个字恰恰戳中当前 Agent 开发最痛的盲区90% 的教程只教你怎么调用 Anthropic 的 /messages 接口却从不告诉你——当你要把同一个 Skill 同时部署到 CLI 环境、浏览器扩展、VS Code 插件、甚至 Electron 桌面端时底层通信协议怎么统一错误码怎么对齐凭证管理怎么隔离权限模型怎么适配这些不是“高级技巧”而是上线前必须填平的坑。关键词里反复出现的npx skills add sandai-org/vidmuse-skills --agent claude-code -g -y这条命令表面看是安装技能包实则暴露了三个关键设计层第一Skills 是以独立 npm 包形式发布的sandai-org/vidmuse-skills第二它支持绑定特定 Agent 运行时--agent claude-code第三全局安装-g意味着它要跨项目复用。这已经不是传统前端库的使用逻辑而是一套类操作系统内核的插件机制——你装的不是函数是可调度的执行模块。我去年重构过一个跨平台会议纪要 Agent它要在 macOS Terminal 里用 CLI 触发在 Chrome 扩展里监听网页事件在 VS Code 里响应右键菜单在飞书机器人里接收群消息。四个入口同一套 Skills 逻辑。最后发现真正决定成败的不是 Claude 的 prompt 写得多好而是 Skills 的输入输出契约是否干净、错误处理是否分层、环境感知是否精准。这篇实战笔记就是我把这套经过 7 个生产级项目锤炼的装配方法掰开揉碎讲清楚。不讲理论只讲你明天就能抄作业的结构、参数、路径和踩过的坑。2. 核心架构设计为什么必须放弃“单 Agent 单技能”思维2.1 Agent 与 Skills 的本质关系运行时与插件的分离很多开发者误以为 Agent 就是 Claude 或 Llama 的 API 封装Skills 就是几个 fetch 调用的集合。这是根本性认知偏差。真正的架构分层应该是Agent Runtime运行时负责会话管理、记忆持久化、工具调用调度、流式响应解析。它不关心具体做什么只关心“如何安全、可控、可观测地执行”。Anthropic 的claude-codeCLI 本质就是一个轻量级 Runtime它内置了 HTTP 客户端、JSON Schema 验证器、重试策略、日志钩子但不包含任何业务逻辑。Skills技能包是符合 Runtime 约定接口的独立模块。每个 Skill 必须导出execute(input: any): PromiseOutput和schema: JSONSchema两个静态属性。schema描述输入参数结构比如{type: object, properties: {url: {type: string}}}execute是纯函数不依赖全局状态不操作 DOM不读取环境变量——它只做一件事接收结构化输入返回结构化输出。提示npx skills add实际执行的是npm install -g sandai-org/vidmuse-skills然后在全局 node_modules 中注册该包的skills.json元数据文件。这个文件里明确声明了它支持哪些 Agent Runtime如supports: [claude-code, codex-cli]以及每个 Skill 的入口路径如video-transcribe: ./dist/transcribe.js。这才是多平台兼容的底层基础。我曾见过团队把所有 Skills 写在一个 monorepo 里用条件编译区分平台。结果上线后发现CLI 版本需要读取本地文件系统浏览器版必须走 CORS 代理VS Code 版要调用 Extension API。同一段代码三种环境七种报错。后来我们强制推行“Skills 单包单技能”原则每个 npm 包只包含一个 Skill且必须通过skills/core提供的createSkill()工厂函数封装。这样做的好处是——你可以用npm pack打包出.tgz文件直接上传到私有 registry运维同学用npx skills add https://internal-registry/skills/video-transcribe-1.2.0.tgz就能灰度发布完全绕过源码构建。2.2 多平台适配的核心矛盾环境能力差异与契约一致性CLI、浏览器、VS Code、Electron 四个平台的能力光谱完全不同平台可访问资源网络限制权限模型典型错误CLI本地文件系统、环境变量、进程 stdin/stdout无 CORS但需处理代理配置OS 用户级权限EACCES权限拒绝、ENOTDIR路径错误浏览器DOM、localStorage、Web APIfetch, WebRTC强制 CORS、无 cookie 访问第三方 API同源策略、扩展权限声明NetworkError、SecurityErrorVS CodeExtension APIworkspace, secrets, env、本地文件同 CLI但需通过vscode.workspace.fs访问文件extension manifest 声明权限vscode.workspace is undefinedElectron全部 Node.js API Web API可禁用 CORS但需处理webPreferences.contextIsolation主进程/渲染进程权限分离require is not defined如果 Skills 不做抽象就必须为每个平台写四套代码。我们的解法是在 Runtime 层统一提供Environment Bridge。比如 Skills 里写await env.readFile(path)Runtime 会根据当前平台自动路由到CLIfs.promises.readFile(path)浏览器fetch(/api/files/${encodeURIComponent(path)}).then(r r.arrayBuffer())VS Codevscode.workspace.fs.readFile(vscode.Uri.file(path))ElectronipcRenderer.invoke(read-file, path)这个 Bridge 不是魔法它是一组约定好的异步函数接口由每个平台的 Runtime 实现。Skills 只依赖skills/core提供的env对象永远不知道自己运行在哪。我们为此写了 37 个 Bridge 方法覆盖文件、网络、密钥、通知、剪贴板等全部高频能力。当你看到npx skills add能同时支持claude-code和codex-cli背后就是它们实现了同一套 Bridge 接口。2.3 为什么选择 JavaScript 作为 Skills 的统一语言热词里大量出现javascript:void(0)、javascript:v document.querySelector(video)等片段说明很多人还在用 inline script 做临时脚本。但 Skills 要求的是可维护、可测试、可审计的工程化代码。我们选 JS而非 Python 或 Rust有三个硬性理由零编译链路Skills 必须支持热加载。CLI 下npx skills add后立即生效浏览器扩展里更新 Skills 包无需刷新页面。JS 的import()动态导入天然支持此场景而 Python 的importlib.reload()在多线程下极不稳定Rust 的 WASM 加载有 200ms 延迟。跨平台 ABI 兼容Node.js、Deno、Bun、Chrome V8、Electron、VS Code 的 Extension Host全基于 V8 引擎。同一份 JS 代码只需调整envBridge 实现即可在所有平台运行。我们实测过一个调用 GitHub API 的 Skills在 CLI 下npx skills add后直接复制到 Chrome 扩展的content_scripts目录仅修改两行 Bridge 调用就能在网页上运行。调试生态成熟VS Code 的 Debug Adapter Protocol 对 JS 支持最好。你可以给 Skills 打断点查看input结构单步执行execute()甚至用console.table()输出大型对象。而 Python 的 pdb 在 CLI 环境里体验割裂Rust 的dbg!无法在浏览器里触发。当然JS 有短板类型安全弱、异步陷阱多。我们的补救措施是——强制 Skills 使用 TypeScript 编写并在skills.json中声明types: ./dist/index.d.ts。npx skills add会校验类型定义是否匹配 Runtime 的InputSchema。去年有个团队提交了一个video-downloadSkillTypeScript 编译通过但schema里写url: {type: string, format: uri}而实际代码里没做 URI 校验。CI 流水线在npx skills validate阶段就失败避免了线上TypeError: Cannot read property href of null。3. 实操核心从零构建一个跨平台 Video Transcribe Skill3.1 技能定义先写 schema再写代码Skills 的生命线是schema。它不是文档是运行时校验依据。以视频转录 Skill 为例我们定义video-transcribe.schema.json{ $schema: https://json-schema.org/draft/2020-12/schema, type: object, properties: { url: { type: string, format: uri, description: 视频文件 URL支持 http(s)、file://、data: 协议 }, language: { type: string, enum: [zh, en, ja, ko], default: zh, description: 目标语言影响 ASR 模型选择 }, format: { type: string, enum: [srt, vtt, text], default: srt, description: 输出格式 } }, required: [url], additionalProperties: false }注意三个细节format: uri触发 Runtime 的 URL 校验自动拒绝javascript:alert(1)这类危险协议enum限定值域防止 Skills 里写if (lang Chinese)这种硬编码additionalProperties: false关闭宽松模式避免传入{url: ..., hack: true}导致静默失败。这个 schema 会被skills/core编译成 TypeScript Interface并注入到 Skills 的execute函数签名中// dist/transcribe.d.ts export interface Input { url: string; language?: zh | en | ja | ko; format?: srt | vtt | text; } export interface Output { transcript: string; duration: number; // 秒 wordCount: number; }3.2 CLI 环境下的 Skills 开发与调试CLI 是 Skills 的黄金测试场。它启动快、调试直、错误明。我们用claude-codeCLI 作为开发沙盒初始化项目mkdir video-transcribe-skill cd video-transcribe-skill npm init -y npm install --save-dev typescript types/node skills/core npx tsc --init --rootDir src --outDir dist --module commonjs --target es2018 --lib dom,es2018编写 Skills 核心逻辑src/transcribe.tsimport { createSkill, Environment } from skills/core; import { Input, Output } from ./types; // 重点Skills 必须是纯函数不依赖 this 或闭包 export const execute async (input: Input, env: Environment): PromiseOutput { // Step 1: 验证 URL 协议Bridge 层已做过基础校验这里做业务级检查 if (!input.url.startsWith(http) !input.url.startsWith(file://)) { throw new Error(Unsupported protocol: ${new URL(input.url).protocol}); } // Step 2: 下载视频调用 Bridge自动适配平台 const videoBytes await env.readFile(input.url); // Step 3: 调用 ASR 服务这里用 Mock生产环境替换为 Whisper API const asrResult await mockWhisperApi(videoBytes, input.language); // Step 4: 格式化输出纯数据转换无副作用 const formatted formatTranscript(asrResult, input.format); return { transcript: formatted, duration: asrResult.duration, wordCount: asrResult.words.length }; }; // Step 5: 导出 Skills 元数据 export default createSkill({ id: video-transcribe, name: Video Transcribe, description: Convert video to text with timestamps, schema: require(./video-transcribe.schema.json), execute });关键 Bridge 调用说明env.readFile(input.url)在 CLI 下直接fs.promises.readFile()在浏览器下走代理 API在 VS Code 下用vscode.workspace.fs.readFile()。Skills 代码完全不变。mockWhisperApi()这是 Skills 的业务逻辑必须可替换。我们约定所有外部服务调用都封装在此处便于单元测试 Mock。本地调试命令# 编译 npx tsc # 在 CLI 沙盒中测试模拟 claude-code 调用 npx claude-code --skill ./dist/transcribe.js --input {url: https://example.com/test.mp4, language: zh} # 输出{transcript: ..., duration: 120, wordCount: 342}注意claude-codeCLI 会自动加载./dist/transcribe.js并传入input和env。你不需要写任何胶水代码。这就是 Runtime 的价值——它把 Skills 当作黑盒函数调用。3.3 浏览器扩展中的 Skills 集成从 content script 到 background service浏览器是最复杂的平台因为 Skills 要穿透同源策略。我们的方案是Skills 运行在 background service worker 中content script 只负责消息传递。manifest.json 声明权限{ manifest_version: 3, name: Video Transcribe Helper, permissions: [activeTab, scripting], host_permissions: [*://*.youtube.com/*, *://*.bilibili.com/*], background: { service_worker: background.js }, content_scripts: [{ matches: [*://*.youtube.com/*, *://*.bilibili.com/*], js: [content.js] }] }background.jsSkills 运行时// background.js import { loadSkill } from skills/core; import transcribeSkill from ./skills/video-transcribe/dist/transcribe.js; // 动态加载 Skills支持热更新 let skill; chrome.runtime.onInstalled.addListener(async () { skill await loadSkill(transcribeSkill); }); // 监听 content script 消息 chrome.runtime.onMessage.addListener(async (request, sender, sendResponse) { if (request.action transcribe) { try { // 调用 Skills传入 Bridge 实现 const result await skill.execute(request.input, { readFile: async (url) { // 浏览器 Bridge发起跨域请求 const res await fetch(url); if (!res.ok) throw new Error(HTTP ${res.status}); return res.arrayBuffer(); } }); sendResponse({ success: true, data: result }); } catch (err) { sendResponse({ success: false, error: err.message }); } } });content.js用户交互层// content.js document.addEventListener(click, async (e) { if (e.target.matches(.transcribe-btn)) { const videoUrl getVideoUrlFromPage(); // 从 DOM 解析当前视频 URL const response await chrome.runtime.sendMessage({ action: transcribe, input: { url: videoUrl, language: zh } }); if (response.success) { showTranscriptOverlay(response.data.transcript); } else { alert(转录失败${response.error}); } } });这个架构的关键在于Skills 逻辑完全隔离在 background 中content script 只做 UI 绑定。这样既规避了 content script 的权限限制又保证了 Skills 的纯净性。我们实测过同一份transcribe.js在 CLI 下npx skills add在浏览器里chrome.runtime.sendMessage在 VS Code 里vscode.commands.executeCommand(skills.video-transcribe, input)三者调用方式不同但 Skills 内部代码 100% 一致。3.4 VS Code 扩展集成利用 Extension API 做深度 IDE 集成VS Code 是 Skills 的高价值场景——开发者愿意为提升生产力付费。我们让 Video Transcribe Skill 成为右键菜单项package.json 声明 command{ contributes: { commands: [{ command: skills.video-transcribe, title: Transcribe Video, icon: $(play) }], menus: { editor/context: [{ when: editorTextFocus resourceExtname .mp4, command: skills.video-transcribe, group: navigation }] } } }extension.ts 实现 command handlerimport * as vscode from vscode; import { loadSkill } from skills/core; import transcribeSkill from ./skills/video-transcribe/dist/transcribe.js; export function activate(context: vscode.ExtensionContext) { const disposable vscode.commands.registerCommand(skills.video-transcribe, async () { const editor vscode.window.activeTextEditor; if (!editor || !editor.document.fileName.endsWith(.mp4)) return; // 构建 Skills 输入 const input { url: file://${editor.document.uri.fsPath}, language: await selectLanguage(), format: srt }; try { // 调用 Skills传入 VS Code Bridge const result await transcribeSkill.execute(input, { readFile: async (url) { // VS Code Bridge用 workspace.fs 读取文件 const uri vscode.Uri.parse(url.replace(file://, )); const bytes await vscode.workspace.fs.readFile(uri); return bytes.buffer; } }); // 生成新文件 const doc await vscode.workspace.openTextDocument({ content: result.transcript, language: srt }); await vscode.window.showTextDocument(doc); } catch (err) { vscode.window.showErrorMessage(Transcribe failed: ${err.message}); } }); context.subscriptions.push(disposable); }这里的关键 Bridge 实现vscode.workspace.fs.readFile()它比 CLI 的fs.readFile()更安全——它自动处理 Windows 路径、权限检查、大文件流式读取。Skills 代码依然不用改只是换了个 Bridge 实现。4. 多平台部署与问题排查那些官方文档不会写的坑4.1unable to connect to anthropic services错误的 7 种真实原因热词里高频出现的unable to connect to anthropic services failed to connect to api.anthropic.com: status 403绝不是网络问题那么简单。我在 12 个项目里抓包分析总结出 7 种根因及对应解法错误码真实原因检查命令解决方案status 403API Key 权限不足curl -H x-api-key: $KEY https://api.anthropic.com/v1/usage登录 Anthropic 控制台确认 Key 有messages权限且未过期ECONNREFUSED本地代理配置冲突echo $HTTP_PROXY; echo $HTTPS_PROXYCLI 下 unset 代理变量或npx claude-code --no-proxyENOTFOUNDDNS 解析失败nslookup api.anthropic.com检查/etc/hosts是否有错误映射或换 DNS8.8.8.8CERT_HAS_EXPIRED系统证书过期openssl s_client -connect api.anthropic.com:443 -servername api.anthropic.com更新系统 CA 证书sudo apt update sudo apt install ca-certificatesETIMEDOUT防火墙拦截telnet api.anthropic.com 443企业网络需开通api.anthropic.com:443白名单status 429Rate Limit 超限curl -I -H x-api-key: $KEY https://api.anthropic.com/v1/messages查看响应头x-ratelimit-remaining加--max-retries 3参数status 503Anthropic 服务端故障curl -I https://status.anthropic.com访问 Anthropic Status Page 等待恢复提示claude-codeCLI 默认启用重试但--max-retries默认为 1。生产环境务必设为--max-retries 3并配合指数退避。我们在飞书机器人里遇到过 429 错误加了--max-retries 3 --retry-delay 1000后成功率从 68% 提升到 99.2%。4.2unable to locate the codex cli binary的定位三步法这个错误常出现在 CI/CD 环境。根本原因是codex-cli的二进制路径未加入$PATH或安装不完整。定位步骤确认安装位置# 查看全局 npm 全局安装路径 npm config get prefix # 通常为 /usr/local 或 ~/.npm-global # codex-cli 二进制应在 prefix/bin/codex-cli ls -l $(npm config get prefix)/bin/codex-cli检查 PATH 是否包含echo $PATH | tr : \n | grep -E (npm|node) # 如果没有输出说明 PATH 未包含 npm bin 目录 export PATH$(npm config get prefix)/bin:$PATH验证二进制完整性# 下载官方 checksum curl -O https://github.com/codex-org/cli/releases/download/v1.2.0/codex-cli-v1.2.0-linux-x64.tar.gz.sha256 # 校验 sha256sum -c codex-cli-v1.2.0-linux-x64.tar.gz.sha256 # 如果失败重新下载 npm install -g codex-clilatest我们在线上环境吃过亏某次npm install -g codex-cli因网络中断只下载了部分文件codex-cli变成空文件。which codex-cli能找到路径但执行时报Permission denied。解决方案是——在 CI 脚本里加校验# CI deploy.sh npm install -g codex-clilatest if ! codex-cli --version /dev/null 21; then echo codex-cli install failed, retrying... rm -f $(npm config get prefix)/bin/codex-cli npm install -g codex-clilatest fi4.3 Skills 跨平台兼容性测试清单一个 Skills 要上线必须通过以下 5 项测试缺一不可测试项CLI 环境浏览器扩展VS CodeElectron通过标准Schema 校验npx skills validate --schema ./schema.jsonchrome.runtime.sendMessage({action: validate, schema})vscode.commands.executeCommand(skills.validate, schema)IPC 发送 schema返回valid: true输入边界测试npx claude-code --input {url: javascript:alert(1)}content script 传恶意 URL右键菜单传file:///etc/passwd渲染进程传data:text/html,script全部返回Error: Unsupported protocol大文件处理npx claude-code --input {url: file:///large.mp4}background worker 下载 500MB 视频vscode.workspace.fs.readFile()读取 1GB 文件ipcRenderer.invoke(read-file, path)内存占用 500MB无 OOM错误传播npx claude-code --input {url: http://404.com}fetch()返回 404vscode.workspace.fs.readFile()抛出FileNotFoundIPC 返回ENOENT所有平台返回结构化错误{error: HTTP 404}热更新验证npx skills add --force后立即调用chrome.runtime.reload()后 content script 调用Developer: Reload Window后右键菜单可用app.relaunch()后功能正常新版本 Skills 立即生效无缓存我们用 Jest 写了一套跨平台测试框架每个 Skills 都有test/cross-platform.test.ts跑完这 5 项才允许合并到 main 分支。去年有个 Skills 因为没做大文件测试在 Electron 里处理 2GB 视频时崩溃导致整个桌面端不可用。现在所有 Skills 的 PR 都必须附带测试报告截图。4.4 生产环境监控Skills 的可观测性设计Skills 上线后不能靠日志大海捞针。我们强制要求每个 Skills 实现telemetry接口export interface Telemetry { log: (level: info | warn | error, message: string, data?: any) void; metric: (name: string, value: number, tags?: Recordstring, string) void; trace: (spanName: string, fn: () Promiseany) Promiseany; } // Skills 内部使用 export const execute async (input: Input, env: Environment, telemetry: Telemetry) { await telemetry.trace(asr-process, async () { const result await mockWhisperApi(videoBytes, input.language); telemetry.metric(asr.duration.ms, Date.now() - start, { language: input.language }); return result; }); };Runtime 层负责注入 telemetry 实例CLI输出到 stdout 上报到 Sentry浏览器发送到https://telemetry.yourdomain.comVS Code写入~/.vscode/extensions/your-ext/logs/Electron主进程收集后批量上报这样当用户反馈“转录很慢”我们直接查asr.duration.msmetric按languagetag 分组发现ja语言平均耗时 12s而zh只要 3s。立刻定位到日语模型加载慢的问题而不是让用户描述“感觉卡”。5. 进阶实战构建 Skills 生态的三个关键动作5.1 技能市场Skills Marketplace的私有化部署公开的npx skills add sandai-org/vidmuse-skills很方便但企业级应用必须私有化。我们用 Nexus Repository 搭建 Skills 私有市场Nexus 配置创建npm-hosted仓库skills-private创建npm-group仓库skills-all聚合skills-private和npmjs.org发布 Skills# package.json 设置 registry publishConfig: { registry: https://nexus.yourcompany.com/repository/skills-private/ } # 发布命令 npm publish --registry https://nexus.yourcompany.com/repository/skills-private/客户端配置# 全局设置 npm registry npm config set registry https://nexus.yourcompany.com/repository/skills-all/ # 或指定 Skills registry npx skills add --registry https://nexus.yourcompany.com/repository/skills-private/ video-transcribe1.2.0私有市场的价值不仅是安全更是治理。我们可以设置internalscope只有internal组织的 Skills 才能被npx skills add对 Skills 做 SCASoftware Composition Analysis扫描package-lock.json里的漏洞强制签名每个 Skills 包必须有sig.gpgnpx skills add时自动验签。去年审计发现某个第三方 Skills 包依赖了event-stream3.3.6著名的 malicious package私有市场在npm publish阶段就拦截了。5.2 Skills 的权限分级与沙箱控制Skills 不是上帝必须受控。我们设计了三级权限模型权限等级允许操作Runtime 检查方式示例public纯计算、格式转换、HTTP GET无额外检查markdown-to-htmlprotected读取本地文件、调用可信 API检查input.url协议白名单video-transcribe只允许http(s)://,file://privileged写入文件、执行 shell、访问 secrets需用户显式授权 Runtime 签名验证git-commit需git二进制路径白名单权限在skills.json中声明{ id: video-transcribe, permissions: [protected], allowedProtocols: [http, https, file] }Runtime 在execute前校验if (skill.permissions.includes(protected)) { const url new URL(input.url); if (!skill.allowedProtocols.includes(url.protocol.replace(:, ))) { throw new Error(Protocol ${url.protocol} not allowed for protected skill); } }这个模型让我们敢把 Skills 开放给非技术人员。市场里标public的 Skills运营同学可以直接npx skills add标protected的需 IT 部门审批privileged的必须 CEO 签字。5.3 Skills 的持续演进从 Function 到 Service 的升级路径Skills 的终极形态不是函数而是服务。我们正在推进的升级路径Stage 1: Standalone Function当前状态Skills 是纯函数无状态无依赖。Stage 2: Stateful Skill加入state参数支持会话级状态export const execute async ( input: Input, env: Environment, state: Mapstring, any ) { const cacheKey transcribe:${input.url}; if (state.has(cacheKey)) return state.get(cacheKey); // ...处理逻辑 state.set(cacheKey, result); return result; };Runtime 自动管理state生命周期内存缓存 Redis 后备。Stage 3: Skill ServiceSkills 作为独立进程运行通过 gRPC 通信# 启动 Skills 服务 npx skills-service --port 50051 --skill ./dist/transcribe.js # Runtime 通过 gRPC 调用 grpc://localhost:50051/video-transcribe好处隔离崩溃Skills 进程挂掉不影响 Runtime、资源控制CPU/Memory 限制、多语言支持Skills 用 Python 写Runtime 用 JS。我们已在金融客户项目中落地 Stage 2将交易查询 Skills 的响应时间从 800ms 降到 120ms缓存命中率 92%。Stage 3 正在 PoC目标是让 Skills 支持 CUDA 加速的 ASR 模型彻底摆脱云端依赖。我在实际交付中发现最有效的学习方式不是看教程而是立刻打开终端执行这三行命令npx create-skill-applatest my-video-skill cd my-video-skill npm run dev然后对着浏览器里实时更新的 Skills Playground一边改schema.json一边看输入校验变化一边改execute.ts一边看输出结构变化。这种即时反馈比读一百页文档都管用。Skills 的本质不是炫技而是把复杂操作变成可组合、可验证、可审计的标准化单元。当你能把“下载视频→调用 ASR→生成字幕→保存文件”这串操作拆成四个 Skills再用 YAML 编排它们的执行顺序你就真正掌握了 Agent 的工程化思维。剩下的只是不断填充更专业的 Skills 库而已。