gm-orient 是 gm 流程中解析单条 PRD 行的首个阶段技能,定位是在任何代码编辑发生之前完成代码搜索与代码洞察,并为后续阶段建立事实基础。
用途与输入输出:技能输入为 row=<id> 与 session=<SESSION_ID>,输出为位于 .gm/receipts/<row>/01-orient.md 的回执文件。它通过 prd-list {"id":"<id>"} 读取目标行。若该行没有验收文本,技能会自行推导:将行标题表述为一个可检查的条款,随后在代码搜索步骤中定位该条款所指的代码,并把推导出的验收内容以 acceptance (derived) 形式写入回执,同时注明条款及其来源;资料明确说明,不得因缺少验收文本而提交阻塞项。
主要能力:首先执行 codeinsight,针对行中命名的每个符号分析其调用方与影响范围。随后以双模式(实际为三通道)执行 codesearch,在一次返回中同时获得 BM25 命中、向量命中和提交(commits)通道结果;每类保留前 20 条,每条命中保留 3 行实时代码片段,片段在查询时从代码树中提取。资料指出除嵌入向量与 ID 外不存储其他内容。最后,技能把引用的文件、符号以及该行所依赖的每项事实写入回执。
使用方式:该技能应仅从 gm-prd 中调用,不应直接加载。完成本阶段后,技能会加载下一阶段:Skill(skill="gm-unknowns", args="row=<id>; session=<SESSION_ID>")。技能强调完成所请求的工作是每次运行的目标;若某步骤被问题阻塞(检查失败、工具或服务故障、缺少输入、网络或环境故障),应在同一次运行中修复:在有界或可恢复路径上重试、使用替代路径达成同一结果、在故障源头修复,然后继续剩余工作。只有在请求工作完成,或所有路径尝试后步骤仍被阻塞时才停止,并报告被阻塞步骤、已尝试路径及各自证据。
适用场景与限制:适用于 gm 工作流中对 PRD 行的逐条解析与编辑前调研。限制包括:必须由 gm-prd 触发,不可直接加载;依赖 prd-list、codeinsight、codesearch 等配套能力;资料未提供具体收费、平台支持范围或性能指标,暂未提供。