用途：在开始工作会话、查看项目或团队活动、理解 PR 与分支栈关系、规划前快速了解状态、回顾近期变更或排查阻塞时，生成综合项目状态报告。不适用于深入单个条目、实时监控或单一来源查询。
主要能力：采用“收集→聚合→呈现”三阶段流程。收集阶段并行查询可用来源：版本控制（分支/栈结构、近期提交、工作区状态）、代码评审（开放 PR、CI 状态、评审决定与活动）、议题（近期更新、状态、优先级、指派）、CI/CD（流水线运行、成功/失败、错误摘要）。聚合阶段按时间过滤、按栈位置分组 PR、关联议题与 PR/分支、识别阻塞（CI 失败、阻塞性评审）、计算相对时间戳。呈现阶段按 VCS→PR→议题→CI 分层输出，使用 ✓ ✗ ⏳ 等视觉指示与相对时间，突出需关注项并提供深入链接。
使用方式：先解析自然语言时间约束，如“last X hours”转为 -Xh、“yesterday”转为 -1d、“this week”转为 -7d，未指定默认 7 天。可用脚本自动化收集：./scripts/sitrep.ts（全部来源，默认 24h）、./scripts/sitrep.ts -t 7d（最近 7 天）、./scripts/sitrep.ts -s github（指定来源）、./scripts/sitrep.ts --format=text。输出 JSON 或文本。
适用场景：会话启动时刷新上下文、每日站会、提交前钩子、创建 PR 时提供背景、定期跟踪进度。
限制：必需 VCS 工具（git、gt、jj）与 shell 访问；代码评审 CLI、议题跟踪 MCP/API、CI/CD API 为可选，缺失时优雅降级，任一来源不可用不应整体失败。避免阻塞于慢查询（使用超时），不得暴露凭据，不应无组织地倾倒原始数据。具体平台集成细节与输出模板见随附文档。