技能创建器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-skill-creator。
技能介绍
为什么要做「技能」而不是堆提示词
当同一类任务被反复交给 Agent——例如每次都要用 Python 旋转 PDF、每次查 BigQuery 都要重新对齐表结构、每次建站都从同一套 React 脚手架拷文件——上下文里会反复出现相同步骤和相同代码。Skills 把多步工作流、工具用法、领域资料和可执行脚本打成模块化包,并用 SKILL.md 的 YAML 描述决定何时激活,避免把整本手册塞进默认提示词。
技能如何组织与创建
每个技能至少包含必填的 SKILL.md;可选资源按用途拆分:
scripts/:重复重写或需要确定性的逻辑(如rotate_pdf.py),可执行而不必整块读入上下文references/:仅在任务需要时加载的文档(schema、API、政策等);大块内容应从 SKILL.md 抽离,触发与工作流步骤仍留在 SKILL.mdassets/:参与最终产物但不载入上下文的文件(模板、字体、品牌图)
加载遵循渐进披露:元数据常驻 → 触发后读 SKILL.md 正文 → 按需读资源或跑脚本。
创建流程按文档顺序走六步:用具体用例弄清触发语与边界 → 从用例推导要沉淀的脚本/参考/资产 → 新技能用 init_skill.py 初始化目录与占位 → 先补 bundled resources,再写 SKILL.md(祈使/不定式指令;行为契约、完成标准等对齐 skill-standards.md)→ 打包前自动校验命名、frontmatter、结构 → 真实任务上迭代 friction。
边界与注意点
- 技能只写会改变 Agent 可观察行为的指令:触发条件、禁止项、门禁顺序、输出字段等;不要写对客户叙述性的废话。
- 若缺关键源文档或资产,应标明对应工作流不支持,而不是在 SKILL.md 里臆造细节。
references/超大文件时,应在 SKILL.md 中给出 grep 搜索模式,同一事实只保留一处,避免与 SKILL.md 重复。- 打包校验失败不会产出 zip,需先修校验错误再重试。
使用场景
- 团队要把「查数仓表结构再写 SQL」做成可复用技能,需要把 schema 放进 references/ 并在 SKILL.md 写清触发语
- 每次处理 PDF 旋转都要 Agent 重写脚本,打算用 init_skill.py 建包并把确定性逻辑放到 scripts/
- 新建前端小应用技能,希望输出直接基于 assets/ 里的 React 模板复制改造而非从零口述目录结构
- 技能初稿写完准备发给他人,需要走打包流程确认 frontmatter 与目录结构通过校验再生成 zip
适合人员
- 维护内部 Agent 技能库的平台工程师,要把重复工作流沉淀成带校验的可分发包
- 给 Claude/Cursor 写领域技能的开发者,需要分清 scripts、references、assets 何时该进包
- 从用户对话里提炼触发语的产品/技术写作者,要按六步流程把边界写进 SKILL.md 元数据
- 对接 skill-standards.md 规范的技能审核者,要检查描述是否只改 Agent 行为而非堆砌说明文