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 は公開されており、基本的な統計情報の取得に認証は必要ありません