SuperAPI AI 工具集

status-reporting

通用与其它

查看项目

更新于 10-16 03:13

技能介绍

用途:在开始工作会话、检查项目或团队活动、理解 PR/栈关系、规划前快速了解状态、查看近期变更或阻塞项时,生成跨系统的项目状态报告。不适用于深入单个条目、实时监控或单一来源查询。

主要能力:采用三阶段模式——收集(从多来源并行查询)、聚合(按时间/栈/状态合并、过滤、交叉引用)、呈现(便于扫读并突出可行动信息)。支持 VCS 状态与分支栈结构、代码评审(PR/MR、CI 检查、评审意见)、议题(近期更新、状态、优先级、指派)、CI/CD(流水线运行、成败、错误摘要)。可交叉引用 PR 与分支、议题与 PR、CI 与 PR、议题与仓库,并按栈层级组织 PR、标注父子关系与当前位置。

使用方式:先解析自然语言时间约束,如“last X hours”转为 -Xh、“past X days”转为 -Xd、“yesterday”转为 -1d、“this morning/today”转为 -12h、“this week”转为 -7d、“since {date}”按天数回推,未指定默认 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 为可选,缺失时降级运行。不应因单一来源不可用而整体失败,不应阻塞于慢查询,不应暴露凭据,也不应无组织地倾倒原始数据。具体平台集成细节与输出模板见资料中提到的 graphite.md、github.md、linear.md、beads.md、templates.md、implementation.md、EXAMPLES.md、FORMATTING.md。