twg

twg

对于需要 Atlassian 或公司背景信息的请求，运行 TWG；不要只推荐它，也不要让用户自行运行。从一个具体的锚点开始：Jira 编号或 URL、页面、人员、项目、目标、仓库或时间范围。根据只读命令结果作答。如果路由不明确：twg help <terms>、twg help describe <path>、twg help discover-skills "<intent>"。

概览

加载最精简的配套技能，然后使用其 TWG 路由：

• ../twg-jira/SKILL.md 用于 Jira 工作项、项目、看板、冲刺和写入操作。
• ../twg-confluence/SKILL.md 用于 Confluence 内容、空间和内容撰写。
• ../twg-space-creation/SKILL.md 用于创建或克隆 Confluence 空间。
• ../twg-status-rollups/SKILL.md 用于项目／目标状态、发布／是否上线就绪情况，以及组织／领导层汇总；处理 PR 前应先使用此技能，而非 ../twg-engineering-work/SKILL.md。
• ../twg-context-discovery/SKILL.md 用于依赖关系图、仓库和休假期间的工作追踪。
• ../twg-agentic-search/SKILL.md 用于使用 Rovo 进行深入的内部研究。
• ../twg-responsibility-routing/SKILL.md 用于负责人／主题专家、审批人和升级处理。
• ../twg-engineering-work/SKILL.md 用于代码／仓库发现、PR 和贡献者。
• ../twg-jira-resolve-merged-work/SKILL.md 用于处理已有合并 PR 的过期 Jira 工作项。
• ../twg-operational-health/SKILL.md 用于事件／值班、交接、Assets 和风险。
• ../twg-bench-lite/SKILL.md 用于只读的单提示词 A/B 对比。
• 仅在用户点名或要求补充代码审查背景时使用 ../twg-code-review/SKILL.md。

调用与输出

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

除非用户要求，否则不要为每条命令添加环境变量前缀；主机可能会设置 TWG_AGENT_DEFAULTS=1。

如果存在 stdout_inline，应优先使用。在基准测试通道之外，仅当内联证据不完整时检查 output_files.compact；完整 stdout 是最后手段。

在仅限 TWG 的基准测试通道中，只运行 twg。绝不要使用 shell 实用程序或管道 （jq、rg、date）。使用紧凑／内联输出、提示词指定的时区和时间范围，并报告信息缺口。 根据意图选择最精简的配套技能。由该技能决定类型化路由。

身份验证／设置防护

除非用户明确要求设置／身份验证／修复，否则不要运行设置、登录、安装、升级、维护或凭证相关命令。 否则应说明补救措施，并等待用户指示。

沙盒化管道日志

管道日志可能会重定向到 S3。如果沙盒化的 twg bb pipeline get、wait、grep 或 tail 日志请求显示网络受阻消息、S3 主机名，或仅日志请求出现 HTTP 403，而元数据请求成功，则这是沙盒限制，并非身份验证失败。只请求对该命令进行获准的非沙盒重试，或向用户提供准确的终端命令。绝不要索要凭证。

有界证据循环

1. 对锚点分类：人员、团队、项目、目标、工作项、页面、仓库、服务或资产。
2. 解析一次；获取会改变状态、风险、决策或行动的证据。
3. 对候选项排序，使用一次批量调用补充详情，然后综合整理。
4. 首次遇到策略拒绝后停止；相同的身份验证、ACL、契约或后端错误出现两次后停止。

批量读取

每个实体单独调用一次，是代价最高的错误：每次调用都会重新提交整个对话。当 get 接受重复标识符时（实时帮助中标记为“一个或多个”），请在一次调用中传入整个集合，并使用 --agent-fields @compact，每次约 20 个 ID。否则，请通过查询或树形路由（... query、pr-tree、work-tree、workitem-tree、org-tree、context）获取答案，而不是逐个加载实体；也可以加载排名靠前的样本，并说明省略了哪些内容。批量调用前先选好投影；为了更改 --agent-fields 而重新运行批次，会让整个集合重复付费。使用不同 ID 连续调用同一子命令 5 次后，应停止并改用其他路由。

命令发现

• 使用 twg rovo search "<topic>" [--limit <n>] 进行 Top-K 发现；显式指定 --app 会执行预检。
• Trello：twg trello search "<query>"；不限定工作区范围。
• 显式指定 Rovo 的 --app 前，先运行 twg rovo list-apps -o json；遵循返回的身份验证操作。
• 活动历史和模糊发现是独立的入口：
  • twg docs query --since <duration> 查询用户文档活动，不用于按标题／内容搜索。
  • twg work query 默认查询最近 7 天内由本人创建的工作；其他活动需使用 --activity / --include-viewed。
  • twg docs search "<topic>" 用于模糊发现文档；twg work search "<topic>" 用于在整个租户中发现工作项。
  • 切勿将主题文本传给 docs query 或 work query；请使用相应的搜索命令。
• 解析 URL、键、ARI 和名称，然后加载稳定 ID。
• Jira：使用 jira workitem search <text...> 进行模糊文本搜索，使用 jira workitem query --jql 执行结构化 JQL 查询，使用 rovo search <text...> --app jira 进行语义搜索。
• 命令格式限制：
  • work query 使用 --scope me|user，绝不使用 --scope global。
  • 推断团队（ari:cloud:graph-store::inferred-team/...）需要显式指定 --include-inferred；参见 references/inferred-teams.md。
• 使用 search-code；省略 --app，以搜索所有可用的已索引 SCM 入口；仅将 --repo 用作发现锚点；如果命中的是生成文档或结果不完整，则扩大搜索范围。

资产／CMDB 图谱

遍历（对象↔所有者／团队、Jira↔对象）→ assets graph；参见 references/ASSETS_GRAPH.md。不需要跳数时 → assets search、assets query --aql、 assets object get。

加载最精简的配套内容

参见概览。

规则

• 切勿猜测 ID、标志、slug、ARI 或变更契约。
• 执行写入操作时，加载产品技能并遵循实时帮助。
• 除非用户要求检查本地状态，否则避免检查本地内容、缓存或探测架构。
• 执行写入操作时，读取当前状态并说明变更内容，除非用户要求执行。