-
Notifications
You must be signed in to change notification settings - Fork 5
add:SKILL追加 #1
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
yoshida-takeshi-classmethod
wants to merge
2
commits into
classmethod:main
Choose a base branch
from
yoshida-takeshi-classmethod:add/claude
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
add:SKILL追加 #1
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,115 @@ | ||
| --- | ||
| name: marp-creator | ||
| description: Marpでスライド資料を作成するスキル。メモの整理、スライド設計、Marpファイル生成の3ステップで資料を作成する。提案書や勉強会資料の作成時に使用する。 | ||
| --- | ||
|
|
||
| # Marp Creator | ||
|
|
||
| Marpで提案書や勉強会資料を作成する。内容整理とスライド化を分離し、段階的に進めることで質の高い資料を作成する。 | ||
|
|
||
| ## ワークフロー | ||
|
|
||
| 3つのステップで資料を作成する。 | ||
|
|
||
| ``` | ||
| メモ・要件(任意の形式・ファイル名) | ||
| ↓ | ||
| [ステップ1] 内容整理 → 01_organized_*.md | ||
| ↓ | ||
| [ステップ2] スライド設計 → 02_slide-design_*.md | ||
| ↓ | ||
| [ステップ3] Marp資料作成 → 03_marp_*.md(最終成果物) | ||
| ``` | ||
|
|
||
| ## 開始ステップの判断 | ||
|
|
||
| 入力ファイルの種類に応じて、開始するステップを自動判断する。 | ||
|
|
||
| | 入力ファイル | 開始ステップ | | ||
| |-------------|-------------| | ||
| | メモ・要件(接頭辞なし) | ステップ1から開始 | | ||
| | `01_organized_*.md` | ステップ2から開始 | | ||
| | `02_slide-design_*.md` | ステップ3から開始 | | ||
|
|
||
| 各ステップは1つずつ実行し、出力後に次のステップへ進むか確認する。途中から再開する場合は、該当する接頭辞のファイルを入力として渡す。 | ||
|
|
||
| ## ステップ1: 内容整理 | ||
|
|
||
| メモや箇条書きを構造化されたMarkdownに整理する。Marpの記法やスライド枚数は意識せず、伝えたい内容の構造化に集中する。 | ||
|
|
||
| **入力:** メモファイル、資料の目的、対象者 | ||
| **出力:** `01_organized_[資料名].md` | ||
|
|
||
| 詳細な手順は [organize-content.md](organize-content.md) を参照。 | ||
|
|
||
| ## ステップ2: スライド設計 | ||
|
|
||
| 整理した内容をスライドに分割し、各スライドの構成を定義する。レイアウトや情報量を調整する中間成果物を作成する。 | ||
|
|
||
| **入力:** `01_organized_[資料名].md`、発表時間(任意) | ||
| **出力:** `02_slide-design_[資料名].md` | ||
|
|
||
| **発表時間とスライド枚数の目安:** | ||
| - 5分: 5〜8枚 | ||
| - 10分: 10〜15枚 | ||
| - 15分: 15〜20枚 | ||
| - 30分: 20〜30枚 | ||
|
|
||
| 詳細な手順は [slide-design.md](slide-design.md) を参照。 | ||
|
|
||
| ## ステップ3: Marp資料作成 | ||
|
|
||
| スライド設計書に基づき、Marp形式の最終資料を生成する。 | ||
|
|
||
| **入力:** `02_slide-design_[資料名].md` | ||
| **出力:** `03_marp_[資料名].md`(最終成果物) | ||
|
|
||
| 詳細な手順は [build-marp.md](build-marp.md) を参照。 | ||
|
|
||
| ## レイアウトクラス一覧 | ||
|
|
||
| | レイアウトクラス | 用途 | | ||
| |-----------------|------| | ||
| | title | 表紙 | | ||
| | section | セクション区切り | | ||
| | (指定なし)基本 | テキスト中心、箇条書きが主体 | | ||
| | image | 図表のみを大きく表示 | | ||
| | content-image | 図表とキャプション | | ||
| | content-image-right | 文章と図表を横並び(図が右) | | ||
| | content-image-left | 文章と図表を横並び(図が左) | | ||
| | column-layout | 複数項目を横並び | | ||
| | small-text | 情報量が多い場合の文字縮小 | | ||
|
|
||
| テンプレートとサンプルの取得方法は [get-sample-slide.md](get-sample-slide.md) を参照。 | ||
|
|
||
| ## ファイル命名規則 | ||
|
|
||
| | 接頭辞 | 説明 | | ||
| |--------|------| | ||
| | 01_organized_ | ステップ1の出力(整理済み) | | ||
| | 02_slide-design_ | ステップ2の出力(設計書) | | ||
| | 03_marp_ | ステップ3の出力(最終成果物) | | ||
|
|
||
| ## 反復的な改善 | ||
|
|
||
| 初回作成後、以下のサイクルで品質を高める。 | ||
|
|
||
| 1. スライド設計書を確認し、構成の過不足をチェック | ||
| 2. 必要に応じて整理済みmdを修正 | ||
| 3. 再度スライド設計書を生成 | ||
| 4. 問題なければMarp資料を生成 | ||
|
|
||
| ## トラブルシューティング | ||
|
|
||
| **スライド枚数が多すぎる:** | ||
| - 内容を絞り込む(整理済みmdを修正) | ||
| - 複数のスライドを統合する(設計書で調整) | ||
|
|
||
| **情報が1スライドに収まらない:** | ||
| - スライドを分割する | ||
| - 箇条書きを簡潔にする | ||
| - small-textレイアウトを検討(最終手段) | ||
|
|
||
| **レイアウトが思い通りにならない:** | ||
| - 最新のサンプルスライドを取得して確認([get-sample-slide.md](get-sample-slide.md)) | ||
| - `_class` のコメント記法が正しいか確認 | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
一度使ってみたところステップ1から3まで勝手に進んでしまいました。
そのためワークフローを人間のチェックを確実に入れるように修正した方がいいと思いました。
他にも少しだけ注意書きを増やしたほうがいいかもしれません。
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@yoshida-takeshi-classmethod
自分がテストした際は、一つずつ確認しながら実行してくれたんですけどね。。。
ちょっと実際の挙動を確認させてください。