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
見やすい PRを作るために取り組んでいること
Search
Sponsored
·
Your Podcast. Everywhere. Effortlessly.
Share. Educate. Inspire. Entertain. You do you. We'll handle the rest.
→
takf
July 12, 2026
Programming
87
0
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
見やすい PRを作るために取り組んでいること
takf
July 12, 2026
Transcript
10 slides
2026/07/10 Tamagawa.dev #2 見やすいPRを作るために 取り組んでいること
自己紹介 Furuichi (@takfjp / takf-jp) 株式会社カンリー 所属 フロントエンドがメインでしたが今はGoを書いて(書かせて)います 最近の興味はQAとシフトレフト
こんな経験ありませんか? 1 LLMが書いた文章が「わかりづらい」と言われる 2 レビューする時、どこから読めばいいかわからない 3 AIでそれっぽく作れたのに、読むと何を言ってるか不明 → 今日は、これを減らすために 自分が実際にやっていること
について話します
例1 「Fable5のすごい点を普段 AIを使わない人に伝えたい。イ ラストを使ってキャッチーに、わかりやすく。」 「それっぽい」けど、伝わらない 例2 「GPT-5.6のすごさをフリーランスで仕事をしている人に伝 えたい。インパクトのでかいスライドで!」
何がいけないのか PRに置き換えると? 論理が繋がっているか怪しい変更理由 変更量が多く、冗長なコードが紛れ込む PR Description が長すぎて要点がわからない ここがいまいち 単語の意味が不明瞭、文章がいまいち とにかく情報が多い
本当に言いたいことが伝わってこない
わかりづらさを生む 3つの要素 1 自動化バイアス AIの出力を鵜呑みにする。 「それっぽい」だけで満足してしまう。 2 認知的負荷 情報量がワーキングメモリを圧迫。 量に押されて質を評価できない。
3 非注意性盲目 無いと思っているものは探さない。 欠落や冗長を見落とす。 これらが複合して「わかりづらいPR」ができあがる
・PRの意図を自分の言葉で説明できるように整理する ・コーディングをエージェントに任せても変更は自分の責任で出す Q1 この変更って、こういう意図で合ってる? Q2 Issueを達成する“別の方法”があるとしたら?なぜこのやり方? Q3 自分に意地悪な質問をしてみて! ①実装エージェントに質問する 取り組んでいること
②見せ方を変える 差分をアーティファクトで出力 ・Markdown / CLI出力より見やすい ・ファイル単位でまとめる/ Diff表示など 用途に合わせてカスタマイズできる ・Markdownファイルのプレビューは Zed
で行ってエディタと用途 を差別化 ※左は架空のPR 取り組んでいること
取り組んでいること ③複数の目を通す 複数エージェントにレビューさせる } 実装担当のほかに、3つのペルソナを用意: 担当領域のスペシャリスト 「悪魔の代弁者」(全部を間違いと前提) 実装とドキュメントの乖離を見逃さない役 6 /
8 ・相互にレビュー ・MUST / IMO / ASK / NITS でランク付 ・それぞれの指摘事項はどのエージェントによるか記録 ・ これもアーティファクト出力して指摘内容を自分で精読
それでも残る課題 加えた変更への記憶があやふや エージェントに任せすぎて、 自分の実装への解像度が落ちている 根本的な問題を指摘される PRを作る時点で本質的な問題を理解しておらず、 設計レベルの指摘が生まれる → ツールを入れても、これが起きる 7
/ 8 「他人が読んでわかるPR」を作るため、 「自分が理解できる PR」をまず目指そう
More Decks by takf
See All by takf
Go未経験・MVC脳のエンジニアが オニオンアーキテクチャを学ぶまで
takfjp
0
56
Denoに入門していきなりAleph.jsを触ってみた
takfjp
0
560
Atomic Design とテストの○○な話
takfjp
2
2k
Node.jsのアップグレードで気をつけたこと
takfjp
1
3k
FARM スタックに触れてみる
takfjp
0
1.7k
React Testing Library の Query について整理してみた
takfjp
0
590
React.js 消えるライフサイクルメソッドについて
takfjp
0
180
Laravel 初めての業務で遭遇したハマりポイント×2
takfjp
2
3.2k
React で Stateless Functional Component の書き方を盛大に間違えていた話
takfjp
0
470
Other Decks in Programming
See All in Programming
エラーチャンネルのボールを拾い続けて鍛えるエンジニアの地力 / phpcon-niigata2026
meihei3
1
400
Enforcing Your Architecture with Unit Tests in the AI Era (Swift Connection X)
steliosf
PRO
1
180
AI駆動開発4年目の現在地(『あなたはFDEになるべきか?』イベント資料)
kumaiu
0
650
社内AIエージェント「Askワンバン」における コストチューニングの取り組み
t0yohei
0
170
Rails初心者がパスキーを実装してみて大変だったこと
ktombow
0
210
LLM 101: Exploring LLMs, Starting with Tokens.
dalinaum
0
110
Vapor Mode でアクセシビリティは 壊れないか検証した話
fuqda
1
350
AIコーディング時代のKotest ユニットテストから APIレベルの仕様固定化テストへ
ooga04
0
220
graphql-ruby を Spinel で速くしようとした話
mtsmfm
0
150
コード生成時代のAPI定義を支えるRequest Spec移行
pvcresin
0
220
疎結合とは何か?ソフトウェア設計における結合バランスについて考える #phpcon_niigata
kajitack
2
290
AIが実装を担う時代の「技術設計」と「チームマネジメント」
kamina_zzz
2
270
Featured
See All Featured
Future Trends and Review - Lecture 12 - Web Technologies (1019888BNR)
signer
PRO
0
3.8k
Fireside Chat
paigeccino
43
4.1k
The Art of Delivering Value - GDevCon NA Keynote
reverentgeek
16
2.2k
Max Prin - Stacking Signals: How International SEO Comes Together (And Falls Apart)
techseoconnect
PRO
0
530
Java REST API Framework Comparison - PWX 2021
mraible
34
9.8k
Facilitating Awesome Meetings
lara
57
7.2k
Scaling GitHub
holman
464
140k
The Illustrated Children's Guide to Kubernetes
chrisshort
51
53k
Understanding Cognitive Biases in Performance Measurement
bluesmoon
32
3.1k
Context Engineering - Making Every Token Count
addyosmani
9
1.3k
Visualization
eitanlees
153
17k
The Psychology of Web Performance [Beyond Tellerrand 2023]
tammyeverts
49
3.6k