workspace-manager/.workspace-ops/skills/iop-weekly-subproject-work-summary/SKILL.md

8 KiB

name version description
iop-weekly-subproject-work-summary 1.0.0 IOP 관련 핵심 repository만 대상으로 기존 weekly-subproject-work-summary를 상속해 지난주 또는 최근 1주 git 작업 내용을 평가 없이 상위 bullet은 repo명, 하위 bullet은 기능/작업 영역 단위의 주요 내용인 간단한 목록으로 정리/요약하는 래퍼 스킬. 사용자가 "iop 지난주 작업 내용 알려줘", "iop 주간 작업을 요약해줘", "iop 주간 작업을 정리해줘", "iop 작업 요약", "IOP weekly work summary"처럼 IOP 범위의 작업 내용 정리나 요약을 요청할 때 사용한다.

IOP Weekly Subproject Work Summary

목적

기존 .workspace-ops/skills/weekly-subproject-work-summary/SKILL.md를 베이스로 사용하되, 분석 대상을 IOP 관련 핵심 repository로 제한한다. 평가, 점수, 속도 비교, 품질 판정은 하지 않고, git 기록에서 확인되는 작업 내용을 repo별 기능/작업 영역 bullet로만 정리한다. 기본 독자는 내부 주간 공유를 받는 사람으로 보고, 구현자가 아니어도 이해할 수 있는 기능명과 작업 축 중심으로 쓴다.

상속 규칙

  1. 먼저 베이스 스킬 .workspace-ops/skills/weekly-subproject-work-summary/SKILL.md를 읽고 따른다.
  2. 베이스 스킬이 요구하는 shared reference도 그대로 읽는다.
    • .workspace-ops/shared/target-discovery.md
  3. 이 스킬의 오버라이드 규칙과 베이스 스킬이 충돌하면 이 스킬을 우선한다.
  4. 베이스 스킬의 수집 원칙과 평가 금지 원칙은 유지하되, 출력 형식은 이 스킬의 단순 nested bullet 형식으로 오버라이드한다.

오버라이드

대상 repository

아래 repository만 작업 내용 요약 대상으로 삼는다.

  • agent-shell
  • agent-framework
  • iop
  • nexo
  • oto
  • proto-socket

로컬 workspace에 agent-framework가 없고 agentic-framework가 있으면 agent-framework 요청은 agentic-framework로 해석한다. 결과에는 실제 확인한 경로를 명확히 쓴다.

기간 해석

  • 사용자 요청에 지난주가 들어 있으면 rolling 7 days가 아니라 직전 calendar week를 기준으로 sinceuntil을 계산한다.
  • timezone이 명시되지 않았으면 현재 실행 환경의 date -Is 기준으로 계산하고, 최종 답변에는 사용한 절대 날짜를 적는다.
  • 사용자가 기간을 명시하면 그 기간을 우선한다.

예:

.workspace-ops/skills/iop-weekly-subproject-work-summary/scripts/collect.sh /config/workspace "2026-06-08 00:00" "2026-06-14 23:59:59"

포함/제외 기준

  • git log --branches --remotes 기준으로 기간 내 commit을 수집한다.
  • 분석 기간 동안 git commit이 없는 repository는 출력에 포함하지 않는다.
  • 분석 기간 동안 작업 내용 요약 대상 commit이 0개인 repository는 출력에 포함하지 않는다.
  • 변경된 파일이 모두 agent-ops sync path인 repository는 출력에 포함하지 않는다.
  • 하나의 commit에 sync path와 제품/운영 payload path가 함께 있으면 작업 내용 요약 대상 commit으로 본다.
  • 이 경우 sync path 자체가 아니라 제품/운영 payload path를 중심으로 요약한다.
  • 미커밋 변경은 기본 출력에 포함하지 않는다.
  • agent-task/archive/**agent-roadmap/archive/**의 파일 내용은 읽지 않는다. 단, git 변경 경로 집계에서 archive 경로가 나타나는 것은 작업 정리/아카이브 흐름으로만 요약할 수 있다.

agent-ops sync path는 다음으로 본다.

  • agent-ops/**
  • .claude/**
  • AGENTS.md
  • GEMINI.md
  • CLAUDE.md
  • .cursorrules
  • .clinerules

수집 방법

기본 수집은 이 스킬의 scripts/collect.sh를 사용한다.

.workspace-ops/skills/iop-weekly-subproject-work-summary/scripts/collect.sh /config/workspace "7 days ago"

기간을 명시받으면 두 번째 인자로 since, 세 번째 인자로 until을 전달한다.

.workspace-ops/skills/iop-weekly-subproject-work-summary/scripts/collect.sh /config/workspace "2026-06-08 00:00" "2026-06-14 23:59:59"

스크립트 출력에는 작업 내용 요약 대상 commit이 있는 repo만 나타난다. 출력에 없는 target repo는 최종 bullet 목록에 포함하지 않는다.

출력 작성 규칙

  • 최종 출력은 상위 bullet이 repository 이름이고, 하위 bullet이 기능/작업 영역 단위의 주요 내용인 nested bullet 목록만 사용한다.
  • 구분, 내용, 목표, 확인된 작업자, 완성 산출물, 보고용 요약, 리스크, 총평 같은 섹션이나 라벨은 쓰지 않는다.
  • 출력 대상 repo별로 하위 bullet은 보통 2-5개로 압축한다.
  • 하위 bullet은 git commit 제목과 변경 경로에서 확인되는 기능, 역량, 작업 영역 수준으로 쓴다.
  • 하위 bullet은 한 줄짜리 명사구로 쓴다. 설명 문장, 세부 구현 열거, commit 제목 재작성에 가까운 표현은 피한다.
  • 사용자가 세부 구현 내용을 명시적으로 요청하지 않았으면 파일명, 테스트명, class/function/module 내부 구조, adapter 세부 이름, config key, 마일스톤 번호, 세부 task id 같은 구현 디테일은 쓰지 않는다.
  • 여러 commit이 같은 기능 목표를 향하면 하나의 기능 bullet로 묶는다.
  • roadmap, task archive, milestone 정리는 제품 기능 작업과 별개로 의미 있는 운영 작업일 때만 로드맵/작업 정리처럼 넓은 단위로 쓴다.
  • repo별로 제품 기능 bullet을 먼저 쓰고, 운영/로드맵 정리는 필요할 때 마지막에 둔다.
  • 좋은 예:
    • inference provider와 모델 serving 확장
    • edge/node 런타임 동시성, 큐, 스케줄링 기능
    • agent 등록과 capability 경계 기능
    • Flutter Web 알림 기능과 알림 라우팅 개선
    • large payload 처리 최적화
  • 피할 예:
    • OpenAI compatible adapter implementation and test fixes
    • configs/edge.yaml과 server_test.go 갱신
    • m-node-multi-target-serving-foundation G07/G08 작업
    • provider availability capacity queue foundation
  • 전체 총평, 평가표, 속도표, 품질표, 점수는 쓰지 않는다.
  • 지난주 요청이라도 날짜 범위는 본문 앞뒤 설명으로 길게 쓰지 말고, 사용자가 날짜를 요구한 경우에만 한 줄로 덧붙인다.
  • 작업이 없는 repo나 agent-ops sync-only repo는 목록에 넣지 않는다.

출력 형식

- repo-name
  - 기능/작업 영역
  - 기능/작업 영역

- repo-name
  - 기능/작업 영역
  - 기능/작업 영역

실행 결과 검증

  • 베이스 weekly-subproject-work-summary를 먼저 읽었는가
  • 대상이 agent-shell, agent-framework/agentic-framework, iop, nexo, oto, proto-socket으로 제한됐는가
  • commit이 없는 repo와 agent-ops sync-only repo를 출력에서 제외했는가
  • 지난주 요청이면 rolling 7 days가 아니라 직전 calendar week 범위를 사용했는가
  • 상위 bullet은 repo명, 하위 bullet은 기능/작업 영역 수준의 주요 내용만 썼는가
  • 하위 bullet이 한 줄짜리 명사구이며 구현자가 아니어도 이해할 수 있는 수준인가
  • 사용자가 요구하지 않은 파일명, 테스트명, class/function/module 내부 구조, config key, 마일스톤 번호, 세부 task id 같은 구현 디테일을 제거했는가
  • 구분, 내용, 목표, 확인된 작업자, 완성 산출물 같은 라벨을 쓰지 않았는가
  • 평가표, 점수, 속도/품질 판정을 쓰지 않았는가
  • 미커밋 변경을 기본 출력에 포함하지 않았는가
  • archive 파일 내용을 직접 읽지 않았는가

금지 사항

  • iop 지난주 작업 내용 요청을 주간 평가/분석 스킬로 라우팅하지 않는다.
  • 대상 6개 repo 밖의 repository를 사용자가 요청하지 않았는데 함께 요약하지 않는다.
  • 작업 요약을 주간 평가로 바꾸지 않는다.