twg-status-rollups

twg-status-rollups

与根目录的 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 故障。

适用场景

• “我／团队／组织做了什么？”，周报、站会、交接，或离开一段时间后重新开始工作
• “项目／目标／主题／重点领域的状态”
• “这个项目准备好发布了吗？”或 go/no-go 简报
• 领导层、月度、年度、周期、绩效评估或目标对齐报告
• 组织瓶颈、优先事项、过时目标或项目风险

首要步骤

检索前先确定范围：

• 人员／团队／组织：确定身份、名册或组织树分组。
• 项目、目标、重点领域或主题：确定原生键、ARI、URL、名称或中心页面／工作项锚点。

确定时间范围。如果未提供，且精确度很重要，则询问；否则使用近期且有明确界限的时间范围，并说明该范围。个人总结的时间跨度不超过一年。

树路由矩阵

• pr-tree：按经理或团队查看已合并／未合并的 PR、评审、已交付工作或代码仓库进展。对受 PR 约束的证据，默认使用此项。
• org-tree：经理链路、名册和汇报结构；仅用于分组，不是交付证据。
• workitem-tree：按组织树查看 Jira 问题负载以及进行中／已完成的变动。
• work-tree：跨 Jira、PR、目标、项目、文档和视频的组织级计数。不适用于仅询问 PR 或仅询问 Jira 的情况。

快速路径：基于 PR 的领导层汇总

针对基于 PR 的领导层问题：

1. 保留请求的范围和时间窗口；对于“过去 2 周”，使用 --since 14d。
2. 首先使用 pr-tree。它按汇报树中的 directReports 分组；仅在需要层级背景时添加 org-tree。
3. 如果不确定选项格式，在调用数据前检查 twg help describe "pr-tree"；不要试探不兼容的标志组合。
4. 先获取计数，然后最多进行一次受支持的抽样／完整抓取，以获取代码仓库或主题证据，并在经理／团队层面进行综合。不要为填充分组而逐人查询；只有当重要主题缺少佐证时，才添加一次有针对性的 PR 补充查询。
5. 仅在有明确缺口时添加一个次要数据面。

目标为 2-4 次调用。

证据策略

• 让证据与提示词中的约束相匹配；关于已合并 PR 的结论需要 PR 证据。
• 在树数据面上先获取计数；仅当需要说明主题、风险或负责人归属时，才补充抓取示例。
• 先对宽泛列表排序，再进行最少量的补充抓取。
• 一次调用补充抓取已排序的集合，不要逐项调用：goals get、projects get、focus-areas get、jira workitem get、docs get 和 pull-requests get 均可一次接收所有键或 URL。
• 区分作者交付、评审、协调和影响力。
• 证据充分时即停止。遇到两次相同的后端故障后，停止使用该路径并报告缺口。

操作卡片

个人或个人工作更新

确定人员后，提取近期 Jira 工作、PR、文档／页面、会议以及项目／目标参与情况。加载 references/personal-work-summary.md，遵循其中关于主题、通知、PR 补充抓取和以结果为先的规则。分别说明交付、评审、文档／策略、协调和影响力。

短时间窗口的个人工作更新／站会

加载 references/personal-work-summary.md。确定人员，保留请求的项目和时间窗口，优先呈现重要工作，并区分证据缺口与已确认的阻碍。

团队或组织领导层报告

首先确定组织树。组织项目：twg projects query --scope org --include-inferred（[Paid: Enriched]）。对结果分组；补充抓取影响进度、阻碍或所有权的异常项。

项目或目标状态

首先获取原生项目／目标，包括负责人、状态、更新、链接、日期和最近情况。仅补充抓取风险、进度或依赖关系的证据。

决策就绪度 / 是否继续

加载 references/decision-readiness.md。先解析原生项目或决策锚点，并将明确链接作为范围边界。识别各项关卡，然后给出决策或建议，并说明置信度、缺口和变更条件。不要推断负责人。

主题状态

解析/搜索一次，选定核心项目、目标、页面或工作项锚点，然后先补充这些锚点的信息，再进行广泛的工作/活动查询。

参考资料

• references/personal-work-summary.md - 站会、同步会议和更广泛的个人状态证据
• references/decision-readiness.md - 跨领域的是否继续决策及审批证据

评估 / 绩效证据

解析人员和时间范围。分别说明交付、评审、协作、文档/策略、项目/目标影响和利益相关者信号。避免仅按数量排名；对薄弱证据加以说明。

输出格式

• 首先提供执行摘要，包含 3-6 条高信号观察。
• 使用表格列出负责人/团队/工作流、正面信号和风险信号、当前重点、置信度及证据。
• 按影响和负责人排列风险。
• 说明置信度和缺口：更新过时、覆盖不全、ACL 缺口或抽样范围限制。

反模式

• 不要罗列每一项资料。
• 不要仅根据问题数量推断目标/项目的健康状况。
• 如果按经理/团队分组就能回答问题，不要按组织成员逐一展开。
• 不要将搜索摘要作为状态或风险的最终证据。
• 汇总明确合并/未合并的 PR 时，从 pr-tree 开始，不要从其他树开始。