s1b
開発文書の品質を高める一つの道
人の身になる
SWEST 2016平成28年8月25日(木) 21:00～22:30
ASDoQ（システム開発文書品質研究会）

システム開発文書品質研究会

Association of System Documentation Quality1プログラム
21:00 – 21:10
21:10 – 21:40
21:40 – 22:30
22:30 – 22:25
22:25 – 22:30
終了 22:30

システム開発文書品質研究会

１．オープニング
２．システム開発文書の課題
３．人の身になれない障害
４．人の身になるエクササイズ
５．クロージング

Association of System Documentation Quality

2

ASDoQ
名称

システム開発文書品質研究会

略称

ASDoQ (Association of System Documentation Quality)アスドック

Web

http://asdoq.jp/

種別

任意団体

設立

2011年7月11日

会員

個人会員（88名），法人会員（17社）（2016.7現在）

会費

原則無料

活動

定期研究会 ：

一年に3～4回技術発表，作業部会の報告

ASDoQ大会 ：一年に１度開催

ワークショップ：

特定のテーマを合宿で集中討議

作業部会

具体的な課題に取り組む．

システム開発文書品質研究会：

Association of System Documentation Quality

3

文書品質特性
品質特性(1)完全性(2)論理性(3)理解容易性(4)可読性(5)規範適合性
(1)

(2)

説明
開発に必要十分な情報が記載されていること
論理的に整合がとれていること理解しやすいこと読みやすいこと
記述が文法や規則に則していること
(3)

(4)

(5)

「認識」から「行為」に向けて，特性を段階的に割り当てる(1)は，システム開発文書として，特徴的な品質．
(2)-(5)は，多くの実用的な文書に共通する品質．

システム開発文書品質研究会

Association of System Documentation Quality4プログラム
21:00 – 21:10
21:10 – 21:40
21:40 – 22:30
22:30 – 22:25
22:25 – 22:30
終了 22:30

システム開発文書品質研究会

１．オープニング
２．システム開発文書の課題
３．人の身になれない障害
４．人の身になるエクササイズ
５．クロージング

Association of System Documentation Quality

5

システム開発文書の課題• システム開発文書とは– システム開発の過程で作成する文書の総称–例• 要求仕様書• アーキテクチャ設計書• ソースファイル（コメントを含む）• テスト仕様書• テスト報告書• 打ち合わせ議事録• プレゼン資料• 電子メール…
システム開発文書品質研究会

Association of System Documentation Quality6特に電子メールは悲惨です• システム開発には直接に関係ありませんが，以下は私が貰った電子メール（ホンモノ）の例です．
Title: これからもよろしくお願いします
山本さん
先日はありがとうございました。
●●ちゃんからメールを転送いただきました。
今度、ビールをたかりに伺います。
これから3年間（で卒業できると良いですが）、よろしくお願いします。
以上です。
演習

この電子メールがダメなところをリストアップしよう

システム開発文書品質研究会Association of System Documentation Quality

7

開発文書の課題を語りましょう

演習••••••••••
システム開発文書品質研究会

Association of System Documentation Quality

8

課題はどこにある• 私たちは，自分が書いた開発文書がワカラナイと後工程から言われます．
• それは，文書を書く力が低いからだと，自分では思っています．
• だから，国語の勉強をすれば良いと思っています．
• 確かに足りてませんが，それでも，私たちは，ある程度は書く能力を持っています．
• それよりも，後工程の人の身になる力と，自分の仕事をやりきる技術力が，遙かに不足しているのです．
• 文書として書くことで，「人の身になる力」と「技術力」が「とてもとても不足していること」が見える化したのです．
←そこそこある書く能力 ≧ 今持っている書く能力
人の身になる能力 ≫ 今持っている人の身になる能力 ←大いに不足
技術力 ≫ 今持っている技術力システム開発文書品質研究会

Association of System Documentation Quality9プログラム
21:00 – 21:10
21:10 – 21:40
21:40 – 22:30
22:30 – 22:25
22:25 – 22:30
終了 22:30

システム開発文書品質研究会

１．オープニング
２．システム開発文書の課題
３．人の身になれない障害
４．人の身になるエクササイズ
５．クロージング

Association of System Documentation Quality10人の身経験(成功/失敗)を語りあおう

演習

••
•
•
•
•
•
•
•
•
システム開発文書品質研究会

Association of System Documentation Quality11今日は，人の身になることを考えよう• 「優しい気持ちがあるから，人の身になれる」と，過信するのは止めよう．
• フランシスコベーコンは，ニンゲンは間違えがちであることを，４種のイドラで説明しました．
– 種族のイドラ– 洞窟のイドラ– 市場のイドラ– 劇場のイドラ

画像引用：Wikiペディア フランシスコベーコン• 人の身になって書くことはムツカシイ– そもそも，私たちは，書く能力はそこそこある．
– でも，「人の身に立てない」から，「技術力が不足してる」から書けない．
– 技術力の不足は仕方ない．でも，ボクには優しい気持ちがあるから人の身に立てると，ほとんどの人は考えている．
– それが，大いに，誤解．僕らは，間違いがちだ．もっと，謙虚になろう．
システム開発文書品質研究会

Association of System Documentation Quality

12いい加減なワタシに気づこう（１）• だってニンゲンだもの（種族のイドラ）• 私たちは，処理のコストを払わず楽をしようとする• 錯視
中央の丸はどっちが大きい？

図の引用元
wikiペディア エビングハウス錯視

僕らは，ぱっと見ての判断で，失敗してます
システム開発文書品質研究会

Association of System Documentation Quality

13いい加減なワタシに気づこう（２）• だってニンゲンだもの（種族のイドラ）• プロスペクト理論– 質問1:あなたの目の前に、以下の二つの選択肢が提示されたものとする。
• 選択肢A:100万円が無条件で手に入る。
• 選択肢B:コインを投げ、表が出たら200万円が手に入るが、裏が出たら何も手に入らない。

あなたは，どちらを選ぶ？
引用：Wikiペディア プロスペクト理論

システム開発文書品質研究会

Association of System Documentation Quality

14いい加減なワタシに気づこう（３）• だってニンゲンだもの（種族のイドラ）• プロスペクト理論– 質問2:あなたは200万円の負債を抱えているものとする。そのとき、同様に以下の二つの選択肢が提示されたものとする。
• 選択肢A:無条件で負債が100万円減額され、負債総額が100万円となる。
• 選択肢B:コインを投げ、表が出たら支払いが全額免除されるが、裏が出たら負債総額は変わらない。

あなたは，どちらを選ぶ？
引用：Wikiペディア プロスペクト理論

システム開発文書品質研究会

Association of System Documentation Quality

15いい加減なワタシに気づこう（４）• 本来は，どちらも期待値が同じはずだが，– 質問１：選択肢A． 質問2：選択肢B． の人が多い• プロスペクト理論の価値関数
価値200万円儲かるとうれしいが，100万円儲かるのもかなりうれしい．
ならば，確実に，100万円を狙おう．

参照基準点

損失

利得

何しろ，損は，嫌だ！
ならば，ギャンブルしてでも，損を０にしよう．
僕らはの，価値基準は曲がっている
システム開発文書品質研究会

Association of System Documentation Quality16いい加減なワタシに気づこう（５）• 見ているモノだけで満足してしまう（洞窟のイドラ）– それが，ほんの一部であっても– 幸せな無知• プラトンの洞窟

僕らは，あの人の一面しか見ていない
システム開発文書品質研究会

Association of System Documentation Quality

17いい加減なワタシに気づこう（６）• 他者の話を真に受けてしまう（市場のイドラ）• 特に，儲け話にはご注意あれ– 私たちは，損を嫌い，利得を目指すのでしたよね．
• 豊田商事「純金ファミリー契約証券」事件• 催眠商法– 狭い会場に人を集め、販売員が巧みな話術で場を盛り上げながら、「ハイ、ハイ」と手を上げさせるなどして、ただ同然で日用品などを配り、冷静な判断ができない高揚した雰囲気の中で高額な商品を売りつける商法です（国民生活センター）
僕らは「みんなが言っているからその設計が正しい」などと考えがちだが，間違っている
システム開発文書品質研究会

Association of System Documentation Quality

18いい加減なワタシに気づこう（７）• ヒトは権威に弱いのです（劇場のイドラ）• テレビ，新聞，雑誌，Web，ヒョーロン家，学説，学者，政治家，先生，先輩，上司，お客様，年寄り…
• 最近は，化けの皮がはがれている権威も多いです
が…．
「教育者なぜ不正」 伊賀、ウィッツ問題で地元説明会（中日新聞2016/6/18）
・・・ 説明会では、学校側が不正受給容疑が発覚した昨年十二月からの経緯を説明。 ・・・
学校や先生や学園経営者の権威が失墜
知事の権威が失墜
システム開発文書品質研究会

僕らは，先輩技術者の言うことは全て正しいと考えがち．
でも，実は先輩もチョンボをする．

Association of System Documentation Quality

19プログラム
21:00 – 21:10
21:10 – 21:40
21:40 – 22:30
22:30 – 22:25
22:25 – 22:30
終了 22:30

システム開発文書品質研究会

１．オープニング
２．システム開発文書の課題
３．人の身になれない障害
４．人の身になるエクササイズ
５．クロージング

Association of System Documentation Quality20人の身になり，ワタシを成長させよう（１）• 開発文書を書くコツは，人の身になること• でも，人の身になることは難しい．
• 謙虚になって，人の身になる練習をしよう．

新しい視点を持つ練習を繰り返す演習•

もし，○○だったら． というシミュレーションをする– もし，ワタシが，ワタシの上司だったら．
– もし，ワタシが，ワタシの部下だったら．
– もし，ワタシが，ワタシの発注先の担当だったら．
– もし，ワタシが，ワタシの受注先の担当だったら．
繰り返しやっていれば，徐々に分かってきます

システム開発文書品質研究会

Association of System Documentation Quality21人の身になり，ワタシを成長させよう（２）• 異文化交流をする– よその会社は，どう考えている– 違う年代のヒトは，どう考えている– SWESTは，良い機会
演習 • 開発文書の使われ方に違いがあるか，話し合おう• 違う工程を体験する– 設計者ならば• 実装してみよう• 要求仕様を書いてみよう• モジュールテスト仕様を書いてみよう• 発注仕様書を書いてみよう
システム開発文書品質研究会

Association of System Documentation Quality22人の身になり，ワタシを成長させよう（３）受容・共感・一致（ロジャーズ派カウンセリング）の練習をする– 体で表現：うなずき，呼吸を合わせる..
– 言葉で表現：相づち，言い換え…
• 意識的に，仕事で傾聴を練習する– お客様のご要求を傾聴する• ステレオタイプな考え方を止める– 「○○は△△だから××だよね」を，禁句にする．
– 帳票に従う仕事をせずに，自分で帳票を作る– 規則を疑う演習•

システム開発文書品質研究会

Association of System Documentation Quality23人の身になり，報告書を考えよう

演習• 誰かが決めた報告書帳票なんて，クソ食らえ．報告書を読む人の立場に立ち，書くことを考え直そう．
• SWESTの報告書を書くことを想定してください．
• 誰が読みますか？
• 役職は，年齢は，男女の別は，口癖は…
• その人は，どんなことを知りたがっていますか？
• その人に提出しよう– 中身には，どんな項目を書きますか？
– どのくらいの量ですか？何時までに書きますか？
– 書き方の工夫は？
システム開発文書品質研究会

Association of System Documentation Quality

24