用途:回答“现在最该做哪一件事、为什么”,并给出一个推荐 issue 后停止,由调用方认领和执行。技能本身严格只读,不认领、不评论、不关闭。
主要能力:通过 forge issue stats --json 获取 open/done/cancelled 计数、ready_count、blocked_count 与 active_claims;通过 forge issue ready --json 获取按 rank(优先级升序、再按 id)排序的就绪队列,每项含 id、title、type、priority、rank、blocked、claimed_by、parent_id、labels、dependencies;通过 forge issue show <id> --json 拉取完整记录,用一句话说明为何就绪(优先级/排名、依赖已满足、未被认领、可认领类型);通过 forge issue blocked --json 指出候选项被哪个具体未满足依赖阻塞。
使用方式:先取脉搏,再排序就绪队列,默认取排名第一,解释原因,说明其余为何不就绪,最后只推荐一个 issue 并附一行理由。就绪是派生读模型,每次会话都应重新运行 forge issue ready,不要信任缓存的 status == ready。不要使用 forge board,它读的是旧快照存储,可能过期或错误。
适用场景:Forge 项目中的日常分诊、站会视图、判断瓶颈是依赖修复还是新工作。
限制:epics 和 decisions 永不进入就绪队列,不可作为工作交接;CLI JSON 中没有 claimable 字段,可认领类型是行为约定而非可读标志;每个 --json 回复带 ok,ok:false 时读 error.message 并重试;本技能只运行 stats/ready/blocked/show,需要修复时交接,绝不在此修改。可调参数包括就绪查询过滤、展示条数(默认前 3)、陈旧阈值(forge issue stale --days 14)、优先级排序与阻塞解释深度。