SuperAPI AI 工具集

skill-creator

通用与其它

查看项目

更新于 10-16 09:47

技能介绍

用途:Skill Creator 面向 skillOverflow 的技能编写者,用于理解技能的完整生命周期,判断某个技能是否需要创建或更新,并按五阶段流程维护 SKILL.md 文件。资料中的技能基于 SAP CAP、SAP UI5 与 SAP Help Portal 文档,技能文件位于 skillOverflow/skills/<skill-name>/SKILL.md,采用扁平结构,分类通过 metadata.category 设置。

主要能力与流程。阶段一识别需求:当智能体在多次会话或多个开发者处重复出现次优模式(如使用已废弃的 CAP API、已知反模式、忽略团队约定、新 CAP 版本模式缺失、代码审查反复指出同一问题)时,应考虑技能;创建前先用 ls ~/skillOverflow/skills/ 检查是否已有技能可更新,更新通常优于新增。阶段二编写技能:使用 kebab-case 命名,frontmatter 的 description 是最关键字段,需写明触发条件与触发关键词,并用真实提示测试是否匹配。正文需含 capire 文档链接、可复制代码示例、少于 500 行,并以“常见错误”❌/✅ 对照结尾;写作应面向智能体、明确直接。阶段三写评测:评测是回归测试,提示词不能照抄技能措辞,应以开发者自然提问方式编写,并通过启停技能比较有无技能时的输出差异,至少为每个技能添加 2 个评测到 tests/skillOverflow-evals.json。阶段四检查与迭代:每次改动后运行 bash ~/skillOverflow/tests/smoke-test.sh ~/skillOverflow,并按清单人工运行评测;资料给出售价(疑为症状)到原因的诊断对照,如不触发因描述过泛、触发错误因描述过宽、忽略内容因说明过抽象、模式过时因内容未更新、技能冲突因描述重叠;新模型发布后应重跑评测,可简化或删除模型已掌握的部分。阶段五从真实使用中学习:会话结束时让智能体总结哪些模式一次做对、哪些需自我纠正、哪些假设错误、应补充什么,再把可复用的纠正写入相关技能;不要记录一次性错误、仅限本项目的纠正或 capire 已覆盖的内容。资料还提供 PR 中的会话学习模板与技能质量清单。

使用方式:按上述五阶段在 skillOverflow 仓库中创建或更新技能、编写评测、运行 smoke 测试,并在 PR 中记录会话学习。

适用场景:维护 SAP CAP 相关智能体技能、排查技能不触发或输出错误、在模型升级后精简技能。

限制:资料未提供该技能的安装命令、收费、价格、平台支持、运行环境要求或实际效果数据;技能文件示例中的代码为格式演示,实际内容需依据官方文档。