AgentSkillsCN

weekly-report

每周项目进展报告。包括 Git 统计数据、功能完成情况、Bug 趋势以及代理使用情况。由 progress-tracker 代理负责生成。

SKILL.md
--- frontmatter
name: weekly-report
description: "Haftalık proje ilerleme raporu. Git stats, feature completion, bug trends, agent usage. progress-tracker agent tarafından kullanılır."
allowed-tools:
  - Read
  - Bash
  - Grep
  - Glob

Weekly Report Skill

Bu skill, progress-tracker agent'ın haftalık ilerleme raporu oluşturması için kullanılır.


📊 Rapor Bölümleri

1. Git Activity

bash
# Son 7 gündeki commit sayısı
git log --since="7 days ago" --oneline | wc -l

# Commit'lerin dağılımı
git log --since="7 days ago" --format="%ad" --date=short | sort | uniq -c

# En aktif dosyalar
git log --since="7 days ago" --name-only --pretty=format: | sort | uniq -c | sort -rn | head -10

# Contributor listesi
git log --since="7 days ago" --format="%an" | sort | uniq -c | sort -rn

2. Feature Progress

bash
# feature-list.json'dan istatistikler
cat feature-list.json | jq '{
  total: .total_features,
  completed: .completed_features,
  in_progress: [.features[] | select(.status == "in_progress")] | length,
  blocked: [.features[] | select(.status == "blocked")] | length,
  completion_rate: (.completed_features / .total_features * 100 | round)
}'

# Bu hafta tamamlanan feature'lar
cat feature-list.json | jq '.features[] | select(
  .completed_at >= (now - 7*24*60*60 | strftime("%Y-%m-%d"))
) | {id, title, completed_at}'

# Priority distribution
cat feature-list.json | jq '[.features[] | select(.status != "completed")] | group_by(.priority) | map({priority: .[0].priority, count: length})'

3. Code Quality Metrics

bash
# Test coverage trend (eğer coverage report varsa)
if [ -f coverage/coverage-summary.json ]; then
  cat coverage/coverage-summary.json | jq '.total | {
    lines: .lines.pct,
    statements: .statements.pct,
    functions: .functions.pct,
    branches: .branches.pct
  }'
fi

# Lint issues
npm run lint 2>&1 | grep -E "warning|error" | wc -l

# File count ve lines of code
find src -name "*.ts" -o -name "*.js" | wc -l
find src -name "*.ts" -o -name "*.js" | xargs wc -l | tail -1

4. Agent Usage Statistics

bash
# agent-metrics.json'dan özet
cat agent-metrics.json | jq '.agents | to_entries | map({
  agent: .key,
  tasks: .value.tasks_completed,
  avg_duration: .value.avg_duration_minutes,
  last_used: .value.last_used
}) | sort_by(-.tasks)'

# En aktif agent'lar
cat agent-metrics.json | jq '.agents | to_entries | map(select(.value.tasks_completed > 0)) | sort_by(-.value.tasks_completed) | .[0:5]'

5. Bug & Issue Tracking

bash
# Son 7 gündeki bug count (eğer GitHub kullanıyorsa)
gh issue list --label bug --state all --created ">=$(date -v-7d +%Y-%m-%d)" --json number,title,state | jq 'length'

# Critical issues
gh issue list --label "priority:high" --state open --json number,title

# Error log analizi
if [ -f ~/.claude/error-log.txt ]; then
  tail -n 1000 ~/.claude/error-log.txt | grep "$(date -v-7d +%Y-%m-%d)" | wc -l
fi

6. Velocity Metrics

bash
# Feature completion rate (son 4 hafta)
for week in 1 2 3 4; do
  start=$(date -v-${week}w -v-mon +%Y-%m-%d)
  end=$(date -v-${week}w -v+sun +%Y-%m-%d)
  count=$(cat feature-list.json | jq "[.features[] | select(.completed_at >= \"$start\" and .completed_at <= \"$end\")] | length")
  echo "Week -$week: $count features"
done

# Avg sessions per feature
cat feature-list.json | jq '[.features[] | select(.passes == true) | .actual_sessions] | add / length'

📝 Rapor Formatı

Markdown Template

markdown
# 📊 Weekly Report - Week of [TARIH]

## Executive Summary

- **Features Completed:** X
- **Active Development:** Y features
- **Code Quality:** Z% test coverage
- **Velocity:** W features/week

---

## 🎯 Feature Progress

### Completed This Week
- [F001] User Registration ✅
- [F002] Login System ✅

### In Progress
- [F003] Profile Management (60%)
- [F004] Password Reset (30%)

### Blocked
- [F005] OAuth Integration (waiting for API keys)

---

## 📈 Metrics

| Metric | This Week | Last Week | Trend |
|--------|-----------|-----------|-------|
| Commits | 45 | 38 | ⬆️ +18% |
| Features | 3 | 2 | ⬆️ +50% |
| Test Coverage | 78% | 75% | ⬆️ +3% |
| Bugs Found | 2 | 5 | ⬇️ -60% |

---

## 🤖 Agent Activity

| Agent | Tasks | Avg Duration | Most Used |
|-------|-------|--------------|-----------|
| backend-developer | 12 | 25min | ⭐ |
| qa-engineer | 8 | 15min | |
| architect | 3 | 45min | |

---

## 🔥 Highlights

- ✅ Completed user authentication flow
- ✅ Achieved 78% test coverage
- ⚠️ Database migration pending review

---

## 📅 Next Week Goals

- [ ] Complete profile management (F003)
- [ ] Implement password reset (F004)
- [ ] Increase test coverage to 80%
- [ ] Resolve OAuth blocker (F005)

---

**Report Generated:** [TIMESTAMP]
**By:** progress-tracker agent

🎨 Visualization (Optional)

Velocity Chart (Mermaid)

mermaid
xychart-beta
  title "Feature Completion Velocity"
  x-axis [Week-4, Week-3, Week-2, Week-1]
  y-axis "Features" 0 --> 10
  line [2, 3, 4, 3]

Priority Distribution

mermaid
pie title "Feature Priority Distribution"
  "P0 Critical" : 2
  "P1 High" : 5
  "P2 Medium" : 8
  "P3 Low" : 3

🔧 Kullanım

Manual Report Generation

bash
# progress-tracker agent'ı çağır
/weekly-report

Automated Weekly Report

Cron job veya GitHub Actions ile:

yaml
# .github/workflows/weekly-report.yml
name: Weekly Report
on:
  schedule:
    - cron: '0 9 * * 1'  # Her Pazartesi 09:00
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Generate Report
        run: |
          # progress-tracker agent'ı tetikle
          echo "Weekly report generation"

📊 Trend Analysis

Feature Completion Trend

bash
# Son 8 haftanın completion rate'i
for i in {1..8}; do
  week_start=$(date -v-${i}w -v-mon +%Y-%m-%d)
  week_end=$(date -v-${i}w -v+sun +%Y-%m-%d)
  completed=$(cat feature-list.json | jq "[.features[] | select(.completed_at >= \"$week_start\" and .completed_at <= \"$week_end\")] | length")
  echo "Week -$i: $completed"
done | gnuplot -e "set term dumb; plot '-' with lines"

Agent Efficiency Trend

bash
# Agent başına ortalama süre değişimi
cat agent-metrics.json | jq '.agents | to_entries | map({
  agent: .key,
  efficiency: (if .value.avg_duration_minutes > 0 then .value.tasks_completed / .value.avg_duration_minutes else 0 end)
}) | sort_by(-.efficiency)'

🎯 KPI'lar (Key Performance Indicators)

KPITargetCurrentStatus
Features/Week33✅ On Track
Test Coverage80%78%⚠️ Near Target
Bug Backlog<53✅ Healthy
Deployment Frequency2/week2✅ On Track
MTTR (Mean Time To Repair)<2h1.5h✅ Excellent

📧 Report Distribution

Raporu Slack'e gönder:

bash
# Slack MCP ile
curl -X POST https://hooks.slack.com/services/YOUR/WEBHOOK/URL \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "📊 Weekly Report Ready!",
    "attachments": [{
      "title": "Week of 2026-01-26",
      "text": "Features: 3 completed, 2 in progress",
      "color": "good"
    }]
  }'

🔗 Related Skills

  • feature-tracking - Feature verileri
  • monitoring - Production metrics
  • error-recovery - Error trends
  • incremental-coding - Session stats

📚 Örnek Komutlar

bash
# Tam rapor oluştur
/weekly-report full

# Sadece feature özeti
/weekly-report features

# Agent metrics
/weekly-report agents

# Velocity trend
/weekly-report velocity

Son Güncelleme: 2026-01-26 Kullanıcı: progress-tracker agent Frequency: Haftalık (Pazartesi sabahları)