Query Repository
按照“定位仓库 → 获取最新远程分支 → 读取约束 → 搜索证据 → 验证结论 → 带来源回答”的顺序执行。直接查询远程跟踪分支的 Git 对象,不创建 worktree,不切换或修改本地分支,也不读取当前工作区文件作为仓库证据。
定位仓库
按以下顺序确认目标:
- 使用用户明确提供的仓库路径。
- 使用当前运行环境明确提供的 workspace 根目录,在
<workspace>/repos的直接子目录中,将用户给出的名称与仓库根目录名、origin仓库名精确比较。 - 当前目录位于 Git 仓库时,使用同样的精确比较。
比较时可忽略大小写和末尾的 .git,不做部分匹配,不因为代码内出现仓库名就认定候选。不扫描整个用户目录、磁盘或未向 Agent 公开的路径。不在输出中显示完整 remote URL。
如果运行环境没有提供 workspace,不根据 Agent 产品名或常见路径猜测。使用 git -C "$REPO_PATH" rev-parse --show-toplevel 确认目录是 Git 仓库。候选为零个或多个时,只请求用户补充仓库路径;不猜测、不自行选择、不克隆仓库。
获取最新远程分支
要求仓库存在 origin。用户指定分支时使用该分支;未指定时使用 main,不继承本地当前分支。
使用 Skill 自身目录中的脚本自动 fetch 指定远程分支的最新提交,并解析远程快照:
"{baseDir}/scripts/prepare-query.sh" "$REPO_PATH" "$BRANCH"
用户未指定分支时省略第二个参数:
"{baseDir}/scripts/prepare-query.sh" "$REPO_PATH"
脚本显式将 refs/heads/<branch> fetch 到 refs/remotes/origin/<branch>,不依赖仓库现有的 fetch refspec。脚本输出 REPO_ROOT、BRANCH_NAME、QUERY_REF 和 COMMIT_ID。QUERY_REF 固定指向刚 fetch 的远程分支最新提交;后续查询只针对该 ref,不使用本地分支或工作区文件。
fetch 运行前遵守宿主 Agent 的网络与权限规则。认证、网络、fetch 或远程分支校验失败时停止并报告;默认的 origin/main 不存在时要求用户指定分支,不猜测 master 或其他分支,不回退到可能过期的本地内容。
读取仓库约束
先读取运行环境已提供的全局约束。然后用 git ls-tree 在 QUERY_REF 中定位适用的 AGENTS.md、AGENT.md 和仓库文档,并用 git show "$QUERY_REF:<path>" 读取。遵守其中的访问、敏感信息和生成文件约束。
只执行读取、搜索、Git 元数据检查和 fetch。不编辑代码,不安装依赖,不执行 checkout、switch、merge、rebase、reset、pull 或 worktree 操作。
搜索与取证
使用 git -C "$REPO_ROOT" grep -n -I -e '<pattern>' "$QUERY_REF" -- 在远程快照的 Git 跟踪文件中搜索用户原词,再根据仓库的命名与技术栈扩展为直接相关的中英文同义词、类名、字段名、配置键和文件名。用 git show "$QUERY_REF:<path>" 读取文件;需要稳定行号时将内容传给 nl -ba。
从命中位置追踪到数值或规则的源头,同时检查它的使用位置、覆盖关系和适用条件。区分:
- 直接定义的常量或配置值。
- 需要计算、累加或条件分支才得到的值。
- 运行时由服务端、远程配置或外部数据提供,无法仅从当前仓库确定的值。
不把注释、测试样例、过期文档或生成产物中的数值单独当作最终结论。证据冲突时,继续追踪实际读取链路;仍无法确定时报告冲突,不自行选值。
回答
先给出直接结论,再列出最小必要证据。说明实际查询的远程分支和 commit ID。对每个关键结论提供仓库相对文件路径、符号或配置键、该快照中的行号,并简要说明推导过程。
如果只能确定部分结论,明确区分“已确认”和“无法从当前仓库确定”。如果没有找到证据,说明已检查的关键范围和缺失的信息,不用常识或相似项目补全答案。不回显凭据、私有地址、完整 remote URL 或与问题无关的仓库内容。