Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
Claude Code本は、どのように執筆チームで書かれたか
Search
Oikon
October 09, 2026
Technology
480
1
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
Claude Code本は、どのように執筆チームで書かれたか
AI駆動開発勉強会 名古屋支部#2
https://aid.connpass.com/event/404553/
Oikon
October 09, 2026
Transcript
18 slides
Claude Code本は、 どのように執筆チームで 書かれたか Oikon @oikon48 AI駆動開発勉強会 名古屋支部#2 2026 /
10 / 09
自己紹介 Oikon @oikon48 ― Software Engineer / 個人開発 ― Claude
Code歴: 2025年3月〜 ― XとブログでClaude Codeについて発信 ― Software Design 2026年2月号 寄稿 ― 『Claude Code実践入門』共著 共著者: 前川蒼さん(@MaekawaAo)
今日話すこと Claude Code本の執筆リポジトリの中で、 チームとAIがどう動いていたか
出版までの流れ 〜 月 02/13 04 05 リポジトリ作成・企画 07/12 執筆とレビュー(PR) 月
03 目次を固めて執筆開始 08/14 発売 再校 06/05 初校が届く 06/10 外部レビュアーに 配付 07/21 最後の原稿更新
執筆チームの顔ぶれ 著者 編集者・レビュアー Oikon @oikon48 リードオーサー 前川 蒼 @MaekawaAo KDDIアジャイル
開発センター 名 2 編集者 Claude Code レビュアー Devin SBクリエイティブ 企画会議、 PRへのコメント、 ゲラの返却 〜 KAG社内+外部識者 名 初校PDFを 13 16 AI 2週間でレビュー AIエージェント① 調査・整理・成形、 原稿レビュー、 校正の差分チェック Devin AIエージェント② サンドボックスで ターミナルを操作し、 スクショも撮る
GitHubのMarkdownで原稿を管理 claude-code-book/ CLAUDE.md .md .md article/NN/manuscript.md figures/ proofs/NN/v1/ PDF handson/
.claude/rules/ .claude/skills/ .github/workflows/ prh.yml tests/ ├── ├── 目次案 ・ 執筆分担 ├── ← 原稿 │ └── ├── ← ゲラ ・赤字 ├── ├── ├── ├── └── ・ 原稿は Markdown、レビューは Pull Request。書籍の執筆を開発と同じ形にした
Claude Codeの書籍を書くなら、Claude Codeを活用しよう (原文の抜粋) CLAUDE.md Claude Code は文章の調査・整理・成形を 担い、書きたい内容は著者がコントロール する
― 著者が思ってもいない内容を勝手に生成しない ― 原稿を書く前に、まず著者と壁打ち・すり合わせ を行う ― 著者の指示なく、節の追加・削除・大幅な構成変 更を行わない の役割 = 執筆サポーター 著者が書きたい内容をコントロールし、Claude Code は 文章 の調査・整理・成形を担う 立場。 - 著者が思ってもいない内容を勝手に生成しない - 原稿を書く前に、まず著者と十分に 壁打ち・すり合わせ を 行う - すり合わせた内容を、既存の文体に合わせて仕上げる - 判断に迷う箇所(技術的な解釈、表現の選択など)は必ず著 者に確認する - 著者の指示なく、節の追加・削除・大幅な構成変更を行わな い ## Claude Code
文体ルールをリポジトリに置く 出版社の執筆ルール authoring-style.md anti-ai-writing.md 全角/半角の区切り、 和欧間スペース、「カ月」 など 装飾、DTPの制約、 memo/point/Column 修辞構文・長文・抽象表現・
NGフレーズ集 SBクリエイティブの 編集方針も同じ場所に です・ます調、 表記・用語の統一 エージェントに判断してもらう文体ルールを設定する エージェントの原稿PRレビューの際に使用され、 執筆方針をある程度チームで揃える AIくさい文体を 避けるルール
修正作業①:機械判定 機械判定でできる作業は、わざわざAIエージェントに任せなくて良い $ npm run lint → GitHub → VS
Code 全て → すべて Github VSCode $ npm test ルール自体の回帰テスト 検出されること 誤検知ゼロ should-detect.md should-skip.md
修正作業②:文脈判定 PR ごとに自動でレビュー GitHub Actions PR にコメント Pull Request →
Claude が差分と前後の文脈 → 提案であり、 原稿の変更で起動 を読む manuscript-review.yml merge は止めない 手元で実行:/manuscript-review PARALLEL ×4 ファクトチェック 原稿 → 文体レビュー コンテンツ網羅性 技術的整合性 統合 原稿に埋め込む → rule source → <!-- TODO --> を確認
アップデートの追従: 書籍の修正提案をIssueで受け取る Claude Codeのアップデートがあるたびに、章ごとの反映検討タスクを自動で起票させる ― アップデートを検知したら、章・節を特定して提案・起票 ― 著者ラベルで担当を自動振り分け Claude Codeから自動で書籍の更新が提案される中で、書籍の鮮度が維持できる変更を判断して、
原稿をアップデートしていく
Pull Request ゲラの返却が Pull Request 編集部の修正が原稿リポジトリに直接届く Issue #23 表記揺れの統一を相談 2段判定(prh
/ Claude)の方針はここで合意 Issue #72 図の補足方法を相談 清書はイラストレーター、指示は著者
赤字はPDFの注釈 (XFDF)でやり取りする 注釈だけを XML で取り出せるので、git で差分管理で きる XFDF の中身(1件の注釈) <xfdf
xmlns="http://ns.adobe.com/xfdf/"> <annots> <highlight page="11" title="Oikon"> <contents> </contents> </highlight> </annots> </xfdf> 「下さい」→「ください」に統一
None
うまくいかなかったこと 01 AIレビューの誤った指摘 ルールにない修正を自動適用。 以降、根拠を示せない指摘は提案止まりに 02 校正の往復で、 03 ハンズオンはAIの出力がブレる 完成コードは置かず、
入力と期待する出力の方向性を示す 04 細かい点に気づきすぎて、 ゲラと原稿がズレる MDとPDFの同期作業の調整が必要だった 編集部を困らせる AIと一緒だと、瑣末な点も気づいてしまう
02/13 → 07/21 期間 Commit Pull Request 352 266 Issue
原稿 初校の赤字 312 約 約 5 か月 32 万字 約 2,000 件
まとめ: 著者・編集・AIエージェントのチームでの執筆作業 AIの役割と権限を、コンテキストとシステムで決める 02 執筆ルールは個人の頭ではなく、リポジトリにあるものを是とする 03 AIの判断には根拠を求め、最後は人間が決定する 01 執筆も開発も、似たようなアプローチが可能
個人の使い方から、 チームの使い方へ Claude Code実践入門[生成AI深掘りガイド] Oikon / 前川 蒼 ・ SBクリエイティブ
・ 2026/08/14 発売 おかげさまで1万部! sbcr.jp/product/4815643119/
More Decks by Oikon
See All by Oikon
Claude Codeから見る、エンジニアの世界の変容とその先
oikon48
8
5.9k
Claude Code本って、 読む必要あるの?
oikon48
2
830
Claude Codeの体系的な理解と知識のフック
oikon48
10
9k
変化の早いClaude Codeを 書籍に落とし込む
oikon48
7
2.1k
Claude Codeとハーネスについて考えてみる
oikon48
21
11k
Claude Codeをどのように キャッチアップしているか
oikon48
15
12k
Everything Claude Code を眺める
oikon48
15
14k
(Test) ai-meetup slide creation
oikon48
4
950
Claude Code 2026年 最新アップデート
oikon48
17
14k
Other Decks in Technology
See All in Technology
攻撃と守りは何が変わり、何が変わらないのか~最近の不正アクセスから考える、リスク評価と標準の使いどころ
oidfj
2
260
さようならSSH鍵、こんにちはゼロトラスト ― AIフレンドリーで快適な自宅鯖SSH
atalie2m
14
7.3k
Test Impact Analysis を武器に立ち向かう、AI 時代のテスト増加に対するヌーラボのアプローチ / getting-started-datadog-test-impact-analysis
k6s4i53rx
0
270
農家は秘伝のタレを知らない - NOBODY KNOWS THE HIDDEN SOURCE - Kaggriculture 3rd Place Solution
masspeaks
3
640
cdkdがどんだけ早いか、実際に動かして見てみよう
smt7174
1
140
クラウドでも使えるNetApp -現場目線での設計とクラウドバックアップの活用
ryutakondo
1
190
ノードが消える前提で設計する!Karpenterで金融システムを止めないためのノウハウ大全
daitak
1
160
市販IoT機器や自作IoT機器とHomeAssistantを駆使して家の電気代をできる限り見える化する方法の考案
harutiro
0
400
AIエージェントのアーキテクチャ設計
nsatoh
0
340
IP重複は"ランディングVPC"で受け止める ― PrivateLink と Transit Gatewayによるマルチテナント接続基盤の設計
hatahata021
3
250
E2E Test というハーネス — AI時代の自動テスト民主化
daishukojima
10
5.9k
HTTP通信に使おうとすると実はめんどくさいfile_get_contents
maguroalternative
0
230
Featured
See All Featured
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
irinanazarova
9
1.7k
The Web Performance Landscape in 2024 [PerfNow 2024]
tammyeverts
12
1.4k
Future Trends and Review - Lecture 12 - Web Technologies (1019888BNR)
signer
PRO
0
3.8k
For a Future-Friendly Web
brad_frost
184
11k
Building Experiences: Design Systems, User Experience, and Full Site Editing
marktimemedia
1
670
The SEO Collaboration Effect
kristinabergwall1
1
620
Building Adaptive Systems
keathley
44
3.3k
What’s in a name? Adding method to the madness
productmarketing
PRO
24
4.2k
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
panda_program
123
22k
How Fast Is Fast Enough? [PerfNow 2025]
tammyeverts
3
980
The Power of CSS Pseudo Elements
geoffreycrofte
82
6.6k
Leveraging Curiosity to Care for An Aging Population
cassininazir
1
570