用途:配合根命令 twg 使用,围绕代码与 PR 处理工程类查询,包括代码搜索、查找使用某 API 或包的仓库、实现与反向依赖发现、PR 状态与评审、以及基于 PR 的个人/团队状态汇总。使用时应遵循文档给出的命令形制;仅在命令、参数或输出契约缺失或不确定时,用 twg help 局部确认。
主要能力:解析工程锚点(仓库、PR、Jira 工作项、主题、代码符号);提供评审队列、陈旧评审与评审瓶颈分析、issue 关联 PR、仓库贡献者与热点区域、基于 PR 的状态汇总。提供商原生 PR 命令仅适用于其宿主环境,Bitbucket 的活动/评论/任务命令不适用于 GitHub PR。
使用方式:CLI 调用 twg <command>。若 shell 提示命令未找到,可尝试 $HOME/.local/bin/twg(macOS/Linux)或 $env:LOCALAPPDATA\Programs\twg\bin\twg.exe(PowerShell),并告知用户把该目录加入 PATH;认证或命令错误不等同于 PATH 故障。批量水合 PR 集合,避免逐个 PR 调用;需要代码搜索时加载 references/code-search.md;需要代码评审上下文时使用 ../twg-code-review/SKILL.md;涉及个人或组织范围汇总时结合 twg-status-rollups。
适用场景:查询等待自己评审的 PR、API 实现或使用位置、依赖某包的仓库、某 issue 的最新 PR、仓库或主题的主要贡献者、周内自己提交的 PR、陈旧评审与评审流程瓶颈、某用户或团队或仓库的 PR 状态、进行中 PR 关联的开放缺陷或任务。
限制:只有评审与评论时间戳需要逐 PR 调用 bitbucket pull-requests activity,超过约 10 个 PR 时应抽样并说明;不带 --type 会同时返回审批、更新与评论事件,不应按事件类型重复调用。管道查询仅列最近运行,默认 --limit 15,需提高并核对时间戳。仅为陈旧、阻塞、核心或高影响 PR 水合评论、任务、管道与 diff。若 PR 图或仓库级查询反复失败,可做一次更窄的降级查询,并说明 PR 覆盖缺口。不要猜测 Bitbucket 工作区或仓库,不要把 PR 数量当作影响力,不要把 Bitbucket、GitHub 与 Atlassian 的认证故障混在一起。其他细节资料暂未提供。