name: specstory-project-stats description: 从SpecStory云获取项目统计。当用户说“获取项目统计”、“显示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云API
返回项目统计信息，格式为JSON
呈现数据为可读摘要

先决条件

项目必须已同步到SpecStory云
必须有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云
401	未授权	API端点可能需要认证
网络错误	无法访问API	检查网络连接

向用户呈现结果

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

示例响应（成功）

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

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

**贡献者**
- 总计：5位贡献者
- 近期活跃：3位

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

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

示例响应（404错误）

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

开始使用：
1. 确保已安装SpecStory
2. 运行`specstory sync`将本地会话推送到云
3. 重试此命令

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

环境变量

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

注意

统计信息从SpecStory云获取，而非本地历史
项目必须有同步会话才能显示有意义的统计
API是公开的，基本统计不需要认证