SuperAPI AI 工具集

skill-template-generator

通用与其它

查看项目

更新于 10-15 22:13

技能介绍

用途:给定结构化模式描述(来自 codebase-pattern-analyzer 或人工分析),生成合法的 SKILL.md 文件,供 OpenSpace 注册、为任务选择技能并随时间演进。适用时机:从参考代码库提取模式后打包为可复用技能;创建教智能体执行某类任务的新技能;把非正式文档或代码示例转为 SKILL.md 格式。

文件格式:每个技能至少是一个含 SKILL.md 的目录,另有可选 scripts/、references/、assets/ 子目录。文件开头必须有 YAML frontmatter,且仅含 name 与 description 两个字段。name 须与目录名一致(kebab-case、小写);description 建议 15-40 词,包含 LLM 检索用的关键术语;其他内容一律放入 markdown 正文。正文模板含标题、1-2 句摘要、When to Use 触发条件、核心内容分节、Key Patterns 约定与最佳实践。

生成步骤:第一步确定技能类别,对应 OpenSpace 三类——tool_guide(教如何使用某工具或技术)、workflow(有顺序的端到端流程)、reference(为决策提供知识);类别影响执行分析时对技能的评价方式。第二步撰写 description,公式为动作动词+具体主题+关键技术/方法+上下文/项目引用,须具体可检索,避免笼统表述。第三步写可执行指令:workflow 类需给出确切文件路径、完整可运行代码模板、导入语句、接口定义与集成点,路径可用 {baseDir} 表示相对技能目录;tool_guide 类需含 API 端点、认证机制、响应结构、速率限制与错误处理;reference 类需含结构化索引、关键文件路径、架构决策原因与对比表。第四步添加依赖提示,用 Prerequisites 明示所依赖的其他技能,便于 OpenSpace 在派生新技能时理解组合关系。第五步保存前校验:frontmatter 为合法 YAML、name 与目录一致、代码块可复制运行、无失效引用、description 足够具体。

演进机制:所生成技能支持 FIX(API 或代码模式变化时原地更新)、DERIVED(新面板需要类似服务时派生专用版本)、CAPTURED(执行中发现新模式时捕获为新技能)。初始技能质量越好,演进出的后代技能越好。限制:资料未提供安装命令、收费、价格或平台支持等细节。