SuperAPI AI 工具集

skill-tree-generator

通用与其它

查看项目

更新于 10-16 08:00

技能介绍

用途:为任意 JavaScript 或 TypeScript 库生成、更新并版本化一整套 SKILL.md 文件(即技能树)。生成的每个文件会被 Claude、GPT-4+、Gemini、Cursor、Copilot、Codex 及开源模型等 AI 编码代理直接读取,因此要求输出可移植、简洁且基于库的真实行为。

技能类型:每个技能在 frontmatter 的 type 字段中声明类型,包括 core(框架无关概念、配置、模式)、sub-skill(核心或框架技能下的子主题)、framework(框架绑定、hook、组件)、lifecycle(跨领域开发旅程,如 getting started、go-live)、composition(两个及以上库的集成)、security(审计清单或安全验证)。代理通过 npx @tanstack/intent list 发现技能,并从 node_modules 直接读取;框架技能通过 requires 声明对核心技能的依赖,以便按正确顺序加载。

两种工作流:Workflow A(Generate)从领域图构建完整技能树;Workflow B(Update)对比库版本变更并更新技能。

前置条件:需要 skill-domain-discovery 产出的 skills/_artifacts/domain_map.yaml 与 skill_spec.md,或库的原始文档与源码(此时先运行压缩版领域发现,但输出保真度低于完整流程)。

主要步骤:先构建概念清单(所有导出、配置键、约束、警告),按面向工作的名称归入能力领域,交叉领域与开发者任务枚举 10–20 个任务导向技能,并为每个技能提取至少 3 个失败模式。scaffold 流程先在写入任何 SKILL.md 前产出单个 skills/_artifacts/skill_tree.yaml,列举全部待生成技能。

结构与限制:根据领域图规模选择嵌套结构或扁平结构;当技能少于 5 个且无框架适配器时可走最小库快速路径,使用扁平结构与 core 类型独立技能,不建 router。小型库(少于 5 个技能)绝不应有 router 技能;15 个以上技能时 router 可选。源仓库中技能需与各包同址放置以便随 npm 分发,可用 npx @tanstack/intent@latest edit-package-json 自动配置 package.json 的 files 数组。

写作要求:核心技能覆盖框架无关概念并包含子技能注册表;子技能按 Setup、Core Patterns、Common Mistakes、References(按需)组织,Common Mistakes 至少 3 条,每条须同时满足 plausible、silent、grounded。失败模式按领域图 status 处理:active 正常收录,fixed-but-legacy-risk 加注说明,removed 不收录。框架技能只写框架特有内容,不重复核心技能中的错误。跨领域张力需写入涉及域的 Common Mistakes。版本面向具体库版本号,具体命令与代码保持原样。