# Markdown Templates > 정형화된 마크다운 문서 템플릿 사용 가이드 - Skill: `majiayu000/markdown-templates` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds add majiayu000/markdown-templates` - Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/markdown-templates/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: majiayu000 (https://skillmd.com/u/majiayu000) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/majiayu000/markdown-templates --- # Markdown Templates 정형화된 마크다운 문서 생성을 위한 템플릿 모음입니다. ## 핵심 원칙 **정형 콘텐츠는 템플릿, 비정형 콘텐츠는 markdown-writer-agent** --- ## 템플릿 목록 | 템플릿 | 위치 | 용도 | |--------|------|------| | task-template.md | `.claude/templates/` | Task 파일 골격 | | test-case-template.md | `.claude/templates/` | 테스트 케이스 골격 | | agent-result-template.md | `.claude/templates/` | 에이전트 결과 형식 | | step-status-template.md | `.claude/templates/` | Step 상태 형식 | --- ## 변수 치환 규칙 템플릿 내 변수는 `{{VARIABLE_NAME}}` 형식: ### 공통 변수 | 변수 | 설명 | 예시 | |------|------|------| | `{{TIMESTAMP}}` | ISO 형식 시간 | 2024-01-15T10:30:00 | | `{{STATUS}}` | 상태 값 | pending, in_progress, completed | ### Task 템플릿 변수 | 변수 | 설명 | |------|------| | `{{TASK_ID}}` | Task 식별자 (TASK-001) | | `{{TITLE}}` | Task 제목 | | `{{CREATED_AT}}` | 생성 시간 | | `{{UPDATED_AT}}` | 업데이트 시간 | | `{{REQUEST_CONTENT}}` | 사용자 요청 원문 | | `{{CODEBASE_SEARCH_RESULT}}` | codebase-search 결과 | | `{{REFERENCE_RESULT}}` | reference-agent 결과 | | `{{WEB_SEARCH_RESULT}}` | web-search 결과 | | `{{STEPS_CONTENT}}` | Step 목록 | | `{{AGENT_RESULTS}}` | 에이전트 결과들 | | `{{TEST_RESULTS}}` | 테스트 결과들 | | `{{USER_INTERACTIONS}}` | 사용자 상호작용 기록 | ### Test Case 템플릿 변수 | 변수 | 설명 | |------|------| | `{{TEST_ID}}` | 테스트 식별자 (TASK-001-T01) | | `{{TEST_TITLE}}` | 테스트 제목 | | `{{STEP_NUMBER}}` | 관련 Step 번호 | | `{{IMPLEMENTATION_SUMMARY}}` | 구현 내용 요약 | | `{{TEST_PURPOSE}}` | 테스트 목적 | | `{{TEST_ENVIRONMENT}}` | 테스트 환경 | | `{{TEST_ITEMS}}` | 테스트 항목 목록 | | `{{RELATED_FILES}}` | 관련 파일 목록 | | `{{NOTES}}` | 참고사항 | | `{{TEST_RESULT_ROWS}}` | 결과 테이블 행 | | `{{FINAL_RESULT}}` | 최종 결과 | | `{{TEST_DATE}}` | 테스트 일시 | | `{{TESTER}}` | 테스터 | ### Agent Result 템플릿 변수 | 변수 | 설명 | |------|------| | `{{AGENT_NAME}}` | 에이전트 이름 | | `{{RESULT_DETAILS}}` | 결과 상세 내용 | | `{{NEXT_ACTIONS}}` | 다음 작업 | ### Step Status 템플릿 변수 | 변수 | 설명 | |------|------| | `{{STEP_NUMBER}}` | Step 번호 | | `{{STEP_TITLE}}` | Step 제목 | | `{{STEP_STATUS}}` | Step 상태 | | `{{ASSIGNED_AGENT}}` | 담당 에이전트 | | `{{START_TIME}}` | 시작 시간 | | `{{END_TIME}}` | 완료 시간 | | `{{STEP_DESCRIPTION}}` | 작업 내용 | | `{{STEP_RESULT}}` | 결과 | | `{{MODIFIED_FILES}}` | 수정 파일 목록 | --- ## 사용 방법 ### 1. 템플릿 읽기 ``` Read 도구로 템플릿 파일 읽기: .claude/templates/task-template.md ``` ### 2. 변수 값 준비 ``` TASK_ID = "TASK-001" TITLE = "사용자 인증 구현" STATUS = "pending" CREATED_AT = "2024-01-15T10:30:00" ... ``` ### 3. 변수 치환 템플릿 내용에서 `{{변수명}}`을 실제 값으로 교체 ### 4. 파일 생성 ``` Write 도구로 결과 파일 저장: ./tasks/TASK-001.md ``` --- ## 동적 콘텐츠 처리 일부 변수는 동적 생성이 필요합니다: ### 정형 동적 콘텐츠 (직접 생성) - `{{STEPS_CONTENT}}`: step-status-template 반복 적용 - `{{TEST_RESULT_ROWS}}`: 테이블 행 생성 ### 비정형 동적 콘텐츠 (markdown-writer-agent 활용) - `{{TEST_ITEMS}}`: 테스트 항목 상세 설명 - `{{NOTES}}`: 참고사항 설명 - `{{STEP_DESCRIPTION}}`: Step 작업 내용 --- ## 워크플로우 예시 ### Task 파일 생성 ``` 1. task-template.md 읽기 2. 기본 변수 치환 (TASK_ID, TITLE, STATUS 등) 3. 검색 결과 삽입 (CODEBASE_SEARCH_RESULT 등) 4. Steps 생성: - step-status-template.md 반복 적용 - STEPS_CONTENT에 삽입 5. 최종 파일 생성 ``` ### Test Case 파일 생성 ``` 1. test-case-template.md 읽기 2. 기본 변수 치환 (TEST_ID, TASK_ID 등) 3. markdown-writer-agent spawn → TEST_ITEMS 생성 4. 결과 삽입 5. 최종 파일 생성 ``` --- ## 주의사항 1. **템플릿 우선**: 정형 콘텐츠는 항상 템플릿 사용 2. **변수 누락 확인**: 모든 `{{}}` 변수가 치환되었는지 확인 3. **비정형은 위임**: 복잡한 설명은 markdown-writer-agent 활용 ---