team-shinchan:analytics

分类: 工具与效率 | 上传者: seokan-jeong | 下载: 0 | 版本: v1.0（最新）

当您需要分析工作跟踪器数据以获取代理指标或会话统计信息时使用。

更新日志: Source: GitHub https://github.com/seokan-jeong/team-shinchan

目录结构

当前层级: tree/main/skills/analytics/

📄 SKILL.md 2.7 KB

SKILL.md

---
name: team-shinchan:analytics
description: Use when you need to analyze work tracker data for agent metrics or session stats.
user-invocable: false
---

# Analytics Skill

**Analyze work tracker events for observability insights.**

## Usage

```bash
/team-shinchan:analytics                        # Current session summary
/team-shinchan:analytics --report full          # Full analytics report
/team-shinchan:analytics --agent bo             # Single agent detail
/team-shinchan:analytics --trace trace-xxx      # Trace timeline
/team-shinchan:analytics --period 7d            # Last 7 days only
```

## Arguments

| Arg | Default | Description |
|-----|---------|-------------|
| `--report full` | (session) | Generate full analytics report |
| `--agent {name}` | (all) | Detail for a single agent |
| `--trace {id}` | (none) | Timeline for a specific trace ID |
| `--period {N}d` | (all) | Filter events to the last N days |
| `--format table` | json | Output as text table instead of JSON |

## Process

### Step 1: Locate Tracker File

Use `.shinchan-docs/work-tracker.jsonl` as the data source.

If file does not exist:
```
No work tracker log found.
Events will be recorded automatically during Claude Code sessions.
```

### Step 2: Run Analytics Script

Execute the analytics script via Bash:

```bash
node "${CLAUDE_PLUGIN_ROOT}/src/analytics.js" .shinchan-docs/work-tracker.jsonl [options]
```

Map user arguments to script flags:
- `--report full` → no extra flags (full report is default)
- `--agent <name>` → `--agent <name>`
- `--trace <id>` → `--trace <id>`
- `--period <N>d` → `--period <N>d`
- Default (no args) → `--format table`

### Step 3: Display Results

- For `--format table` or default: display the text table output directly
- For JSON output: format and display key sections with headers

### Step 4: Interpret Results

After displaying raw output, provide a brief interpretation:
- Highlight busiest agents
- Note any agents with low success rates
- Summarize delegation patterns
- Flag anomalies (e.g. agents with 0 completions)

## Metrics Computed

| Metric | Description |
|--------|-------------|
| **Agent call count** | How many times each agent was invoked |
| **Avg duration** | Average time from agent_start to agent_done |
| **Success rate** | Ratio of agent_done to agent_start |
| **Session stats** | Events, file changes, delegations per session |
| **Event distribution** | Percentage breakdown of event types |
| **Delegation graph** | Which agent delegated to which, with counts |

## Important

- Analytics script: `src/analytics.js` (Node.js, built-in modules only)
- Data source: `.shinchan-docs/work-tracker.jsonl`
- Trace IDs: generated per user prompt via `trace-init` hook

登录后下载/点赞/收藏 ❤ 7 | ★ 0

team-shinchan:analytics

目录结构

SKILL.md

举报内容

提示