SuperAPI AI 工具集

semantius-skill-maker

智能体与模型

查看项目

更新于 10-16 09:55

技能介绍

用途:读取 semantic-model-analyst 产出的 *-semantic-model.md 文件,生成一个任务感知的 Agent Skill,补充通用平台技能无法知道的领域知识(实体、生命周期、标签规则、跨 FK 不变量)。生成的技能不重复 use-semantius,而是叠加其上。

主要能力:输出符合 Agent Skills 格式的单个文件夹,含 SKILL.md(带 YAML frontmatter,供 agent 运行时加载)与 README.mdx(供人类浏览目录);references/ 与 scripts/ 仅在有对应 JTBD 时生成,用于保持 SKILL.md 精简。SKILL.md 自包含跨切面事实(术语表、枚举、配方),模型文件仅作为 frontmatter 中的来源元数据(semantic_model 使用 system_slug)。文件夹名与 SKILL.md 中 name 一致,system_slug 转为 kebab-case。

使用方式:输入 MODEL_PATH(绝对路径),先加载 use-semantius 参考(SKILL.md、data-modeling.md、crud-tools.md、cube-queries.md)以保证配方为有效 CLI 调用,再解析模型并生成文件。技能根目录优先取模型文件位置向上查找的 .claude/skills/,否则 ~/.claude/skills/;两者都存在时询问用户,默认项目根。

版本与限制:EXPECTED_MAJOR = 3,仅接受主版本为 3 的模型文件;较旧或缺失版本需先用 analyst 迁移,较新需先更新本技能。需遵守写作约定(美式拼写、禁用 em-dash、确认提示用单数主语语法),README 的 front-matter description 不超过 140 字符且不得含 "this skill",标题须含 "Skill"。实体标签需对称(如 Product / Products),不对称视为模型缺陷并退回修复。权限目录以 §2 表格为准,conditional_permissions 中权限代码若不在表内则拒绝生成。资料未提供具体收费、价格与平台兼容性细节。