SuperAPI AI 工具集

openydt-skill-maker

智能体与模型

查看项目

更新于 10-16 06:47

技能介绍

用途:这是「制作其它 openydt skill」的元技能,对标飞书 lark-skill-maker。当用户要新建 openydt 域技能(如在场车/月票/黑名单域)、把某个 openydt api <cmd> 或「查费→缴费」式业务链路封装成可复用 Skill、或规范化已有 SKILL.md(补 frontmatter、整理命令表、给写操作加 --yes)时使用。不负责实际调用业务接口,也不改 Go 命令代码(改 cmd/gen 须先改抽取器/codegen)。

主要能力:产出符合规范的 SKILL.md。目录为 skills/<skill-name>/,至少含 SKILL.md,大块内容下沉 references/。frontmatter 必填 name(与目录名一致、kebab-case)、version、description(一句 WHAT + 一句 WHEN,约 100–150 字,3–6 个有区分度触发场景,不堆砌同义词),metadata.requires.bins 声明 openydt,cliHelp 填真实帮助命令。正文固定骨架:CRITICAL 先读 ../openydt-shared/SKILL.md、何时用与意图路由、可用命令表(中文名|命令|读/写|关键参数)、业务流程、示例、错误自愈速查表、写操作幂等、结果解读要点,每条硬规则配 why。

必要用法:命令必须真实存在,来源为 cmd/gen/<域>.go 或 openydt <域> --help,或 catalog/catalog.json 中 included:true 的 interfaces;不得臆造命令名或参数。写操作(catalog readwrite:write,如缴费、开闸、发券、开通月票、加/移黑名单)一律标「写(需 --yes)」,示例先 --dry-run 预览再 --yes 实发。触发词须与既有域去重,每个裸触发短语只归一个 owner 域,其余域加限定词并写边界。示例 parkCode 用文档化测试车场(1ZS7H5PQH9 / PTD2YBBZ),时间用当前/相对时间,不照抄历史 sampleBody。

适用场景:新建 openydt 域技能、封装原子接口或多步业务流程、规范化已有 SKILL.md、跨域编排型 workflow 技能(命名 openydt-workflow-<场景>,用 ASCII 管道图描述数据流与回填字段)。

限制:正文控制在 500 行以内,命中即拆到 references/;included:false 接口属越界范围,不为它建技能;未一等化的 callable 接口用 openydt api <cmd> 兜底并指路 api-explorer;上线前须跑路由触发评测(evals/routing-evals.json,runner 为 tools/eval/routing-eval.workflow.mjs,baseline 见 tools/eval/ROUTING-BASELINE.md)。具体命令清单、字段字典与错误码详表以实际仓库资料为准,本文未提供。