القائمة
주간 업무 보고서를 생성합니다. Jira 이슈를 기반으로 팀 전체 또는 개인의 주간 업무 보고서를 작성하고 Confluence에 저장합니다.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | weekly-report |
| description | 주간 업무 보고서를 생성합니다. Jira 이슈를 기반으로 팀 전체 또는 개인의 주간 업무 보고서를 작성하고 Confluence에 저장합니다. |
| version | 2.2.0 |
| triggers | ["weekly report","weekly-report","주간 보고서","주간 업무 보고서"] |
| agents | ["jira-collector"] |
| templates | ["weekly-report"] |
| parameters | [{"name":"project","type":"string","description":"Jira 프로젝트 키 (PS, BK, BKIT, BKAM). 없으면 전체","required":false},{"name":"mode","type":"enum","values":["team","me"],"default":"team","description":"보고서 유형"},{"name":"date","type":"string","description":"회의 날짜 (YYYY-MM-DD). 없으면 이번/다음 금요일","required":false}] |
주간 업무 보고서를 생성하는 스킬입니다. Jira 이슈를 기반으로 팀 전체 또는 개인의 주간 업무 보고서를 작성합니다.
| 파라미터 | 설명 | 기본값 |
|---|---|---|
$ARGUMENTS | 프로젝트 키 또는 모드 | 전체 프로젝트, team 모드 |
사용 예시:
/weekly-report - 전체 프로젝트 팀 보고서/weekly-report BK - BK 프로젝트만/weekly-report me - 개인 보고서/weekly-report BK me - BK 프로젝트 개인 보고서┌─────────────────────────────────────────────────────────────┐
│ Skill: /weekly-report │
│ (Orchestrator - 전체 흐름 제어) │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Step 1-2: 기간 계산 & Confluence 폴더 확인 │
│ (Skill에서 직접 처리) │
└─────────────────────────────────────────────────────────────┘
│
┌───────────────────┼───────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ PS Agent │ │ BK Agent │ │ BKIT Agent │ ... (병렬)
│ (Task 1) │ │ (Task 2) │ │ (Task 3) │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
└───────────────────┼───────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Step 3.5: 결과 병합 (프로젝트별 → 팀원별) │
│ (Skill에서 직접 처리) │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Step 4-5: Template 적용 & Confluence 저장 │
│ (Skill에서 직접 처리) │
└─────────────────────────────────────────────────────────────┘
회의 날짜를 기준으로 보고 기간을 계산합니다.
계산 규칙 (금요일 기준):
주간 회의: 매주 금요일
├─ 이번주 한 일 (보고 대상 기간)
│ └─ {회의주 월요일} (월) 00:00:00 ~ {회의일} (금) 23:59:59
│
└─ 차주 할 일 (예정 작업 기간)
└─ {회의일 + 3일} (월) 00:00:00 ~ {회의일 + 7일} (금) 23:59:59
예시 (2026년 4월 10일 금요일 회의):
260410POPUPSTUDI7208961날짜 폴더 검색:
confluence_search: space = "POPUPSTUDI" AND title = "{YYMMDD}"
IMPORTANT: Agent tool을 사용하여 프로젝트별로 병렬 호출합니다.
🚨 subagent_type을 사용하지 마세요. MCP 도구(claude.ai Atlassian)는 deferred tool이라 ToolSearch로 먼저 스키마를 로드해야 합니다. subagent_type: "jira-collector"는 ToolSearch가 없어서 MCP 도구를 실행할 수 없습니다. 반드시 general-purpose Agent(subagent_type 생략)를 사용하세요.
하나의 메시지에서 Agent tool을 동시에 호출합니다:
# 전체 프로젝트 조회 시 (파라미터 없음)
Agent 호출 1: { description: "Jira PS 이슈 수집", prompt: "..." }
Agent 호출 2: { description: "Jira BK 이슈 수집", prompt: "..." }
Agent 호출 3: { description: "Jira BKIT 이슈 수집", prompt: "..." }
Agent 호출 4: { description: "Jira BKAM 이슈 수집", prompt: "..." }
# 특정 프로젝트만 조회 시 (예: /weekly-report BK)
Agent 호출 1: { description: "Jira BK 이슈 수집", prompt: "..." }
Agent tool 호출:
description: "Jira {project} 프로젝트 이슈 수집"
run_in_background: true
prompt: |
주간 보고서를 위한 Jira 이슈를 수집해주세요.
## Step 0: MCP 도구 로드 (필수!)
먼저 ToolSearch를 사용하여 MCP 도구 스키마를 로드하세요:
ToolSearch({ query: "select:mcp__claude_ai_Atlassian__searchJiraIssuesUsingJql", max_results: 1 })
## Step 1: JQL 쿼리 실행
로드된 mcp__claude_ai_Atlassian__searchJiraIssuesUsingJql 도구를 사용하여 아래 쿼리를 실행하세요.
- cloudId: "popupstudio.atlassian.net"
- maxResults: 50
- fields: ["summary", "status", "issuetype", "priority", "updated", "resolutiondate", "duedate", "project", "assignee", "reporter", "parent", "description"]
## 수집 조건
- 프로젝트: {project} (단일 프로젝트)
- 이번주 기간: {this_week_start} ~ {this_week_end} (end_exclusive: {this_week_end + 1일})
- 차주 기간: {next_week_start} ~ {next_week_end}
## JQL 쿼리 (3개 실행)
1. 이번주 업데이트: project = "{project}" AND updated >= "{this_week_start}" AND updated < "{this_week_end_exclusive}" ORDER BY updated DESC
2. 진행 중: project = "{project}" AND status in ("In Progress", "진행 중") ORDER BY priority DESC
3. 차주 예정: project = "{project}" AND (status in ("To Do", "Backlog", "Open", "해야 할 일") OR (dueDate >= "{next_week_start}" AND dueDate <= "{next_week_end}")) ORDER BY priority DESC
## 출력 형식
팀원별로 분류하여 key, summary, status, assignee, issuetype, priority, updated를 포함한 JSON으로 반환하세요.
🚨 절대로 데이터를 추정하거나 생성하지 마세요. MCP 도구 호출 결과만 사용하세요.
참고 문서: .claude/agents/jira-collector.md (JQL 쿼리 상세, 출력 스키마)
JQL 날짜 조건 주의사항:
<= "2026-02-01"→ 2026-02-01 00:00:00까지만 포함 (오후 이슈 누락!)< "2026-02-02"→ 2026-02-01 23:59:59까지 포함 (올바름)
각 프로젝트별 Agent 결과를 팀원 중심으로 병합합니다.
병합 규칙:
{
"members": [
{
"name": "김태형",
"projects": {
"PS": { "completed": [...], "in_progress": [...] },
"BK": { "completed": [...], "in_progress": [...] },
"BKIT": { "completed": [...], "in_progress": [...] },
"BKAM": { "completed": [...], "in_progress": [...] }
}
}
]
}
weekly-report Template을 적용하여 보고서를 생성합니다.
Template 참조: .claude/templates/weekly-report.template.md
생성된 보고서를 Confluence에 저장합니다.
confluence_create_page:
space_key: "POPUPSTUDI"
title: "{mode} 주간 업무 보고서 ({period_start} ~ {period_end})"
parent_id: "{날짜폴더 page_id}"
content: {작성한 보고서}
content_format: "markdown"
| 프로젝트 키 | 프로젝트명 | 설명 |
|---|---|---|
| PS | POPUP-STUDIO | 회사 공용 및 기타 업무 |
| BK | Bkend | bkend.ai 프로덕트 개발 |
| BKIT | Bkit | bkit.ai 프로덕트 개발 |
| BKAM | Bkamp | bkamp.ai 프로덕트 개발 |
| 이름 | 이메일 | 역할 |
|---|---|---|
| 김태형 | taekim@popupstudio.ai | 대표 |
| 이승준 | steve@popupstudio.ai | CSO |
| 김명일 | reinhard@popupstudio.ai | CTO |
| 김경호 | kay@popupstudio.ai | CIO |
| 김용운 | koyu@popupstudio.ai | bkamp PO |
| 박선영 | sypark@popupstudio.ai | bkend PO |
| 최준호 | jack@popupstudio.ai | Contents |
| 김민수 | mskim@popupstudio.ai | Operator |
| 김현진 | jacob@popupstudio.ai | Developer |
| 이병일 | lion@popupstudio.ai | Operator |
| 노원대 | drwon@popupstudio.ai | 공동대표 |
| 황인준 | injunh@popupstudio.ai | Developer |