twg-agentic-search

twg-agentic-search

与根目录中的 twg 技能配合使用。确切的命令语法以实时的 twg help 为准，尤其是在筛选或输出选项相关时，请查看 twg help describe "rovo search"。

CLI 启动器备用方案

运行 twg <command>。如果 shell 提示 command not found，则使用 $HOME/.local/bin/twg （macOS/Linux）或 $env:LOCALAPPDATA\Programs\twg\bin\twg.exe（PowerShell），然后 告知用户将该目录添加到 PATH。不要将身份验证或命令错误视为 PATH 故障。

工作流

1. 将请求归类为模糊的内部研究或跨产品内部研究。当信息来源不明确、需要了解公司当前知识，或答案可能涉及 Confluence、Jira、Drive、Slack、Bitbucket、GitHub 或其他已连接 Rovo 的应用时，优先使用此技能。
2. 确认或推断 Atlassian 站点。仅当没有已配置或明确指定的站点，且歧义会影响搜索时才询问。
3. 如果应用或来源的可用性会影响计划，运行 twg rovo list-apps -o json。根据返回的内置应用、连接器、就绪状态和身份验证／设置操作确定搜索范围；除非用户要求，否则不要启动设置或登录。
4. 从一条查询开始，将具体主题与所需的资料或决策类型结合起来。如果首批结果混杂不同范围、缺少一手来源，或未覆盖所需的时间信号，最多进行一次聚焦于权威来源或近期更新的细化搜索。不要针对主要查询已返回的每个候选项分别搜索精确标题。
5. 有策略地选择筛选条件。默认使用 Confluence 和 Jira 内置应用查找官方／内部知识。只有在有用且可用时，才扩展到 Slack、Google Drive、Bitbucket、GitHub 或其他连接器。使用应用、类型、时效性、所有者／贡献者／经办人／报告人／状态、仅标题、标签／空间和站点筛选条件，在缩小证据范围且不排除可能答案的前提下进行筛选。
6. 限制搜索输出：

twg rovo search "<query>" --output json --output-summary auto --agent-fields @compact
twg rovo search "<query>" --output json --output-summary auto --agent-fields @evidence

使用 @compact 初筛候选项；当需要更多片段、URL 和来源信息时，使用 @evidence。

证据规则

• 将搜索片段视为候选线索，而非事实。
• 在给出最终结论前，先获取一小组多样化的一手来源。查找文档时，应覆盖不同角色的资料，例如需求、架构／设计和当前交付情况，而不是重复的页面。使用产品原生命令，例如 twg confluence content get、twg jira workitem get、 twg jira workitem query、twg bb pull-requests get <id>、 twg bb repo get，或适用于结果 URL／类型的相关产品命令。
• 查找文档或 PRD 时，从上述不同角色中最多选择五个来源。除非存在重大冲突需要第二个来源，否则每个角色获取一个来源。确认各角色、当前交付情况和重要冲突均有依据后即可停止，即使搜索返回了更多候选项。
• 优先选择官方空间、归属明确的项目页面、当前 Jira 事项和近期决策记录，而非个人草稿或过时的聊天提及；除非用户明确要求非正式信息。
• 对比已获取证据中的冲突、时效性、所有权和权威性。
• 对于可通过产品原生 URL 或 ID 获取的候选项，不要重新运行 @evidence 搜索；也不要以另一种视图重复获取同一来源。 应指出 ACL 限制、不可用的连接器、召回率低和未解决的矛盾，而不是将其简化成单一结论。

输出

开头直接给出答案或证据最充分的结论。引用已获取来源的标题／URL，并在可用时注明来源应用、日期或状态，以及信任该来源的原因。将已确认的事实、可能的解读、冲突和信息缺口分别说明。