SuperAPI AI 工具集

status

办公与效率

查看项目

更新于 10-16 09:13

技能介绍

用途

这是一个只读的状态汇报技能,用于在恢复暂停的会话或加入团队时,快速了解当前进展。它扮演的角色是给归队的队友做一次直接的“我们目前在哪里”的简报。它只读取持久化的信号,不依赖对上次会话的记忆,也不触碰实际工作,只负责为即将接手的人指明方向。

主要能力

该技能从 Git 仓库和持久化文档中收集信息并汇报:

  • Git 状态:当前分支、未提交/已暂存/未跟踪的改动、与远程的领先/落后提交数、最近提交记录。
  • 路线图进度:按状态统计功能(planned/in-progress/done),以及 existing(预先存在)和 dropped(已取消)的功能;对进行中的功能列出子任务完成情况和第一个未勾选的任务(恢复点)。
  • 决策:列出架构决策记录(ADR)及其状态(Proposed/In Progress/Accepted/Superseded)。
  • 协作风险:如落后于远程、存在未提交工作、进行中功能与其他作者重叠、ADR 与功能状态不一致、已取消功能仍关联 ADR、分离头指针等。
  • 计划与现实的偏差:未纳入计划的代码、孤立 ADR、标记为完成但近期有大量改动的功能。
  • 建议的下一步:给出单条最合理的后续命令。

使用方式

运行 /status 即可。该技能只读取和汇报,不写入任何内容、不修改任何文件、不运行构建,可在任何时候安全执行,包括工作区不干净或任务进行中。它不询问任何问题,只告诉你当前所处的位置。

执行步骤包括:

  1. 收集 Git 状态(分支、改动、与远程的差异、最近提交)。
  2. 扫描路线图文件(默认 docs/roadmap/,若 docs/ 是已发布的文档站点则用 .workflow/roadmap/),解析功能状态、子任务和构建方式。
  3. 列出 ADR 及其状态。
  4. 检查协作与会话风险。
  5. 交叉核对计划与现实,发现偏差。
  6. 输出报告。

适用场景

  • 恢复暂停的会话,需要知道从哪里继续。
  • 加入团队或接手他人工作时,快速了解仓库和路线图状态。
  • 在开始新工作前,确认是否存在未提交改动、远程更新或协作冲突。
  • 定期检查计划与代码、ADR 之间是否出现偏差。

限制

  • 只读,不执行任何修改或构建。
  • 仅依赖 Git 和代理的文件工具,git 是唯一必需的命令行工具。
  • 产物路径默认为 docs/,若 docs/ 是已发布的文档站点则使用 .workflow/。
  • 若没有路线图,会提示使用 /roadmap(全新项目)或 /audit(已有项目)来建立。
  • 若路线图文件格式异常,会标记出来而不是静默误报。
  • 不拥有任何产物,仅输出聊天内容。
  • 输出风格要求使用平实简单的语言,不使用任何破折号(em dash、en dash 或作为标点的连字符),用短句、逗号或括号代替。