Ask Skills 是一个技能路由工具,用于帮助用户判断当前情况适合使用仓库中的哪个技能或流程。它的核心用途是:当用户不记得每个技能的具体作用时,可以通过询问来获得指引。
主要能力
- 技能路由:根据用户所处情境,推荐合适的技能或流程。
- 流程导航:定义了从想法到交付的主流程,以及多条独立技能路径和入口流程。
- 上下文管理指导:提供上下文卫生建议,帮助用户在会话中保持高效推理。
- 阶段边界决策:说明在阶段边界处的五种选择(继续、清空、交接、子代理、压缩),并引用 PHASE-BOUNDARIES.md 获取详细决策树。
使用方式
用户通过询问来获取技能建议。工具会引导用户阅读相关技能的 SKILL.md 以了解具体功能。主流程包括:
- /grill-with-docs:通过访谈打磨想法,在有工作目录时使用,保留 GLOSSARY.md 和 ADR。
- /handoff 与 /prototype:当问题需要可运行答案时,通过原型回答,并用 /handoff 桥接。
- /to-spec 和 /to-tickets:多会话构建时,将讨论转为规格并拆分为工单。
- /implement 或 /implement-spec:按工单逐个实现或一次性实现整个规格。
- /review-axes:对差异进行双轴审查(标准与规格)。
- /pr:塑造 PR 正文。
- /retro:回顾构建过程,建议改进代理环境。
- /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 为可选,每个仓库运行一次。