workspace-search-with-citations

用途

Workspace Search with Citations 让 Ragbot 的三层记忆检索结果可被模型像使用研究图书馆一样使用：提问、取回带出处（页码/字符范围）的段落，再基于这些段落回答，必要时引用原文，并始终回指来源。该技能存在的理由是：没有引用的检索与幻觉无法区分。"部署使用 Cloud Run"这样的回答只有在读者能验证时才有用，验证路径就是引用——哪个文档、哪段字符范围、该段落实际说了什么。模型对每条事实性陈述都欠用户这条路径。

何时适用

用户问题依赖工作区内容（笔记、代码、经验、项目上下文、既往决策）。
用户问"X 在哪里说的？"或任何明确要求引用的变体。
用户要求基于多个文档的摘要或综合。
用户追问先前回答，且答案需保持在同一批来源上。

何时不适用

问题属于工作区无法合理回答的通用知识（数学、定义、公共领域事实）。模型凭训练作答并说明。
问题属程序性任务且由其他技能处理（如文档已内联给出时的 summarize-document）。
用户明确要求模型的观点、草稿或生成内容——此时应对应 draft-and-revise；但草稿内的事实性骨架仍应带引用。

使用方式（四步协议）

该技能是一个四步循环，每步单一职责，不应跳步或压缩，因为跳过步骤正是不扎根回答的来源。

从问题中识别可检索的论断：调用工具前，先确定要答好需从工作区获知什么；把复合问题拆成底层事实子问题。例如"staging 部署用的模型和 prod 一样吗？"拆为"staging 用什么模型？"和"prod 用什么模型？"——两次检索而非一次。拆解不明显时在回答中说明，让用户看到检索策略。
用聚焦查询调用 workspace_search：每个子问题一次调用，而非一个巨型查询；混合检索器对聚焦查询的 top-k 结果更好，巨型查询会稀释信号。k 参数在覆盖率与延迟间权衡：多数查询用默认 10；问题狭窄且正确命中大概率靠前时降到 3–5；用户明确要求全面扫查（"工作区关于 X 的所有内容"）时升到 20 以上。当检索零命中或仅弱命中（最高分低于 0.3），说明工作区没有可信答案，应如实说明而不是编造，例如"未在工作区找到关于 X 的相关内容，最接近的是关于 Y 的文档，不能直接回答该问题。"
先阅读命中再组织答案：每个命中返回分块文本，模型需阅读，不能假定分块内容如其标题或文档标识所示。需避免两种常见失败：其一，引用并不真正支持该论断的命中（虚假引用，比无引用更糟，因为它把模型的置信度转移到并不认同的来源上）；其二，引用分块文本却未检查分块中上下文句是否会推翻该引用（分块是摘录，脱离上下文的摘录可能反转含义）。命中含糊时说明，命中贴切时使用。
带行内引用组织答案：每条来自命中的事实性陈述都在行内归属，采用紧凑格式，括号内含文档标识与字符范围，例如："staging 环境使用 claude-sonnet-4.6 [deploy-config.yaml:142-167]。生产在同一修订上运行同一模型 [deploy-config.yaml:142-167; release-notes.md:88-95]。"多个命中支持同一论断时，在同一括号内逗号分隔列出。若模型给出自己的综合（非直接引用），仍须归属底层事实；综合论断本身不需引用，支撑事实需要。若不确定或命中相互矛盾，应在答案中显式呈现，例如"部署配置列出模型 X [...]；发布说明描述模型 Y [...]；差异引入于 2026-04-12 的发布提交。"呈现分歧比任意挑选单一来源更有用。

输出格式

默认为带行内引用的散文。用户要求结构化列表时（"列出 staging URL 出现的每个位置"），输出表格或项目符号列表，每行一个命中，引用单独成列。引用是强制的：断言来自工作区的事实却无引用即为缺陷；若支撑命中较弱（低分、含糊分块），在引用之外还需说明。

边界情况

无相关命中：明确说明，不得用训练数据合成答案并当作工作区答案。
多工作区命中：跨工作区 fan-out 返回的命中带 source_workspace 标签，引用时在括号内写明工作区名。
冲突命中：呈现冲突，不静默取舍，由用户决定哪一来源取代另一来源。
过期命中：命中涉及日期或版本而用户问当前状态时，注明日期，如"据最后更新于 2026-03-22 的部署配置 [...]，模型为 X；若此后部署已变，此引用即过期。"

与其他技能的配合

summarize-document 在摘要工作区文档时消费本技能的引用。
fact-check-claims 以本技能的检索作为每条论断的证据基础。
agent-self-review 检查引用是否齐全、是否真正支持所附论断（扎根性评分项）。

四个技能可单独使用，配合更强：检索为草稿扎根，草稿被事实核查，核查经自我审查，循环闭合于用户可端到端验证的回答。

限制

该技能依赖 Ragbot 的 workspace_search 工具与三层记忆结构；资料未提供具体安装命令、配置参数、支持的模型版本或价格信息。具体工具接口、k 参数以外的检索调优选项及跨工作区行为细节，以实际产品为准，资料暂未提供。