basecamp/house-skills

git-activity

Fetch git log from local repos into day-cached JSON atoms.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/basecamp/house-skills --skill git-activity

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Git Activity Fetcher

Fetch git commit history from local repositories into per-day cached JSON atoms at ~/.cache/recap/git/{repo}/{YYYY-MM-DD}/log.json. These atoms feed the /recap orchestrator for progressive timescale synthesis.

Invocation

/recap:git-activity --repos coworker:~/Work/basecamp/coworker --since 2026-03-23
/recap:git-activity --repos coworker:~/Work/basecamp/coworker,house-skills:~/Work/basecamp/house-skills --since 2026-03-23 --until 2026-03-30
/recap:git-activity --repos coworker:~/Work/basecamp/coworker --since 2026-03-23 --reuse
/recap:git-activity --repos coworker:~/Work/basecamp/coworker --since 2026-03-23 --author "Jeremy Daer" --all-branches

Contract

  • Idempotent: same input produces same output, safe to re-run
  • Day-cached: one JSON file per repo per day at ~/.cache/recap/git/{repo}/{YYYY-MM-DD}/log.json,

or under a scope directory when --author or --all-branches narrows or widens the log

  • `--reuse`: skip fetch if cache exists and is marked complete
  • No API calls: reads local git repos only

Quick Run

bash
# 1. Determine date range
SINCE=$(date -d "7 days ago" +%Y-%m-%d)
UNTIL=$(date +%Y-%m-%d)

# 2. Run the fetcher
"$SKILL_DIR/scripts/git-activity.sh" \
  --repos "coworker:$HOME/Work/basecamp/coworker" \
  --since "$SINCE" --until "$UNTIL"

# 3. Verify cache
ls ~/.cache/recap/git/coworker/
cat ~/.cache/recap/git/coworker/$SINCE/log.json | jq '.metadata'

Where $SKILL_DIR = directory containing this SKILL.md.

Output Format

Each log.json contains:

json
{
  "repo": "coworker",
  "date": "2026-03-24",
  "commits": [
    {
      "hash": "abc123...",
      "short_hash": "abc123",
      "subject": "Add weekly digest skill",
      "author": "Jeremy",
      "date": "2026-03-24T10:30:00-05:00",
      "body": "Extended commit message..."
    }
  ],
  "metadata": { "complete": true, "count": 3 }
}

Arguments

ArgumentRequiredDescription
--reposYesComma-separated name:path pairs
--sinceYesStart date (YYYY-MM-DD)
--untilNoEnd date (default: today)
--authorNoKeep only commits whose author matches this pattern (git log --author)
--all-branchesNoLog every local and remote-tracking branch, not just the checked-out one
--reuseNoSkip fetch if cache exists and is complete

By default the fetcher logs the checked-out branch and every author: the repo's activity. For one person's work, pass --author and --all-branches, so coworkers' commits drop out and commits on other branches, pushed or not, come in.

Cache Structure

~/.cache/recap/git/
  coworker/
    2026-03-24/log.json
    2026-03-25/log.json
    all-branches-author-jeremy-daer-189a21ec/
      2026-03-24/log.json
  house-skills/
    2026-03-24/log.json

A filtered fetch caches under its own scope directory, named from the filters, so --reuse never hands a filtered run the unfiltered day or the other way round. The name ends in a digest of the exact --author pattern: Jeff and ^Jeff$ match different commits, so they must not share a directory.

Day-sized atoms enable progressive aggregation: a weekly digest reads 7 daily atoms. A monthly digest reads ~30. Different timescales, same data.

Failure Modes

SymptomCauseFix
"not a git repo"Path doesn't point to repoCheck --repos paths
Empty commits for a dayNo commits on that dateExpected — empty days are cached as complete
awk/jq parse errorUnusual characters in commit messagesFalls back to simpler format automatically

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills
basecamp
커뮤니티

address-pr-reviews

Address PR review comments - fix issues, reply to threads, mark resolved

1시간 설치 수
1
GitHub Stars
102
업데이트
11월 16일
basecamp
커뮤니티

agents-md

Write, slim, or audit a repository's agent instruction file — AGENTS.md, CLAUDE.md, or similar. Use when creating one for a repo that lacks it, when an existing one has grown bloated, stale, or contradictory, or when reviewing one for wrong commands and dead references. Covers what earns a place in always-on context and what belongs behind progressive disclosure.

1시간 설치 수
1
GitHub Stars
102
업데이트
11월 16일
basecamp
커뮤니티

basecamp-activity

Fetch Basecamp project or person activity into day-cached JSON atoms. Uses the Basecamp API with pagination and rate-limit backoff. Part of the recap plugin's activity fetcher pipeline.

1시간 설치 수
1
GitHub Stars
102
업데이트
11월 16일
basecamp
커뮤니티

identity-security

Judge changes to how people get into and keep control of an account: sign-in, sessions and sign-out, 2FA and passkeys, step-up re-authentication, account recovery, password and address changes, forwarding, exports, OAuth and app grants, delegates and shared accounts. Use when designing or reviewing such a change, when porting one from an older system, when a parity or black-box check shows a difference on one, and when a security report or audit asks for a fix to one. It names the attacker by th

1시간 설치 수
1
GitHub Stars
102
업데이트
11월 16일