Conversation
workflow-README.md
Outdated
| @@ -0,0 +1,276 @@ | |||
| # Marp資料作成フロー | |||
There was a problem hiding this comment.
このスキル達の目的はmarpのスライドを作成することなので一つにまとめられると思います。
こちらのベストプラクティスに従ってまとめていただきたいです
https://arc.net/l/quote/akyosrwp
marp-creatorという一つのskillにまとめるときの例(名前は自由でOKです)
.claude/
└─ skills/
└─ marp-creator
├─ organize-content.md
├─ slide-design.md
├─ build-marp.md
├─ get-sample-slide.md
└─ SKILL.md
| @@ -0,0 +1,375 @@ | |||
| --- | |||
There was a problem hiding this comment.
サンプルスライドはアップデートにより変更されるかもしれないので最新のデータを取得するようにしていただきたいです
curlコマンドを利用すると公開されているサンプルスライドのコメントまで全て取得できるようになります
取得の指示の例
## テーマのサンプルスライドの取得方法
必ずこのコマンドを実行してサンプルスライドを取得してください。
curl -s https://raw.githubusercontent.com/classmethod/classmethod-marp-theme/main/sample-slide.md
There was a problem hiding this comment.
https://github.com/classmethod/classmethod-marp-theme/pull/1/changes#r2814703488
このコメントと同じでget-sample-slide.mdのような取得方法の記載をしたファイルを作るといい気がします(参考程度で🙏)
概要marp-creatorスキルをClaude Codeのベストプラクティス(段階的開示パターン)に従って再構成しました。 参考: https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/best-practices 変更内容1. SKILL構成の統合3つの独立したSKILLフォルダを1つに統合しました。 変更前:
変更後:
2. その他の変更
確認してほしい点
|
ShuntaToda
left a comment
There was a problem hiding this comment.
修正ありがとうございます。
追加で一点だけコメントしました
| ## ワークフロー | ||
|
|
||
| 3つのステップで資料を作成する。 | ||
|
|
||
| ``` | ||
| メモ・要件(任意の形式・ファイル名) | ||
| ↓ | ||
| [ステップ1] 内容整理 → 01_organized_*.md | ||
| ↓ | ||
| [ステップ2] スライド設計 → 02_slide-design_*.md | ||
| ↓ | ||
| [ステップ3] Marp資料作成 → 03_marp_*.md(最終成果物) | ||
| ``` | ||
|
|
There was a problem hiding this comment.
一度使ってみたところステップ1から3まで勝手に進んでしまいました。
そのためワークフローを人間のチェックを確実に入れるように修正した方がいいと思いました。
他にも少しだけ注意書きを増やしたほうがいいかもしれません。
メモ・要件(任意の形式・ファイル名)
↓
[ステップ1] 内容整理 → 01_organized_*.md
↓
※ ユーザー確認(内容の過不足、構成の修正)
↓
[ステップ2] スライド設計 → 02_slide-design_*.md
↓
※ ユーザー確認(スライド構成、レイアウト、枚数)
↓
[ステップ3] Marp資料作成 → 03_marp_*.md(最終成果物)
There was a problem hiding this comment.
@yoshida-takeshi-classmethod
自分がテストした際は、一つずつ確認しながら実行してくれたんですけどね。。。
ちょっと実際の挙動を確認させてください。
Summary
追加内容
ワークフロードキュメント:
workflow-README.md: フロー全体の説明、SKILLSの使い方、フォルダ構成例Claude Code SKILLS:
organize-content: メモや箇条書きを構造化Markdownに整理(ステップ1)slide-design: 整理済み内容からスライド設計書を作成(ステップ2-A)marp-creator: 設計書に基づきMarp形式のスライドを生成(ステップ2-B)想定される利用シーン
提案書や勉強会資料の作成時に、内容の整理とスライド化を分離して進められる。各工程でフィードバックを受けやすく、品質を段階的に高められる。