用途:配合根技能 twg 使用,回答“该让谁参与、为什么是他、以什么角色参与”。不要把一个宽泛话题直接当成某个确切产品。
角色分类:需区分声明负责人(对某实体或领域正式负责)、运营负责人或维护者(负责当前交付或运行)、专家(在某工作流有来源支撑的深度)、评审人或被咨询方(评估或建议但未必决策)、审批人或决策权人(可授权具体请求或决策)、升级或工程负责人联系人(领导责任工程组织或可转派未决请求)、知悉相关方(受决策影响但不负责)。
先定范围再定人:对模糊话题,用一次有边界的 twg rovo search "<topic>" --app confluence 与一次有边界的 twg work search "<topic>" 对比,把同名结果归入不同倡议、平台、领域、功能、团队簇;在给人排序前先补全 2-5 个核心章程、路线图、服务、项目或在办工作流。来源冲突时展示备选范围或询问用户。对稳定的项目、目标、组件、服务、工作项、页面或仓库,直接使用该引用。
查找责任与权限:用 twg responsibility get <reference> 查声明负责人、团队、维护者、审批人、评审人或升级角色;仅当声明责任缺失或用户要求基于证据的候选时,用 twg responsibility infer <reference>,并保留置信度、原因码、证据窗口及声明与观察状态。推断主要依据有界搜索、声明角色和补全的工作证据;组织数据可选,不因其不可用而阻塞或削弱流程。
组织数据已连接且已知候选领导或经理时,优先用最窄的有用树:org-tree 表层级,work-tree 表跨面广度,workitem-tree 表 Jira 工作,pr-tree 表 PR 作者/评审。树计数可验证覆盖范围和组织范围,但本身不证明专长、所有权或审批权。
审批请求:检查定义决策的产物,如项目或目标所有权、Jira 工作流/审批人字段、章程、决策记录或责任团队;分别说明谁可建议、谁必须被咨询、谁可批准。绝不把活跃贡献者提升为审批人。升级时先给最近的经验证负责人;仅当负责人缺失、受阻、跨团队或请求需要组织权限时,才加入工程领导。
仅在范围与人员角色确定后需要扩展关系或依赖时,才用 twg-context-discovery,它不是责任问题的默认路径。
证据与输出:强证据包括明确所有权、责任角色、工作流权限、章程/路线图领导、服务所有权、持续决策或反复的核心贡献;个人简介文本、组织邻近、单份文档、原始活动或自撰更新本身属弱证据。话题/专家地图最多返回五个工作流、每个工作流一名主要专家,除非用户要求更多;只有跨工作流证据时才指定总负责人。审批或升级请求需返回建议联系人、角色、范围、证据、置信度、为何合适及建议问题或联系话术;权限未确认时要说明。当再搜索不会改变范围、角色、权限、升级、置信度或建议联系人时停止。
CLI 启动回退:运行 twg <command>;若 shell 报 command not found,macOS/Linux 用 $HOME/.local/bin/twg,PowerShell 用 $env:LOCALAPPDATA\Programs\twg\bin\twg.exe,然后告知用户把该目录加入 PATH。不要把认证或命令错误当作 PATH 失败。