Agent Skills
返回列表
🤖

Ray Skill 制作器

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fb8bdb79/ray-skill-generator

技能介绍

解决什么问题

从零手写一个 AI Agent Skill,看起来只是填一份 SKILL.md,实际坑分布在全流程:触发词写不准导致该触发时不触发、不该触发时误触发;frontmatter 缺字段或 description 写成工作流总结,Agent 跳过主体直接动手;schema、模板、案例全堆进正文,token 膨胀且上下文稀释;示例里夹带真实基金代码、账号或第三方署名,发布前才发现要返工。

核心机制与流程

核心是先判类型,再选模板,最后按阶段推进:

  • 四类型分类:Tool(执行一件事)、Workflow(走一套流程)、Capability(懂一个领域)、Scenario(扮一个角色),用口诀先锁定边界
  • 六步创建流程:理解示例 → 规划内容 → 初始化 → 编辑 → 打包 → 迭代,贯穿创建全程
  • 五阶段质量审计:需求澄清 → 设计 → 构建 → 验证 → 发布,Phase 0 需求澄清不可跳过,先问清「解决什么问题」「用户会怎么说」「属于哪种类型」

关键工程实践:

  • 渐进式披露:SKILL.md 只留核心流程 + 索引,schema/模板/案例放 references/,信息只存一处
  • 脱敏左移:创建时内建三规则——不写来源署名、不写个人隐私、维护记录不列第三方名;发布前用 sanitize_skill.py 扫描确认零残留,工具/依赖包名与功能性引用属于保留项
  • 写作风格:imperative 第三人称("To do X, run Y"),写"为什么"不只写"怎么做";弱模型适配三件套(输出格式模板带占位符、Few-shot 示例、结构化标记);三档自由度按操作脆弱性分级——低档写死命令、中档参数化伪码、高档给启发式
  • 模板必带章节:## Definition of Done 把完成标准从"感觉"变成"可测量",## Gotchas 承载环境专属怪癖,与 DoD 同级
  • 验证闭环:触发双向验证(should-trigger 3 个正例 + near-miss 3 个边界模糊反例)、增量价值验证(with-skill vs without-skill 对比)、健康分门槛与 dry-run 通过

适用边界

  • 只负责从零创建;已有 skill 的优化交给 ray-skill-evolve,两者互补不重叠
  • description 禁止写工作流总结,只写"做什么 + 何时用 + 触发词",否则 Agent 只看描述就动手
  • 流水线式拆分是死路:A 出初稿、B 美化会让 A 空心化,正交切分才能保证两个 skill 独立可用
  • ## Gotchas 的 None known 是合法值,禁止编造怪癖凑数——假约束会教模型一直绕弯路

适合在动手写第一行之前先过一遍这套分类与流程;不适合给已有 skill 做增量迭代。

使用场景

  • 首次从零编写Agent Skill,需要先判断Tool/Workflow/Capability/Scenario类型再选模板
  • Skill发布前做验证,需要跑should-trigger和near-miss触发测试证明路由准确
  • Skill创建时把脱敏规则写进正文,避免来源署名或个人隐私留到发布前补救
  • 拆分多个Skill时需要判断切法,避免初稿→美化这类流水线切法导致空心化

适合人员

  • Agent平台工程师,需要把手动Skill创建流程整理成可复用规范并沉淀方法论
  • 团队skill库维护者,需要统一新建Skill的脱敏规则、完成标准和验证检查项
  • 独立开发者,正在开发第一个Agent Skill但缺少创建流程和质量反馈经验
  • 技术博客作者,想按Skill创建流程讲解元工具设计而不是做产品宣传