尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
yichen-skills 开发者指南:从 SKILL.md 到脚本,自建一个 AI Agent 技能全流程
yichen-skills 开发者指南从 SKILL.md 到脚本自建一个 AI Agent 技能全流程【免费下载链接】yichen-skills项目地址: https://gitcode.com/gh_mirrors/yi/yichen-skillsyichen-skills是一个面向内容创作者的开源 AI Agent 技能仓库收录了 20 多个可直接安装到 Claude Code / Codex 的 Skill覆盖内容切片、音视频转写、网页调研、微信数据导出等真实工作流。这篇文章带你以它为范本从零理解一个 AI Agent 技能的完整构成SKILL.md 定义行为、scripts/ 提供执行力、references/ 与 tests/ 保障质量让你也能自建自己的技能。 先看懂一个 AI Agent 技能的标准目录结构打开仓库中任意一个技能目录都会发现高度一致的组织方式。以音视频转写技能为例yichen-volc-asr/ ├─ SKILL.md # 技能的大脑行为规则与流程 ├─ agents/ # Agent 界面配置可选 ├─ scripts/ │ └─ transcribe.py # 真正干活的脚本 └─ references/ # 深度参考文档按需加载SKILL.md是入口Agent 靠它判断什么时候该用我、该怎么用我scripts/存放可执行脚本是技能的能力边界references/放进阶文档避免每次对话都加载全部内容复杂技能还会带tests/目录做离线验证例如 yichen-asr/tests/test_contract.py这种分层结构在 README.zh.md 的目录结构一节有完整展示20 多个技能都遵循同一套范式非常适合作为新手的模板库。✍️ 第一步写好 SKILL.md给技能装上大脑每个技能的 SKILL.md 开头是一段 YAML frontmatter只有两个必填字段却决定了技能能否被正确触发--- name: yichen-volc-asr description: 火山引擎音视频转写 口播自动粗剪 skill…… 触发场景用户说帮我转写这个视频时使用。 ---新手最容易踩的坑就在这里记住三条写法规则name 与目录名保持一致Agent 用目录名定位技能名称对不上就不会加载description 写清做什么 什么时候触发既写功能也写触发词如转写视频、自动粗剪这是自然语言路由的关键正文写流程与边界不写废话比如 yichen-volc-asr/SKILL.md 明确列出原片不动、不得直接删文件等安全规则再给出纯转写、自动粗剪两套标准流程和输出文件清单一份好的 SKILL.md 应该是规则手册而不是功能介绍页。 第二步写辅助脚本给技能长出双手SKILL.md 负责想脚本负责做。技能目录下的scripts/就是执行层转写技能的核心是 yichen-volc-asr/scripts/transcribe.py支持--dry-run、--no-cache等参数Agent 只需按 SKILL.md 的用法拼命令即可Mac 微信双开技能的 yichen-mac-wechat-dual-open/scripts/wechat_dual_open.py 提供status/create/repair等子命令状态检查先行、危险操作留给人工确认写给 Agent 调用的脚本有两条新手必读的设计原则参数化入口把路径、目标 App、Bundle ID 等都做成参数避免写死个人路径本仓库明确要求公开版不保留个人绝对路径安全默认默认只读、默认不覆盖、删除类操作需显式确认。例如双开脚本的launch命令被刻意禁用打开应用永远是用户手动完成的步骤 第三步补齐 references、agents 与 tests当技能变复杂后把细节下沉到子目录是保持 SKILL.md 精简的关键references/按需加载的深度文档。例如 yichen-unified-search/references/routes.md 集中了各搜索后端的参数与限制SKILL.md 只在路由命中时才让它读取agents/面向不同 Agent 平台的界面配置如 yichen-agent-memory/agents/openai.yaml 声明了展示名、简介和默认提示词tests/离线测试守护行为契约。yichen-asr/tests/test_contract.py 直接调用路由脚本断言纯文本走 Step、需要 SRT 走豆包改脚本前先跑测试改动才不会跑偏如果技能会持续迭代建议同时保留一份 README面向人类和 SKILL.md面向 Agent职责分开互不干扰。 安装与验证让技能真正跑起来写好技能后验证流程比编写本身更重要放入加载路径把技能目录整体复制到~/.claude/skills/Claude Code或~/.agents/skills/通用 Agents 路径目录名保持不变重启会话新技能通常需要重新加载会话才生效自然语言触发测试对 Agent 说出 SKILL.md 里写的触发词观察是否正确路由只读差异检查仓库自带 scripts/compare_installed_skills.py可以对 Git 已跟踪的技能文件做哈希比对确认源码版和安装版一致且不读取任何密钥需要完整源码做参考时可以克隆仓库git clone https://gitcode.com/gh_mirrors/yi/yichen-skills⚠️ 常见问题与维护建议技能没触发检查是否在当前真实加载路径、是否重启会话、SKILL.md 的name/description是否正确——这是 README.zh.md 高频 FAQ脚本路径找不到不同 Agent 安装路径不同参考双开技能的做法先定位SKILL.md所在目录再拼相对路径而不是写死~下的某个位置版本同步怎么管仓库将本仓库定位为发布源安装目录只是运行副本修复先改源码、测试通过再安装不做双向自动覆盖。完整流程见 docs/skill-maintenance.md最后提醒本仓库许可为个人学习和非商业使用公开版不包含任何真实凭据自建技能时请务必把 Token、Cookie 等敏感配置留在环境变量或私有文件中。按照SKILL.md 定规则 → scripts/ 给能力 → references/ 沉细节 → tests/ 守契约这四步走下来你就能照着 yichen-skills 的范式搭建出第一个属于自己的 AI Agent 技能了 【免费下载链接】yichen-skills项目地址: https://gitcode.com/gh_mirrors/yi/yichen-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

科技企业知识产权实缴与研发费用加计扣除的衔接要点

科技企业知识产权实缴与研发费用加计扣除的衔接要点

对于科技型企业来说,知识产权实缴和研发费用加计扣除是两项重要的财税政策。如果衔接得当,可以为企业节省不少成本。今天从实操角度梳理几个衔接要点。 一、知识产权实缴的基本流程 知识产权实缴的核心是以专利、软著等无形资产作价出资。流程包括&#…

📅 2026/9/25 20:46:50
商品图和商品链接怎么提炼卖点?用便携榨汁杯拆一遍脚本策划

商品图和商品链接怎么提炼卖点?用便携榨汁杯拆一遍脚本策划

商品图负责提供拍摄线索,商品链接负责提供商品事实。它们放在一起已经很完整,但还不能直接变成脚本。 拿便携榨汁杯来说,详情页通常会把容量、充电方式、刀头结构、便携和自动清洗排得很满。用户真正犹豫的可能是另一个问题:喝完以…

📅 2026/9/25 20:46:50
Python之所以能够高效处理海量数据并保持代码的优雅,很大程度上归功于其底层设计的几个核心概念:迭代器协议、生成器以及切片机制

Python之所以能够高效处理海量数据并保持代码的优雅,很大程度上归功于其底层设计的几个核心概念:迭代器协议、生成器以及切片机制

在现代软件开发与数据分析领域,Python凭借其简洁的语法和强大的生态库占据了重要地位。然而,Python之所以能够高效处理海量数据并保持代码的优雅,很大程度上归功于其底层设计的几个核心概念:迭代器协议、生成器以及切片机制。对于…

📅 2026/9/25 20:46:50
MORE NEWS

更多资讯

📰

工博科技 x 盘古信息|聚势同行,共筑制造业SAP ERP与MES一体化数智新生态

近日,广州工博计算机科技有限公司(以下简称“工博科技”)与广东盘古信息科技股份有限公司(以下简称“盘古信息”)正式签订品牌联营合作协议。双方将围绕制造业数智化转型展开深度协同,充分发挥工博科技在SA…

📰

MATLAB实战:PSO-LSTM-CNN融合算法实现无人机三维路径规划,从智能避障到多目标优化

MATLAB实战:PSO-LSTM-CNN融合算法实现无人机三维路径规划,从智能避障到多目标优化MATLAB、无人机、三维路径规划、粒子群优化、PSO、LSTM、CNN、深度学习、智能避障、多目标优化面对建筑、山体和塔架交错的复杂空域,无人机规划不仅要找到一条…

📰

论文定版依据全攻略:谁认下这版,凭什么算交出版

改到自己也分不清哪一版算数,症结往往不在改得少,而在没人替这一版签过名。本文不排轮次,只谈两件事:谁有资格认下这一版、凭哪几样认,以及什么样的版本状态才够格交出去。以知学术AIPaperGPT的能力落点为例&#xff0…

📰

需求未验证勿备货:TikTok出海Y型科学操盘法完整落地指南

【摘要】TikTok Shop 2025年全球GMV突破653亿美元,近70%新手跨境卖家首年受挫,亏损核心源于需求验证缺失而非执行不足。Y型科学操盘覆盖4个核心环节、5步验证流程、3条失效边界,为出海提供可复用的决策体系。核心关键词:Y型科学操…

📰

如何为AlphaGBM Skills配置API Key:账户额度、--confirm-usage审批机制与套餐完整指南

如何为AlphaGBM Skills配置API Key:账户额度、--confirm-usage审批机制与套餐完整指南 【免费下载链接】skills Bring realtime market data and research workflows into Claude Code, Cursor & beyond — 29 open-source Skills for stocks, options and comm…

📰

【STM32开源项目】智能老人拐杖

目录 一、项目概述 二、实现功能 1、功能详解: 2、项目清单: 3、演示视频: 三、硬件介绍 PCB硬件设计: 四、程序设计 五、项目成品效果图 六、项目总结 七、包含资料 一、项目概述 本项目基于STM32F103C8T6单片机&…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬