---

名称: specstory-project-stats 描述: 从 SpecStory Cloud 获取项目统计信息。当用户说“获取项目统计”、“显示 SpecStory 统计”、“项目统计”、“有多少会话”或“SpecStory 指标”时运行。 许可证: Apache-2.0 元数据: 作者: SpecStory, Inc. 版本: “1.0.0” 允许的工具: Bash(node *)

SpecStory 项目统计

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

工作原理

1. 识别 项目通过 .specstory/.project.json、git remote 或文件夹名称
2. 调用 SpecStory Cloud API
3. 返回 项目统计信息，格式为 JSON
4. 呈现 数据为可读的摘要

先决条件

• 项目必须已同步到 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：

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

错误处理

错误	含义	操作
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 是公开的，基本统计无需认证