AI标准化技能创建助手
用于创建、修改或检查满足 WorkBuddy 等平台发布要求的 Skill。先确认目标发布平台;对现有技能先阅读原文件,保留用户已经写入的字段、指令和资源,按请求做最小必要修改。
创建依据
核心创建方法遵循 Anthropic 发布的 Skill Creator:先明确技能用途与触发场景,再编写初稿,使用真实的用户请求测试输出,与用户一起评估结果并按反馈迭代。现有技能可从评估与改进阶段开始;测试方式按任务风险和当前环境选择。本技能已写明执行所需的流程,不要求读取或安装另一项技能。
下方九个字段是本技能的基础交付要求。还要核对目标平台当前的发布说明与报错,补齐它要求的其他字段;不能把九个字段当成所有平台的完整清单。字段默认写在 SKILL.md 的 YAML frontmatter 中;若目标平台要求放在其他配置文件,按其格式存放并在交付说明中指出位置。平台校验不取代上述内容设计和测试流程,也不要为了通过不识别扩展字段的校验器而删除发布必需字段。
必需信息
每个交付的技能都要有以下基础信息,且值不能是空字符串或占位符;目标平台要求的额外信息也必须补齐:
| 字段 | 要求 |
|---|---|
name |
稳定的机器名;遵守目标平台命名规则,通常为小写字母、数字和连字符。 |
version |
实际版本号;新技能从 1.0.0 起,修改已有技能时保留或按用户要求调整。 |
display_name |
中文展示名。使用目标用户常搜的任务词和领域词,尽量吸睛、生动、易搜索,同时准确反映技能内容,不使用夸大承诺或无关热门词。 |
display_name_en |
与实际功能一致的英文展示名。 |
description |
简要说明技能做什么、何时使用,便于技能发现和调用。 |
description_zh |
面向中文用户的准确简介。 |
description_en |
与中文简介语义一致的英文简介。 |
examples_zh |
至少一条简短、可直接发给助手的中文快捷调用示例,覆盖真实能力;无需用户描述内部创建流程或发布字段。 |
examples_en |
与中文示例逐项对应的英文快捷调用示例,数量必须与 examples_zh 相等;同样使用自然的用户表达。 |
name 与 display_name 分工不同:前者是稳定标识,后者服务于搜索和辨认。确定中文展示名时,从用户任务中提炼常用搜索词,检查名称是否一眼能看出用途,并避免仅用“智能助手”“效率神器”等宽泛词。可以提出 2–3 个更吸睛、生动且符合内容的 display_name 候选,并简述推荐理由;新技能可采用最合适的候选,修改已有技能时先保留原展示名,将优化建议交给用户决定。没有可靠搜索数据时,不声称经过热度验证。
创建与修改
- 从用户需求或已有技能中提炼用途与触发场景,创建或修改核心
SKILL.md及必要资源;编写真实的测试请求,检查技能输出,与用户评估并据反馈迭代。尊重用户对测试范围的要求。 - 在核心技能成形后填写九个基础字段,并按 WorkBuddy 或其他目标平台的当前发布要求补齐其余字段。中英文描述要对应真实功能;快捷调用示例要简短、自然、可直接使用,而非解释字段用途的文字。
- 检查 YAML 能解析、九个基础字段与平台额外字段都存在且有效、两组示例都是非空字符串列表且数量相等;再运行目标平台适用的发布校验,处理实际报错。
- 技能创建与校验完成后,询问用户是否需要配套图片;图片步骤结束后,建议用户按需生成纯净的发布 ZIP。只有用户明确需要时才运行打包脚本。交付时列出已完成的文件和测试结果;若生成了 ZIP,再提供压缩包路径。若某校验器不支持扩展字段,分别报告字段检查结果和该校验器的兼容性限制。
可选配套图片
技能创建完成后,询问用户是否需要生成一张 512 × 512 px、PNG 格式、文件大小不超过 500 KB 的配套图片。若用户已在当前请求中明确要求生成,则无需重复询问;若用户表示不需要,不再执行图片相关步骤,也不创建占位图片。
用户需要图片时,先用一句话概括该技能的中心思想,再把它转化为一个可拍摄的主体与场景,生成唯美、极简的照片:主体明确、构图克制、光线自然、细节真实,在缩略图尺寸下仍易辨认。避免文字、界面截图、图标式插画、抽象装饰和与技能用途无关的物件。使用当前环境可用的图片生成能力;如不可用,说明限制,不把其他形式的图形冒充照片。
将成品放入技能目录的 assets/,避免覆盖用户已有文件。导出后实际检查 PNG 格式、512 × 512 px 尺寸和不超过 500 KB 的文件大小;超限时在不明显损伤视觉质量的前提下压缩或重新导出,并向用户提供成品路径。
纯净 ZIP 交付
技能及可选图片步骤完成后,向用户建议可生成纯净的发布 ZIP,并询问是否需要。用户不需要或尚未答复时,不运行打包脚本。用户明确需要时,运行 python scripts/package_clean.py <技能目录> [输出.zip]。脚本仅收录技能目录内的普通文件,保留技能文件夹作为 ZIP 顶层目录,排除 __MACOSX、.DS_Store、._*、Thumbs.db、desktop.ini、版本控制目录、Python 缓存和已有 ZIP 等附加内容;发现符号链接或缺少 SKILL.md 时停止,不交付不完整的包。
打包后检查 ZIP 文件清单与 CRC,确认只有预期文件,没有系统附加内容。若打包或检查失败,先修复再交付;不要仅凭命令退出成功就宣称压缩包纯净。将压缩包路径和实际包含的主要文件告知用户。
只有用户明确要求安装、发布或覆盖已有技能时才执行相应操作;创建技能文件本身不等于已安装到目标平台。