toki/workspace-manager
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
workspace-manager/.workspace-ops/skills/weekly-subproject-work-summary/SKILL.md

8.5 KiB
Raw Blame History

name version description
weekly-subproject-work-summary 1.0.0 workspace root 아래 여러 하위 Git repository의 최근 1주 작업 내용을 평가 없이 샘플형 보고서 구조로 요약하는 주간 작업 정리 스킬. 사용자가 "주간 작업", "이번주 작업 정리", "지난 일주일 작업 요약", "weekly work summary"를 요청할 때 사용한다. "이번주 작업 평가"나 "주간 분석"처럼 평가가 필요한 요청은 weekly-subproject-review를 사용한다.

Weekly Subproject Work Summary

목적

workspace root의 하위 Git repository를 대상으로 최근 1주 작업 내용을 git 기반으로 수집하고, 사용자가 보고 문서에 바로 옮길 수 있는 샘플형 구조로 정리한다. 평가, 점수, 속도 비교, 품질 판정은 하지 않는다.

언제 호출할지

  • 사용자가 "주간 작업", "이번주 작업 정리", "지난 일주일 작업 요약"을 요청할 때
  • 사용자가 평가보다 "무슨 작업이 있었는지"를 보고서형 구조로 보고 싶어 할 때
  • 여러 하위 repository의 최근 1주 git 기록을 쉬운 문체로 압축해야 할 때
  • "weekly work summary", "weekly work log"처럼 주간 작업 목록을 요청할 때

입력

  • workspace-root: 분석할 workspace root. 없으면 현재 작업 디렉터리
  • since: 분석 시작일. 없으면 7일 전
  • until: 분석 종료일. 없으면 현재 시각
  • focus: 특정 repo, 기능, 경계. 선택

먼저 확인할 것

  • .workspace-ops/shared/target-discovery.md의 대상 탐색/제외 규칙
  • 하위 repository 목록
  • 최근 1주 커밋 제목, 변경 파일 상위 경로, shortstat
  • --all 대신 기본적으로 --branches --remotes 기준 사용

실행 절차

  1. 기간 결정

    • 사용자가 기간을 지정하지 않았으면 최근 7일을 기준으로 한다.
    • 현재 날짜와 timezone이 필요한 경우 date -Is로 확인한다.

  2. 대상 repository 탐색

    • .workspace-ops/shared/target-discovery.md 규칙으로 하위 .git repository를 찾는다.
    • .workspace-ops/**, .tmp/**, .antigravitycli/**, 생성물/캐시 디렉터리는 분석 대상에서 제외한다.
    • .agent-cache/** 같은 하위 프로젝트 내부 캐시성 중첩 repository는 사용자가 명시하지 않으면 제외한다.
    • root .gitignore에서 ignore되는 프로젝트 폴더 중 .workspace-ops/config/target-excludes.txt에 없는 repository만 대상으로 한다.

  3. git 기록 수집

    • repository별로 최근 1주 커밋 제목을 확인한다.
    • checkpoint/stash성 ref가 섞이지 않도록 기본적으로 git log --branches --remotes를 사용한다.
    • 변경 파일은 상위 경로 중심으로 본다. 세부 archive 로그 파일은 사용자가 명시하지 않으면 읽지 않는다.
    • sync 커밋은 "sync 커밋" 자체보다 반영된 운영 규칙, 스킬, 진입 파일, ignore 정책, 실행 스크립트 등 실제 내용을 요약한다.
    • 미커밋 상태는 기본 출력에 쓰지 않는다. 사용자가 요청한 경우에만 별도 언급한다.
    • 필요하면 scripts/collect.sh를 실행한다.

  4. 작업 내용 묶기

    • 같은 repo 안의 커밋을 기능/영역 단위로 묶는다.
    • 가능한 묶음 예:
      • 앱 셸/화면
      • API/worker/socket/contract
      • 테스트/검증/benchmark
      • 로드맵/작업 아카이브
      • 운영 규칙/agent-ops/포트 표준화
    • 커밋 수나 라인 수를 중심으로 쓰지 말고, 사용자가 이해할 수 있는 작업 단위로 압축한다.

  5. 출력 작성

    • 샘플 문서처럼 번호가 붙은 보고서 섹션으로 작성한다.
    • # 1. 프로젝트별 주간 작업, # 2. 단계별 산출물, # 3. 주요 리스크 및 고려사항, # 4. 보고용 요약 순서를 유지한다.
    • 1번 섹션에는 repo별 ## repo-name: 핵심 작업 주제 블록을 만들고, 각 블록에 구분, 내용, 목표, 확인된 작업자, 주요 작업, 완성 산출물 항목을 둔다.
    • 확인된 작업자는 git author 기준으로 확인 가능한 범위에서만 적고, 확실하지 않으면 확인 불가라고 쓴다. 사람 이름을 추정하지 않는다.
    • 목표는 git 기록에서 드러난 작업 방향을 1-2문장으로 중립 서술한다. 로드맵, 의도, 미래 일정을 추정하지 않는다.
    • 주요 작업은 repo당 보통 4-8개 bullet로 제한한다.
    • 완성 산출물은 확인된 변경 결과를 2-5개 bullet로 쓴다. 완료 여부가 불명확하면 정리, 초안, 기반처럼 확인 가능한 표현을 사용한다.
    • 작업이 거의 없는 repo도 생략하지 말고, 실제 변화가 agent-ops 동기화 중심이면 그렇게 짧게 쓴다.
    • 2번 섹션은 repo 또는 작업 단계 단위로 구분과 주요 산출물을 나열한다.
    • 3번 섹션은 git 기록과 변경 경로에서 사실로 확인되는 운영 고려사항만 쓴다. 확인되는 항목이 없으면 확인된 주요 리스크 없음으로 짧게 마무리한다.
    • 4번 섹션은 전체 작업 흐름을 3-5문단으로 요약한다.
    • 전체 총평, 평가표, 속도표, 품질표, 점수는 쓰지 않는다.

문체 규칙

  • 한국어로 작성한다.
  • 어렵지 않은 문장과 짧은 명사형 bullet을 사용한다.
  • 샘플처럼 보고서 문체를 사용하되, 과장된 로드맵 문장이나 확인되지 않은 미래 계획은 만들지 않는다.
  • bullet 끝에 함, 했음, 합니다, 했습니다를 붙이지 않는다.
  • 좋은 예:
    • - inbound queue ordering을 여러 언어 게이트웨이에 반영
    • - core HTTP server 파일을 핸들러 단위로 분리
    • - Flutter/macOS 기반 AppSok 앱 스캐폴딩
  • 피할 예:
    • - inbound queue ordering을 반영함
    • - core HTTP server 파일을 분리했습니다
    • - 미커밋 수정 존재
  • "미커밋", "감점", "누락" 같은 평가성 표현은 사용자가 요청하지 않으면 쓰지 않는다.
  • 주요 리스크 및 고려사항 섹션에서도 결함 판정이 아니라 후속 확인이 필요한 사실만 중립적으로 쓴다.

출력 형식

# 1. 프로젝트별 주간 작업

* * *
## repo-name: 핵심 작업 주제

구분

내용

목표

최근 1주 git 기록에서 확인된 작업 방향을 1-2문장으로 정리합니다.

확인된 작업자

git author 기준 N명

주요 작업

  * 작업 내용

  * 작업 내용

  * 작업 내용

완성 산출물

  * 확인된 산출물

  * 확인된 산출물

* * *
## repo-name: 핵심 작업 주제

구분

내용

목표

최근 1주 git 기록에서 확인된 작업 방향을 1-2문장으로 정리합니다.

확인된 작업자

git author 기준 N명

주요 작업

  * 작업 내용

  * 작업 내용

완성 산출물

  * 확인된 산출물

# 2. 단계별 산출물

구분

주요 산출물

repo-name

핵심 산출물 요약

repo-name

핵심 산출물 요약

* * *

# 3. 주요 리스크 및 고려사항

## 고려사항 제목

git 기록과 변경 경로에서 사실로 확인되는 후속 확인 사항을 중립적으로 정리합니다.

* * *

# 4. 보고용 요약

전체 주간 작업 흐름을 3-5문단으로 정리합니다.

실행 결과 검증

  • .workspace-ops/**를 하위 프로젝트 작업량에 포함하지 않았는가
  • agent-task/archive/**와 agent-roadmap/archive/**를 명시 요청 없이 읽지 않았는가
  • 평가표, 점수, 속도 비교를 출력하지 않았는가
  • 샘플형 보고서 섹션 1-4를 순서대로 출력했는가
  • repo별 블록에 목표, 확인된 작업자, 주요 작업, 완성 산출물을 포함했는가
  • 리스크/고려사항 섹션에 확인되지 않은 추정이나 품질 판정이 들어가지 않았는가
  • bullet 끝에 함, 했음, 했습니다가 남아 있지 않은가
  • 미커밋 상태를 기본 출력에 쓰지 않았는가

금지 사항

  • 분석 요청만 받은 상태에서 하위 repository 파일을 수정하지 않는다.
  • 주간 작업 요약을 주간 평가로 바꾸지 않는다.
  • 커밋 수나 라인 수만으로 작업 의미를 단정하지 않는다.
  • 확인되지 않은 일정, 투입 인원, 완료 상태, 향후 계획을 추정하지 않는다.
  • checkpoint/stash성 ref를 일반 작업 커밋처럼 요약하지 않는다.
  • archive 디렉터리를 사용자가 명시하지 않았는데 읽지 않는다.
  • 하위 프로젝트 내부 캐시성 중첩 repository를 일반 관리 프로젝트처럼 요약하지 않는다.