Claude Code Skills を使ったドキュメント更新運用

Claude Code の Skills を使ったドキュメントの更新運用についてチームで行っているものを紹介しました

Transcript

1. Claude Code Skills を使った ドキュメント更新運⽤
2. Agenda 01 ⾃⼰紹介 02 ドキュメント運⽤で抱えていた問題 03 課題解決のために作成したもの 04 総評‧まとめ 2
3. 01 ⾃⼰紹介
4. ⾃⼰紹介 About me 2024/12/01 ~ Belong join サウナが好き Role フルスタックエンジニア Skills Python Go mani (Masato Ohinata) Security
5. Belong Product Map 中古スマホのEnd to Endサービスを提供することで、透明性の⾼い世界を⽬指しています。 端末調達 検品 利⽤ 国内B2C 法⼈様から オペレーションセンター 買取サービス 端末の検品からデータ消去、配送まで対 応 国内B2B 個⼈様から ⼊荷 検査 消去 差配 中古スマホ価格分析プラットフォーム 海外 海外拠点から リサイクル 5
6. Belong Product Map 中古スマホのEnd to Endサービスを提供することで、透明性の⾼い世界を⽬指しています。 端末調達 検品 利⽤ 国内B2C 法⼈様から オペレーションセンター 買取サービス 端末の検品からデータ消去、配送まで対 応 国内B2B 個⼈様から ⼊荷 検査 消去 差配 中古スマホ価格分析プラットフォーム 海外 海外拠点から リサイクル 6
7. 02 ドキュメント運⽤で抱えていた問題
8. Belong で発⽣するドキュメント作成のフロー
9. ドキュメント運⽤で抱えていた問題 • 書き⼿が⾜りていない • テクニカルライターがいないため、本⼈が書くしかない • 構成‧粒度等の判断に時間がかかる • 更新作業が億劫 • リリースのたびに更新が発⽣する • どのページを直すかを探す必要がある • 書く対象が特殊 • 倉庫独⾃の⾔語や表現がある • 単語帳の拡充が必要
10. ドキュメント作業は 新規作成 と 更新 の2種類 主に 新規作成 と 更新 • 新機能の実装 ⇨新規ページとして作成していく • 既存機能の仕様変更 ⇨既存ページの内容を更新していく • サービスのドメイン知識を書き留める ⇨新規ページとして作成し、仕様変更があれば更新する
11. どうにかして AI を使って 楽をしたい
12. ドキュメント運⽤を AI でやる場合 • 期待できること • 正しい⽇本語を⽣成してくれそう • (更新) どのページを編集すべきか洗い出すのはできそう • (更新) コードベースから更新内容の出⼒はできそう • 不安なこと • AI が⽣成する⽂章では正確性に⽋ける？ • 具体的なドメイン知識‧ユビキタス⾔語の表現はできるのか？
13. ドキュメント運⽤を AI でやる場合 ⾊々試してみた結果‧‧‧ 新規作成 ⇨正確なドメイン知識と⽣成物にずれが⼤きい ⇨1ページあたりの情報量が⼤きすぎる 更新 ⇨更新すべきページの洗い出しは正確 ⇨細かい調整で済むため、ある程度正確
14. ドキュメント運⽤を AI でやる場合 ⾊々試してみた結果‧‧‧ 新規作成 ⇨正確なドメイン知識と⽣成物にずれが⼤きい ⇨1ページあたりの情報量が⼤きすぎる 更新 ⇨更新すべきページの洗い出しは正確 ⇨細かい調整で済むため、ある程度正確
15. 03 課題解決のために作成したもの
16. Skills とは？ Skills は任意のコンテキストをロードできる再利⽤可能な コンテンツです ↓ 同じ作業を複数回実施する場合、スキルを作成することで 作業効率化を実現できる ex) コードレビュー‧デイリーの作業 引⽤：https://code.claude.com/docs/ja/skills
17. 課題解決のために作成したもの ドキュメント更新をサポートする Skills • 更新すべき Notion ページの特定 • コードから更新内容の⽣成 • レビュー画⾯にて更新前後の表⽰
18. 処理の流れ
19. 処理の流れ
20. 処理の流れ
21. 処理の流れ
22. 処理の流れ
24. 処理の流れ
25. 04 総評‧まとめ
26. 総評 • ドキュメントの軽い更新程度なら AI でも問題はない • ⽣成する⽂章は怪しいことが多いのでレビューは必須（？） • リリースのたびに発⽣する作業の負担の軽減には成功している • 記⼊漏れや更新漏れが起きない • ただし、⼈間の書く能⼒は必要 • AI の出⼒のレビュー • AI なしでもいいドキュメントを作れるようにすべき
27. We Are Hiring!!! 各種エンジニア採⽤中です！ カジュアル⾯談はこちらから 会社概要はこちらから
28. Connpass イベントもやります！ https://belong.connpass.com/