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
手順書を作るときに意識していること
Search
hikari
December 14, 2024
Business
200
0
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
手順書を作るときに意識していること
2024/12/14 Kawaii♡LTで発表した資料。
hikari
December 14, 2024
Transcript
17 slides
手順書を作るときに意識している こと 2024/12/14 Kawaii♡LT
自己紹介 • 影中 光(かげなか ひかり) • 自社製品のWebサービス開発 • JAZUG for
Women運営 • 好きな服:膨らんでるスカート。クラシカルなもの。華ロリ。 • X(旧Twitter):@_mi_lin_
今日の目的 • 手順書を作るときに意識していること紹介すること! • 対象→チーム内で属人性を排除するために共有する手順書 • 対象外→製品マニュアル、仕様書など ひとつでも参考になる ことがあったら嬉しい!
手順書作成時に考えていること 頼む~~~~~ 伝わってくれ~~~~~ ~~~!!! これを言語化してみた
トピック • 前提の意識 • 文章で気を付けていること • 構成で気を付けていること
前提の意識 • 自分の言語能力はとても低いと自覚する!(実際がどうかは関係ない • 何も対策せずに話すと5人中1人にしか伝わらないと思う。 • 5人中5人に伝わることを目指す。 • 伝わるように伝えるのが伝える側の責務。 •
「伝わらないのは受け手側の問題だ!」はなし。 • 伝わらなければ何も伝えてないのと一緒。 手順書に限らず、 報告・連絡の文章も同じく 意識します
手順書とは 誰がいつ見ても同じ作業ができるもの 【イメージする人】 ・未来の自分 ・初めてチームに参加する 人 【イメージする時】 ・やろうと思ったときに手順 書を開けばできる ・事前準備不要
文章として気を付けていること • 複数の解釈が生まれないように書く • 1文をシンプルにする
複数の解釈が生まれないように書く • 対象が一意に特定できるように書く • 代名詞や指示語は使わない • 文脈でわかることも端折らない • 例) ×サインインする。
〇GitHubのアカウントでサインインする。
一文を短くする • 目的語と述語を明確にする • 「何を何する」の羅列だけでいい • 補足や注意事項などは文章を分ける
構成として気を付けていること • 目的 • 前提条件 • 自分がやった作業をトレース • 付録
目的を書く • 書き手側のメリット • 書く内容の指標になる • 「何のために書いてるんだっけ?」がなくなる • 読み手側のメリット •
何のための手順かが分かりやすいと心構えができる
前提条件を書く • 手順を実施するうえで必要な環境・準備を書く • 自分のチーム向けだとあんまり意識しない • チーム外に渡す手順書の場合、誰がどんな環境で実施するかわからないので 必須 • 例)実施するアカウント情報、デバイス情報、必要な資材
自分がやった作業をトレースする • 同じ作業が再現できるようにする • 情報の粒度が大→中→小になるようにする • 作業時に取得したキャプチャがあると楽 • 言語優位な人だけでなく、視覚優位な人にも伝わりやすくなる
付録をつける • 実際に使用したファイルなどがあれば添付する • 例)CSVファイル、SQLクエリ
最後まとめ • 伝わるように伝えることを意識する • 複数の解釈が生まれないようにする • 端的に書く • 目的、前提条件を忘れない
ご清聴ありがとうございました
More Decks by hikari
See All by hikari
20261111_AgileJapan2026前夜祭s
kgnkhkr
0
58
20261024_スクラム祭り三島
kgnkhkr
1
590
20260912_スクフェス三河
kgnkhkr
0
560
20260819_PBL Pub
kgnkhkr
0
200
20260801_スクフェス大阪
kgnkhkr
3
2.6k
20260711_スクフェス仙台
kgnkhkr
1
420
NakiNaviの紹介
kgnkhkr
0
64
セキュリティ対策はじめました。 ~やったこと紹介~
kgnkhkr
0
340
Webサービスのためにクラウドにしていること(20230723CodePolaris)
kgnkhkr
0
300
Other Decks in Business
See All in Business
インキュデータ会社紹介資料
okitsu
3
62k
GMOフィナンシャルホールディングス_会社紹介資料202611.pdf
gmofh_hr_team
0
11k
ピティナ・東音企画 採用資料
ptna_
0
470
PLAINER 会社紹介資料
plainer
0
430
公共ライドシェア事例集
mobilitytechnologies
0
1.2k
데이터 분석가의 커리어 설계
datarian
0
300
Avoiding the "Bad Training, Faster" Trap in the Age of Al
tmiket
0
790
DiSC®研修|相互理解とチームづくり+ミニチームコーチング
chibanba1982
0
160
地域は小さな地球|Future Fieldwork Report 2026
kitchhike
0
4.1k
株式会社スマートゲート |カルチャーデック
smartgate
0
220
01_全社_FLUX採用ピッチ資料_Ver.5.9
flux
13
230k
2026 Fuji Oil Outside Directors’ Roundtable (English version)
tsogo817421
2
340
Featured
See All Featured
Designing for humans not robots
tammielis
254
26k
Java REST API Framework Comparison - PWX 2021
mraible
34
9.8k
Bash Introduction
62gerente
615
220k
Primal Persuasion: How to Engage the Brain for Learning That Lasts
tmiket
0
520
Agile that works and the tools we love
rasmusluckow
331
22k
How to build an LLM SEO readiness audit: a practical framework
nmsamuel
2
990
GitHub's CSS Performance
jonrohan
1033
470k
Claude Code のすすめ
schroneko
67
230k
ピンチをチャンスに:未来をつくるプロダクトロードマップ #pmconf2020
aki_iinuma
128
56k
Exploring the relationship between traditional SERPs and Gen AI search
raygrieselhuber
PRO
4
4.4k
Redefining SEO in the New Era of Traffic Generation
szymonslowik
1
530
Exploring anti-patterns in Rails
aemeredith
4
570