SuperAPI AI 工具集

specstory-project-stats

数据与分析

查看项目

更新于 10-15 22:33

技能介绍

用途:从 SpecStory Cloud 云端获取项目统计信息,展示贡献者数量、会话活动及其他项目指标。当用户说“get project stats”“show SpecStory stats”“project statistics”“how many sessions”等时运行。

主要能力:识别项目后调用 SpecStory Cloud API,以 JSON 返回统计数据并整理为可读摘要。输出包含会话总数、近 30 天与近 7 天会话数、贡献者总数与近 30 天活跃数、首次与最近会话日期及平均每周会话数。

使用方式:作为 slash 命令,用户输入 /specstory-project-stats 即可获取当前项目统计(无需参数)。也可直接运行脚本:node skills/specstory-project-stats/scripts/get-stats.js。开发时可自定义 API 端点:SPECSTORY_API_URL=http://localhost:5173 node skills/specstory-project-stats/scripts/get-stats.js。

项目 ID 解析顺序:先读 .specstory/.project.json 中的 git_id 或 workspace_id,其次从 git remote 的 origin URL 提取仓库名,最后回退为当前目录名。

环境变量:SPECSTORY_API_URL 默认 https://cloud.specstory.com。

前置条件:项目必须已同步到 SpecStory Cloud;运行脚本需 Node.js 可用。

错误处理:404 表示项目未找到,需先同步到 SpecStory Cloud(可运行 specstory sync);401 表示未授权,API 端点可能需要认证;网络错误表示无法访问 API,需检查网络连接。

限制:统计来自 SpecStory Cloud 而非本地历史,项目须已同步会话才有有意义的数据;基础统计的 API 为公开,无需认证。具体分类、平台支持及其他细节暂未提供。