twg-context-discovery

twg-context-discovery

使用根目录中的 twg 技能。通过实时运行 twg help、 twg help <terms> 或 twg help describe <path> 获取命令语法。

CLI 启动器回退方案

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

第一步

先解析锚点，再扩大范围：

• 稳定键、URL 或 ARI：若类型明确，直接使用。
• 模糊的主题或名称：先判断范围；再为 2-5 个锚点补全信息，然后排序。
• 多个同类型锚点：支持时，在一次上下文调用中批量处理。
• 命令形式未知：调用数据前先查看针对性帮助。

对于模糊主题，按范围归类高信号候选项，依据明确的章程、路线图、项目、产品或服务证据。将名称相同的功能、平台、领域、团队和计划集群分开。选择前比较范围匹配度、中心性、广度和时效性。如果仍有歧义，请展示备选项或提问。在推断专家或职责归属前先界定范围；邻近的作者身份或活动并不能证明其承担更广泛的职责。

如果某种锚点类型未注明支持上下文，请使用产品原生信息补全和搜索证据，而不要臆造路径。

对于职责归属、专业知识、审批权限、领导层联络或升级处理，请加载 ../twg-responsibility-routing/SKILL.md。仅当该工作流需要扩展关系或依赖项时，才返回此处。

路由选择

• 已知的 Jira 工作项通常需要原生工作项详情以及关系上下文。
• 项目和目标需要原生详情，以及 Jira、文档、搜索、PR 和会议证据。
• 对于主题入门，搜索知识和产品原生内容各一次。比较同名范围内的正式 epic、项目、目标和页面锚点； 来源定义的层级可以区分核心计划/平台与功能、迁移或采用工作。优先选择能关联当前交付工作和代码的锚点。 补全该锚点的信息，然后仅在能补充依赖项或人员信息时，各使用一次上下文和职责路由。最多补全三个条目。绝不要 用另一种投影重新获取同一来源，也不要在解析后尝试更多同义词。 目标为 6-10 次调用；证据足以支持各类别后就停止。
• 对于重新开始、交接或 OOO 补课，请加载 ../twg-status-rollups/references/personal-work-summary.md 并遵循其中的重新开始指南。根据关联证据推断优先级，只补全会改变用户下一步行动的锚点。
• 依赖关系图和页面/主题提示词需要先补全锚点，之后广泛搜索才能作为证据。 在指定负责人/专家前，先梳理更广泛的子领域。
• 原始图查询/调试界面不是依赖关系图的默认路径。仅当用户明确要求使用该查询语言，或类型化命令无法表达所需关系边时，才使用这些界面。

证据策略

对于核心候选项，限制来源获取和关系扩展的范围：

• 获取来源：字段、负责人、状态、正文、评论和 URL。
• 上下文：图边、正式外部链接、相关人员、团队、项目、目标、文档、PR、提交和分支。

先使用摘要详情。仅在核心锚点或最多 3 个高信号相关锚点缺少 URL、评论、正文内容或来源信息时，才升级为完整详情。

将第三方 URL 视为图节点。收集远程链接、上下文边、描述、评论、ADF 链接、裸 URL 和链接正文；保留关系方向的来源信息。

扩展规则

• 按关系角色扩展，而非按原始数量扩展。
• 当父项、史诗任务、入站同级项、阻塞项、消费者、中心页面、外部设计、PR、提交、分支、受派人、报告人、贡献者和审核者等信号会改变方向、风险、所有权或后续行动时，获取并补充这些信息。
• 通过 URL、键、ID 或 ARI 直接获取已知的旧链接，而不是盲目扩大整个关系图。
• 使用有针对性的查询变体，而不是堆砌同义词。
• 完成首次来源获取以及上下文／搜索后，暂停并对照所需输出检查证据。如果已包含负责人、状态、关系、时效性和证据 URL／键，则综合整理，而不是继续扩大范围。
• 如果上下文或基于关系图的命令两次返回相同的后端／覆盖范围错误，就不要继续探查相邻的关系图路径。记录覆盖范围缺口，并继续使用产品原生的补充证据。
• 如果下一个候选项不会增加新的实体、链接、贡献者、团队、决策、所有权、风险或后续行动，就停止。

关系图可视化

对于关系图请求，将带类型的上下文输出通过管道传给 twg visualize。保留会改变方向、所有权、风险或后续行动的实体；合并重复项。

输出格式

• 锚点快照：说明它是什么，以及为何重要。
• 对于 OOO 交接摘要，按优先级工作流和后续行动综合整理；不要添加关系表。对于其他上下文工作，包含实体、关系、负责人、重要性和证据。
• 风险和依赖项，并区分已确认的边与推断出的关系。
• 建议的后续行动。
• 证据不完整、访问受限、过时或经过抽样时，注明置信度和信息缺口。

反模式

• 不要只停留在搜索结果；应补充锚点信息。
• 不要将 stdout_shape 视为完整的实体或 URL 清单。
• 不要因为同级项看起来已“完成”，就跳过图谱／依赖提示中的同级项扩展。
• 不要仅凭标题就排除 1 跳候选项。
• 不要手动编写关系图 HTML。