SuperAPI AI 工具集

skill-generate

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:skill-generate 面向 @tanstack/intent 智能体技能仓库的维护者,把库的源文档(文档、指南、API 参考、源码)与技能树产物提炼成一份完整的 SKILL.md,供编码智能体读取以指导代码生成,而非面向人类读者。

两种模式:模式 A,已存在 domain_map.yaml 与 skill_spec.md,按名称生成指定技能;模式 B,没有 domain map,直接从输入的源文档生成。输入包括技能路径(形如 library-group/skill-name)、技能描述、源文档,模式 A 还包含 domain map 条目(失败模式、子系统、组合、源引用)。

主要流程:一、判定技能类型(core、sub-skill、framework、lifecycle、composition、security);二、从来源提取内容,只提取智能体无法自行知道的部分,如 API 形状、最小初始化代码、主要模式、关键配置、失败模式与约束不变量,并扫描 GitHub issue 与 discussion 获取常见错误与迁移边界问题;三、编写 frontmatter;四、编写正文(Setup、Core Patterns、Common Mistakes 等固定顺序);五、按列表校验(如 500 行以内、真实包名导入、无占位代码、错误可溯源、name 为无斜杠的叶子段);六、输出,批量生成按核心技能、子技能、框架技能、组合技能、安全检查技能、参考文件的顺序排列。

写法约束:所有导入使用真实包名;不使用 // ... 等占位符;不写库外通用知识;不写营销文案;每个 SKILL.md 自包含(除声明的 requires);代码块用三反引号并标注语言;不使用 XML 标签;frontmatter 中 name 为小写字母、数字与连字符组成且与父目录同名,intent 专用字段放在 metadata 下。批量生成时为每个技能启动独立子智能体。开源项目仓库中若存在 FAQ.md、TROUBLESHOOTING.md 或 docs/faq,可作为无网络时的回退来源。具体仓库地址为 https://www.skills.sh/tanstack/intent/skill-generate。