Ask Yak 是 YesYak 流程中的一个只读导航技能,面向不熟悉该流程、希望用一次提问就找到下一步的用户。它的核心作用是读取项目当前状态,告诉用户工作处在 YesYak 流程的哪个位置,并列出后续步骤。
主要能力与工作方式:
- 只读运行:仅执行读取类命令,如 git status、git log、git branch、git diff --name-only、gh pr view 或 glab mr view,以及 python3 运行 scripts/check_yesyak.py 和读取文件;明确不修改任何文件。
- 定位任务标识(slug):先看分支名,再看分支 diff 中的文档,最后看 .scratchpad/。
- 确定流程位置:按 references/process.md 中的状态信号从强到弱检查,以最强信号确定位置,同时列出找到的其他信号但不使用它们,并核对冲突表。若 git 缺失或 gh 失败,说明哪些信号无法读取,并依据其余信号作答。若什么都没找到,则展示入口表并提一个问题:feature、bug、resume、one task 还是 customize。
- 读取调整项:在项目根目录运行本技能的 scripts/check_yesyak.py,其 active: 行表示适用的调整,包括额外指令(add)、替换段落(replace)或关闭某个技能(off)。若报告问题或无法运行,会如实说明;问题修复前不应用任何调整。
回答格式:
- “You are here”:用流程图标出当前阶段(●)和之前已完成阶段(✔),例如 3 Make it work, step 3 of 7(progress.md)。
- “Next”:给出下一步骤及后续全部步骤顺序,可选步骤用括号标注,带 add 或 replace 的技能后标“(adjusted)”,带 off 的技能省略。
- “Adjusted”:列出每个调整技能、模式与范围。
- 说明是哪个信号确定了位置(放在括号中)。
- 以一个问题结束:“start the next step now?”
使用限制:它不会启动下一个技能;回答使用用户的语言,但技能名、文件路径和命令保持原样;必须先阅读 references/process.md。它不改变项目状态,只提供定位与建议。