specstory-project-stats

SpecStory 项目统计信息

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

工作原理

1. 识别 项目：通过 .specstory/.project.json、Git 远程地址或文件夹名称
2. 调用 SpecStory Cloud API
3. 以 JSON 格式返回 项目统计信息
4. 以易读的摘要呈现 数据

前提条件

• 项目必须已同步到 SpecStory Cloud
• 必须有 Node.js 才能运行脚本

用法

斜杠命令

用户输入	操作
/specstory-project-stats	获取当前项目的统计信息
/specstory-project-stats	与上方相同（无需参数）

直接运行脚本

# Fetch stats for current project
node skills/specstory-project-stats/scripts/get-stats.js

# With custom API endpoint (for development)
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：

1. .specstory/.project.json —— 使用 git_id 或 workspace_id 字段
2. Git 远程地址 —— 从 origin 远程 URL 中提取仓库名称
3. 文件夹名称 —— 使用当前目录名称作为后备选项

错误处理

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

向用户展示结果

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

响应示例（成功）

Here are the stats for **specstoryai/agent-skills**:

**Sessions**
- Total: 156 sessions captured
- Last 30 days: 47 sessions
- Last 7 days: 12 sessions

**Contributors**
- Total: 5 contributors
- Active recently: 3

**Activity**
- First session: October 15, 2025
- Most recent: January 28, 2026
- Average: ~8 sessions per week

Your project has been actively using AI-assisted coding!

响应示例（404 错误）

This project doesn't exist on SpecStory Cloud yet.

To get started:
1. Make sure you have SpecStory installed
2. Run `specstory sync` to push your local sessions to the cloud
3. Try this command again

Need help? Check the docs at https://docs.specstory.com

环境变量

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

备注

• 统计信息来自 SpecStory Cloud，而非本地历史记录
• 项目必须已同步会话，才能显示有意义的统计信息
• API 是公开的，基本统计信息无需身份验证