SuperAPI AI 工具集

elixir-skill-router

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

elixir-skill-router 是面向 Elixir/Phoenix 项目的技能路由组件,用途是在请求涉及多个关注点、或下一步工作流不明确时,先判断应使用哪个(哪些)专用技能,再执行对应工作流。

路由方式:多步骤请求走 playbook(TDD、bug 修复、质量、初始化、LiveView 功能、Oban 任务、迁移、PR 审查);单领域请求走原子技能(如 Ecto 查询、channel 认证、Credo 配置)。任何会产出 .ex/.exs 的工作,都需同时加载 elixir-essentials 与对应领域技能。出现歧义时先查看 mix.exs、mix.lock、routes 及邻近代码;若证据仍无法决定,只提一个范围确认问题。小 bug 可直接用 bug-fix 配合失败复现与最小修复,无需正式 PRD。

硬性门槛:在存在可运行且因正确原因(功能缺失而非配置/语法)失败的测试之前,不得写实现代码。

技能目录含八项常用技能:elixir-essentials、phoenix-liveview-essentials、ecto-essentials、testing-essentials、otp-essentials、oban-essentials、code-quality、security-essentials。完整可机读的触发→技能映射见 assets/skill-map.json;完整目录名通过已安装包注册表解析。选定技能后须先阅读再执行。

优先级规则:涉及代码变更时为 上下文与范围 → RED → 实现 → 质量 → 审查;只读审查从审查技能开始,不需要新的失败测试。多个技能适用时,路由行之后须紧跟一行简洁的优先级/链条说明。

输出规范:路由语句必须是每条回复的第一条实质行,格式如 Next skill: skills/testing-essentials,并在其后说明理由;生成产物默认使用英语,除非明确要求其他语言。

适用场景:多关注点请求、需要拆解为有序子任务、需要选择工作流。限制:单一关注点且明确对应某技能时不使用,可直接调该技能;用户明确指定技能时也不使用。若所需技能缺失,须报告限定身份、期望路径与安装修复方式,不得静默回退到通用技能。仅在宿主支持且有界独立子任务有收益时才委派。路由只有在工作流已启动或记录了具体依赖阻塞时才算完成。