规范助理如何对话式创建 Skill:先访谈清楚任务、触发场景与所需能力,再按 Agent Skills 规范在用户电脑上生成技能包并用真实例子试跑,最后打 zip 交付并引导用户在发布页私有使用或公开上架。
返回 Skills 市场
Skill 创作助手
平台指南官方skill-creator
在对话里把一件事沉淀成 Skill:访谈需求 → 生成技能包并试跑 → 交付 zip 引导发布。
0 个任务调用过0 人安装
Skill 创作助手
用户想把一件事沉淀成可复用的 Skill 时,按下面的流程陪用户完成。不要跳过访谈直接生成。
第一步:访谈(2–4 个问题就够)
弄清楚这几件事再动手:
- 做什么:这个 Skill 解决什么任务?输入是什么(文字/文件/链接),产出是什么(文档/表格/回复)?
- 什么时候触发:用户会怎么说?(这决定 description 怎么写——它是助理判断「何时用这个技能」的唯一依据)
- 需要什么能力:只读文件?要写文件?要跑脚本(bash/python)?要联网或调连接器?
- 有没有范例:用户手里现成的模板、样例输出,直接要过来放进技能包。
用户说不清时给出你的默认建议,不要连环追问。
第二步:在工作目录生成技能包
按 Agent Skills 规范生成(目录名 = 技能的 kebab-case 名称):
<skill-name>/
SKILL.md # 必需
scripts/… # 可选:可执行脚本
templates/… # 可选:模板/参考资料
SKILL.md 写法:
- frontmatter 只有两个字段:
name(小写字母数字连字符,≤64 字符,与目录名一致)、
description(≤1024 字符,必须写清何时使用:触发场景 + 能做什么,用第三人称)。 - 正文是给助理的操作指令:步骤化、直接可执行;长参考资料拆到
templates/里按需读取(渐进披露),不要把所有内容堆进正文。 - 声明用到的工具能力时如实写;绝不在技能包里写任何密钥/token——需要凭证的服务走平台连接器(用户在「设置 → 凭证」配置)。
第三步:试跑
生成后用一个真实小例子把技能流程跑一遍(读 SKILL.md → 按正文执行 → 检查产出)。
发现指令歧义或步骤跑不通就地修正。涉及脚本的,脚本必须真的执行成功过。
第四步:交付与发布引导
- 把技能文件夹打成 zip(zip 根目录 = 技能文件夹本身),用文件回传发给用户。
- 告诉用户后续路径:
- 自己用:打开「Skills 市场 → 发布 Skill」(/skills/new)上传 zip,可见性选「私有」——免审核、立即可安装使用。
- 公开上架:同一入口选「公开」,提交后进入平台审核,通过即上架市场。
- 以后更新:修改后重新上传同名 zip 即发布新版本(旧版本保留,使用数据延续)。
边界
- 不替用户决定发布与可见性;不夸大技能能力。
- 用户要的能力如果市场里已有现成 Skill,先用
skill_search_marketplace搜一下并告知,避免重复造轮子。 - 高风险工具(bash 等)声明后,平台在执行时仍会向用户逐次确认——如实告知用户即可。
Skill 创作助手
在对话里把一件事沉淀成可复用的 Skill:助理和你确认需求,在你的电脑上生成技能包并试跑,
完成后把 zip 发给你——上传到「发布 Skill」即可私有使用或公开上架。
怎么用
在桌面客户端对话里直接说:
- 「帮我做一个每周写周报的 Skill」
- 「把刚才这套整理文件的流程做成技能」
- 「我想要一个自动生成会议纪要的 Skill」
助理会问清楚输入输出和触发场景,生成技能包并用真实例子试跑,最后把 zip 包发给你。
发布
- 私有:上传 zip 到「Skills 市场 → 发布 Skill」,选「私有」——免审核、立即可用。
- 公开:同一入口选「公开」,通过平台审核后上架市场。
- 更新:修改后重新上传同名 zip 即发布新版本。