SuperAPI AI 工具集

ask-skills

编程与开发

查看项目

更新于 10-18 16:13

技能介绍

Ask Skills 是一个技能路由工具,用于帮助用户判断当前情况适合使用仓库中的哪个技能或流程。它的核心用途是:当用户不记得每个技能的具体作用时,可以通过询问来获得指引。

主要能力

  • 技能路由:根据用户所处情境,推荐合适的技能或流程。
  • 流程导航:定义了从想法到交付的主流程,以及多条独立技能路径和入口流程。
  • 上下文管理指导:提供上下文卫生建议,帮助用户在会话中保持高效推理。
  • 阶段边界决策:说明在阶段边界处的五种选择(继续、清空、交接、子代理、压缩),并引用 PHASE-BOUNDARIES.md 获取详细决策树。

使用方式

用户通过询问来获取技能建议。工具会引导用户阅读相关技能的 SKILL.md 以了解具体功能。主流程包括:

  1. /grill-with-docs:通过访谈打磨想法,在有工作目录时使用,保留 GLOSSARY.md 和 ADR。
  2. /handoff 与 /prototype:当问题需要可运行答案时,通过原型回答,并用 /handoff 桥接。
  3. /to-spec 和 /to-tickets:多会话构建时,将讨论转为规格并拆分为工单。
  4. /implement 或 /implement-spec:按工单逐个实现或一次性实现整个规格。
  5. /review-axes:对差异进行双轴审查(标准与规格)。
  6. /pr:塑造 PR 正文。
  7. /retro:回顾构建过程,建议改进代理环境。
  8. /archive-feature:完成实现后归档功能。

此外还有入口流程 /wayfinder(大型模糊项目)、代码库健康维护 /improve-codebase-architecture 和 /tech-debt-map,以及多条独立技能如 /grill-me、/grilling、/research、/frontend-handoff、/to-questionnaire、/wizard、/wait-what、/traduzir、/writing-for-agents、/review-mr、/delegate-tickets 等。

适用场景

适用于使用该仓库中技能进行软件工程工作的用户,包括需求梳理、规格编写、工单管理、代码实现、代码审查、回顾改进、代码库架构维护等场景。

限制

  • 技能的具体功能需阅读对应 SKILL.md,摘要仅用于定位。
  • 部分技能有使用前提,如 /grill-with-docs 需要有工作目录。
  • 上下文窗口有限(约 150k tokens 的智能区),接近时需使用 /compact。
  • /delegate-tickets 仅运行 Standard 和 Light 工单,遇到 Heavy 工单或无 Difficulty 行会停止。
  • /archive-feature 不适用于远程跟踪器。
  • 首次使用工程流程前需运行 /setup-skills 配置。
  • /setup-solid 为可选,每个仓库运行一次。