SuperAPI AI 工具集

session-start

编程与开发

查看项目

更新于 10-16 04:02

技能介绍

用途

Session Start 用于在每个工作会话开始时建立上下文、明确方向。其核心理念是:在采取任何行动之前,先理解当前状态。使用时需要在开始时声明:"I'm using session-start to get oriented before beginning work."。

主要能力

该技能按顺序执行以下协议步骤:

第 1 步:环境检查 验证所需工具和环境变量是否可用,包括检查 GitHub CLI 认证(gh auth status)、git 是否可用(git --version)、以及 GITHUB_PROJECT 是否已设置(echo $GITHUB_PROJECT)。任一项检查失败需先向用户报告再继续。关联技能:environment-bootstrap。

第 1.5 步:开发服务 检测可用的开发服务(docker-compose)。若存在 docker-compose.yml 或 .devcontainer/docker-compose.yml,则列出服务及其运行状态。关注哪些服务可用、哪些正在运行、是否需要启动。需要时可用 docker-compose up -d 启动全部或指定服务。关联技能:local-service-testing。

第 2 步:仓库状态 了解仓库当前状态:当前分支、工作目录状态、最近提交、是否有暂存改动。关注是否在功能分支或 main、是否有未提交改动、是否有进行中的工作。

第 3 步:GitHub Project 状态(权威来源) 通过 GitHub Project Board 检查工作当前状态。关键点:使用 github-api-cache 以减少 API 调用(初始化共 3 次 API 调用,替代 20+ 次单独调用),缓存项目字段与项目条目,并从中提取字段 ID。随后从缓存中查询各状态条目(In Progress、Ready、Blocked),并判断优先级最高的 Ready 项。关联技能:github-api-cache。

第 3.5 步:项目看板同步校验(强制) 验证项目看板状态与实际工作状态是否一致,使用第 3 步的缓存数据(项目查询不额外调用 API)。检查三类问题:标记为 In Progress 的 issue 是否都有活动分支;活动分支对应的 issue 是否标记为 In Progress 或 In Review;开放 PR 对应的 issue 是否标记为 In Review(PR 列表通过 REST API 调用一次)。若发现同步问题,需在继续前向用户报告差异、修复关键差异(如 In Progress 却无分支表示状态陈旧)、记录未解决的同步问题。关联技能:project-board-enforcement。

第 3.6 步:活动编排检测 检查是否有自主编排(autonomous orchestration)正在运行并需要恢复。通过 MCP Memory 查找 ActiveOrchestration 节点;若存在,需报告其状态、范围、跟踪 issue、上次循环、仓库,并立即恢复编排,从当前阶段(BOOTSTRAP 或 MAIN_LOOP)继续,无需等待用户输入(原自主操作请求仍为有效授权)。若不存在则继续第 4 步。

第 4 步:记忆检索 搜索上一次会话的相关上下文,包括情节记忆(当前 issue 号、功能/项目名、本仓库近期工作)和知识图谱(mcp__memory 中与项目相关的实体、已记录的决定或模式)。关联技能:memory-integration。

第 5 步:进行中工作检测 判断是否有进行中的工作可恢复。判断指标包括:分支非 main、存在未提交改动、issue 在项目中标记为 In Progress、上次会话笔记提及进行中工作。若检测到进行中工作,则读取相关 issue、查看最近提交信息、查阅验证报告、确定 issue-driven-development 流程的当前步骤。

第 6 步:环境引导 若全新开始或环境需设置,运行初始化脚本(如 scripts/init.sh)或常见替代方式(pnpm install --frozen-lockfile、pip install)。开始新工作前先验证基本功能可用。关联技能:environment-bootstrap。

第 7 步:定位与报告 向用户总结当前状态,包括仓库、分支、工作目录、进行中的工作(issue 编号、标题、项目状态、已完成进度)、环境(工具版本、检测到的问题)、开发服务(如 postgres、redis 的运行状态和端口)、以及准备就绪的动作。

使用方式

该技能通过命令行检查(gh、git、docker-compose、jq)和 MCP Memory 查询来逐步执行上述协议。完成后将进入以下之一:恢复——从 issue-driven-development 的当前步骤继续;新工作——从第 1 步开始 issue-driven-development。始终在 autonomous-operation 模式下运行。文档还提供了决策树:会话开始后依次判断环境是否正常、是否在 main 分支、是否有未提交改动、issue 是否标记 In Progress,最终确定是准备新工作还是恢复进行中工作。

适用场景

适用于每次工作会话开始时,尤其是在使用 GitHub Project、多分支、docker-compose 开发环境、以及需要跨会话恢复上下文的工作流中。文档包含常见问题处理:GITHUB_PROJECT 未设置(询问用户项目 URL)、未认证 gh(运行 gh auth login)、main 分支上有脏工作目录(先 stash 或丢弃)、issue 标记 In Progress 但分支已删除(重置 issue 状态重新开始)。

限制

该技能依赖 GitHub CLI、git、docker-compose、jq 及 MCP Memory 等环境;文档未提及具体的收费、价格信息。其余未在资料中说明的内容暂未提供。