report-writing
業務完了後に、変更履歴や影響度分析、検証結果などをまとめた詳細な報告書を、指定されたファイル名規則に従って作成し、関係者への情報共有を円滑にするSkill。
📜 元の英語説明(参考)
작업 완료 후 상세 리포트 문서를 작성. 변경 이력, 영향도 분석, 검증 결과를 문서화할 때 사용. 파일명 규칙 YYYY-MM-DD-<제목>-report.md
🇯🇵 日本人クリエイター向け解説
業務完了後に、変更履歴や影響度分析、検証結果などをまとめた詳細な報告書を、指定されたファイル名規則に従って作成し、関係者への情報共有を円滑にするSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o report-writing.zip https://jpskill.com/download/18885.zip && unzip -o report-writing.zip && rm report-writing.zip$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/18885.zip -OutFile "$d\report-writing.zip"; Expand-Archive "$d\report-writing.zip" -DestinationPath $d -Force; ri "$d\report-writing.zip"完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
report-writing.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
report-writingフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
レポート作成
作業完了後に詳細レポートを作成するスキルです。
コア原則
「作業の『何』と『なぜ』を記録し、6ヶ月後にも追跡可能に」
ファイル名規則 (必須)
docs/reports/YYYY-MM-DD-<タイトル>-report.md例:
2024-12-24-path-renaming-report.md2024-12-20-security-audit-report.md2024-12-15-migration-complete-report.md
レポート構造
必須セクション
# 🔄 [作業タイトル] レポート
**作成日**: YYYY-MM-DD
**作業者**: [作業者名]
**スキル使用**: [使用したスキルリスト]
---
## 📋 変更概要
| 項目 | 内容 |
|------|------|
| **変更事由** | [なぜこの作業が必要だったのか] |
| **変更内容** | [何を変更したのか] |
| **影響範囲** | [どこに影響するか] |
| **状態** | ✅ 完了 / 🔄 進行中 / ❌ 失敗 |
---
## 🔧 変更されたファイルリスト
### 📝 修正されたファイル
| # | ファイル | 変更内容 | 変更タイプ |
|---|------|----------|----------|
| 1 | `ファイルパス` | 変更説明 | 🔧 Refactor |
---
## 🔍 詳細変更履歴
### ファイル名
```diff
- 以前の内容
+ 変更された内容✅ 検証完了
# 検証コマンドおよび結果📌 後続作業
- [ ] 後続作業 1
- [ ] 後続作業 2
変更タイプ分類
| Prefix | 絵文字 | 説明 |
|---|---|---|
| Feature | ✨ | 新機能追加 |
| Fix | 🐛 | バグ修正 |
| Refactor | 🔧 | コードリファクタリング |
| Docs | 📚 | ドキュメント変更 |
| Performance | ⚡ | パフォーマンス改善 |
| Security | 🔒 | セキュリティ関連 |
| Breaking | 💥 | 互換性を損なう変更 |
| Delete | 🗑️ | ファイル/機能削除 |
Before/After パターン
複雑な変更には Before/After 比較を含めます:
### Before/After 構造
Before After ────────────────── ────────────────── .old-folder/ .new-folder/ ├── files/ ├── files/ ✏️ └── config/ └── config/
影響度分析セクション
## 📊 影響度分析
### 直接的な影響
- 影響 1
- 影響 2
### 間接的な影響
- 依存関係の変更
- 設定ファイルの更新が必要
### 維持された項目
| 項目 | 事由 |
|------|------|
| 項目1 | 変更しなかった理由 |ダイアグラム (選択)
Mermaid でアーキテクチャ変更を視覚化します:
```mermaid
graph LR
A[Before] --> B[Change]
B --> C[After]
## ワークフロー
### 1. 情報収集
```bash
# 変更されたファイルを確認
git status --porcelain
# 変更内容を確認
git diff --name-only HEAD2. レポートのドラフト作成
必須セクションの構造に合わせて作成します。
3. 検証結果の追加
実際の検証コマンドと結果を含めます。
4. 後続作業の整理
残りの作業をチェックリストとして整理します。
関連スキル
レポート作成時に合わせて活用します:
| スキル | 活用 |
|---|---|
changelog-generator |
変更分類、絵文字体系 |
adr-log |
決定記録、代替案分析 |
writing-plans |
タスク構造化 |
チェックリスト
レポート作成完了前に確認します:
- [ ] ファイル名が
YYYY-MM-DD-<タイトル>-report.md形式であること - [ ] 変更概要テーブルが作成されていること
- [ ] すべての変更ファイルがリスト化されていること
- [ ] diff 形式の詳細履歴が含まれていること
- [ ] 検証コマンド/結果が含まれていること
- [ ] 後続作業チェックリストが作成されていること
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Report Writing
작업 완료 후 상세 리포트를 작성하는 스킬입니다.
Core Principle
"작업의 '무엇'과 '왜'를 기록하여 6개월 후에도 추적 가능하게"
파일명 규칙 (필수)
docs/reports/YYYY-MM-DD-<제목>-report.md예시:
2024-12-24-path-renaming-report.md2024-12-20-security-audit-report.md2024-12-15-migration-complete-report.md
리포트 구조
필수 섹션
# 🔄 [작업 제목] 리포트
**작성일**: YYYY-MM-DD
**작업자**: [작업자명]
**스킬 사용**: [사용한 스킬 목록]
---
## 📋 변경 개요
| 항목 | 내용 |
|------|------|
| **변경 사유** | [왜 이 작업이 필요했는지] |
| **변경 내용** | [무엇을 변경했는지] |
| **영향 범위** | [어디에 영향을 미치는지] |
| **상태** | ✅ 완료 / 🔄 진행중 / ❌ 실패 |
---
## 🔧 변경된 파일 목록
### 📝 수정된 파일
| # | 파일 | 변경 내용 | 변경 유형 |
|---|------|----------|----------|
| 1 | `파일경로` | 변경 설명 | 🔧 Refactor |
---
## 🔍 상세 변경 내역
### 파일명
\`\`\`diff
- 이전 내용
+ 변경된 내용
\`\`\`
---
## ✅ 검증 완료
\`\`\`bash
# 검증 명령어 및 결과
\`\`\`
---
## 📌 후속 작업
- [ ] 후속 작업 1
- [ ] 후속 작업 2변경 유형 분류
| Prefix | 이모지 | 설명 |
|---|---|---|
| Feature | ✨ | 새로운 기능 추가 |
| Fix | 🐛 | 버그 수정 |
| Refactor | 🔧 | 코드 리팩토링 |
| Docs | 📚 | 문서 변경 |
| Performance | ⚡ | 성능 개선 |
| Security | 🔒 | 보안 관련 |
| Breaking | 💥 | 호환성 깨짐 |
| Delete | 🗑️ | 파일/기능 삭제 |
Before/After 패턴
복잡한 변경에는 Before/After 비교 포함:
### Before/After 구조
\`\`\`
Before After
────────────────── ──────────────────
.old-folder/ .new-folder/
├── files/ ├── files/ ✏️
└── config/ └── config/
\`\`\`영향도 분석 섹션
## 📊 영향도 분석
### 직접 영향
- 영향 1
- 영향 2
### 간접 영향
- 의존성 변경
- 설정 파일 업데이트 필요
### 유지된 항목
| 항목 | 사유 |
|------|------|
| 항목1 | 변경하지 않은 이유 |다이어그램 (선택)
Mermaid로 아키텍처 변경 시각화:
\`\`\`mermaid
graph LR
A[Before] --> B[Change]
B --> C[After]
\`\`\`Workflow
1. 정보 수집
# 변경된 파일 확인
git status --porcelain
# 변경 내용 확인
git diff --name-only HEAD2. 리포트 초안 작성
필수 섹션 구조에 맞춰 작성
3. 검증 결과 추가
실제 검증 명령어와 결과 포함
4. 후속 작업 정리
남은 작업 체크리스트로 정리
관련 스킬
리포트 작성 시 함께 활용:
| 스킬 | 활용 |
|---|---|
changelog-generator |
변경 분류, 이모지 체계 |
adr-log |
결정 기록, 대안 분석 |
writing-plans |
태스크 구조화 |
Checklist
리포트 작성 완료 전 확인:
- [ ] 파일명이
YYYY-MM-DD-<제목>-report.md형식 - [ ] 변경 개요 테이블 작성
- [ ] 모든 변경 파일 목록화
- [ ] diff 형식 상세 내역 포함
- [ ] 검증 명령어/결과 포함
- [ ] 후속 작업 체크리스트 작성