name: specstory-project-stats description: 从SpecStory Cloud获取项目统计信息。当用户说“获取项目统计”、“显示SpecStory统计”、“项目统计”、“有多少会话”或“SpecStory指标”时运行。 license: Apache-2.0 metadata: author: SpecStory, Inc. version: “1.0.0” allowed-tools: Bash(node *)

SpecStory 项目统计

从SpecStory云平台获取项目统计信息，显示贡献者数量、会话活动和其他项目指标。

工作原理

识别项目通过 .specstory/.project.json、git远程或文件夹名称
调用 SpecStory Cloud API
返回项目统计信息以JSON格式
呈现数据以可读摘要

先决条件

项目必须已同步到SpecStory Cloud
必须可用Node.js运行脚本

用法

斜杠命令

用户说	操作
`/specstory-project-stats`	获取当前项目的统计
`/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

输出

脚本输出包含项目统计信息的JSON：

{
  "project_id": "specstoryai/agent-skills",
  "sessions": {
    "total": 156,
    "last_30_days": 47,
    "last_7_days": 12
  },
  "contributors": {
    "total": 5,
    "active_last_30_days": 3
  },
  "activity": {
    "first_session": "2025-10-15",
    "last_session": "2026-01-28",
    "avg_sessions_per_week": 8.2
  }
}

项目ID解析

脚本按以下顺序确定项目ID：

.specstory/.project.json - 使用 git_id 或 workspace_id 字段
Git远程 - 从 origin 远程URL提取仓库名称
文件夹名称 - 回退到当前目录名称

错误处理

错误	含义	操作
404	项目未找到	项目需要先同步到SpecStory Cloud
401	未授权	API端点可能需要认证
网络错误	无法访问API	检查互联网连接

向用户呈现结果

获取统计后，以友好格式呈现：

示例响应（成功）

以下是 **specstoryai/agent-skills** 的统计：

**会话**
- 总计：156个已捕获会话
- 过去30天：47个会话
- 过去7天：12个会话

**贡献者**
- 总计：5个贡献者
- 最近活跃：3个

**活动**
- 首次会话：2025年10月15日
- 最近：2026年1月28日
- 平均：约每周8个会话

您的项目一直在积极使用AI辅助编码！

示例响应（404错误）

此项目在SpecStory Cloud上尚不存在。

要开始：
1. 确保已安装SpecStory
2. 运行 `specstory sync` 将本地会话推送到云端
3. 再次尝试此命令

需要帮助？查看文档 https://docs.specstory.com

环境变量

变量	默认值	描述
`SPECSTORY_API_URL`	`https://cloud.specstory.com`	API端点

注意

统计从SpecStory Cloud获取，而非本地历史
项目必须已同步会话以显示有意义的统计
API是公开的，基本统计无需认证