納品物要件チェック は何をしますか？
ライセンス: CC BY 4.0 で公開 — 帰属表示のもと、自由に使用、改変、共有できます。
手元にある納品物リストは「義務」の主張であって、その証明ではありません。 リストが一貫性を持ち、正しい用語を使用し、実在のアーティファクトのみを挙げていても、資金提供者が実際に義務付けている項目をすべて見落とし、誰も要求していない作業で残りを埋めている可能性があります。そのもっともらしさこそが危険です。なぜなら、受け取った人はすべての行を生産することを約束しようとしているからです。
このスキルが各項目に問う質問は、「これは実在するものか？」ではなく、「誰がこれを要求しているのか、そしてその根拠を引用できるか？」 です。答えが「誰もいない」場合、それを指摘することは「発見」であって、「埋めるべきギャップ」ではありません。
使用するタイミング
- 誰かが手元にリストを持っている（テンプレート、ベンダー、コンサルタント、フレームワーク、またはAIから）場合、それを採用するか追跡するかを決定しているとき。
- 作業が、独自の要件、テンプレート、またはチェックリストを公開している団体によって資金提供、規制、または監督されている場合。
使用しない場合: 何もない状態からリストを作成する場合（代わりに資金提供者のテンプレートから始めてください）、または完成した文書の品質をレビューする場合。
方法
1. 提供されたリストをそのままカタログ化する
各項目を提供されたとおりに番号付けします。まだマージ、名前変更、追加は行わないでください。リストの出典と日付を、わかれば記録します。
2. 統治元の情報源を入手し、それを読む
誰が作業に資金を提供し、規制し、承認するかを特定します。実際のテンプレート、チェックリスト、またはガイダンスを入手し、そのセクションリストを読んでください。 そのようなテンプレートが「おそらく」含まれているだろうという推測に基づいて判断しないでください。要件は、下流の要約には記載されない発効日に変更されるため、原文書が唯一の信頼できるチェック手段です。各情報源のタイトル、バージョン、日付を記録します。
統治元の情報源にアクセスできない場合は、その旨を述べ、それに依存するすべての結論を、その時点で暫定的なものとしてマークします。
3. 各項目に1つの権威値をタグ付けする
| タグ | 意味 | 必要な証拠 |
|---|---|---|
| 資金提供者 | 資金提供または監督機関が要求するもの | テンプレートセクション、ガイダンス条項、または助成条件 |
| 法律/規制 | 法律または規制が要求するもの | セクションへの引用 |
| 特定の人物 | 特定の人物が特定の日付に要求したもの | 誰が、いつ |
| 標準的な慣行 | 一般的で有用かもしれないが、要求する権威が見つからなかったもの | 何を検索したか |
「標準的な慣行」は正当な結果であり、失敗ではありません。また、プロジェクトに存在しない組織や役割に依存する項目（例えば、リリース署名委員会が存在しないプロジェクトでそれを前提とする項目）がある場合は、それもフラグします。
4. 別のパスでギャップを見つける
ステップ3の後でのみ、統治元のテンプレートをセクションごとに読み進め、提供されたリストから漏れている必須項目をそれぞれリストアップします。追加された行は、提供された行と視覚的に分離して表示し、誰がどの行が情報源からのもので、どの行が分析によって導入されたものかを区別できるようにします。追加は情報源が要求するものに限定し、検討したが却下したものは、その理由とともに記録します。追加された各行は、人に課される作業です。
5. 出力
- テーブル: 項目 · 情報源（提供/追加） · 権威タグ · 引用または証拠 · 備考（存在しない組織に依存、別の項目と重複など）。
- 削除 / 維持 / 追加:
- 削除: 要求する権威がなく、チームが不要とする標準的な慣行項目。それぞれを削除する理由を述べてください。
- 維持: 引用された権威がある項目、およびチームが維持することを選択した標準的な慣行項目（選択としてラベル付け）。
- 追加: リストから欠落している必須項目で、それぞれに引用を添えて。
- 参照した情報源: 各統治文書のタイトル、バージョン、日付、およびアクセスできなかったもの。
例（一般的なもの）
オープンソースライブラリがソフトウェア寄付を受ける際、コンサルタントから17項目の「標準リリース文書」リストを渡され、設計、構築、リリース、メンテナンスにグループ化されています。寄付自体のマイルストーンテンプレートを読むと、5つの必須納品物が示されています。そのうち2つは異なる名前でリストに含まれています。3つはまったくリストに含まれていません。提供された17項目のうち、2つは寄付に一致し、1つは依存関係のライセンス遵守条件で要求され、2つはメインテナンスリーダーによって要求され、12は要求する権威のない標準的な慣行です。その12のうち3つは、プロジェクトに存在しないセキュリティレビューチームを前提としています。結果: 5つ維持、3つ追加、12を削除またはオプション化。
このチェックがなければ、チームは17項目をコミットし、寄付レビュー担当者が実際にチェックする3項目を見逃していたでしょう。
完了報告前のチェックリスト
- 提供されたすべての項目に、正確に1つの権威タグが付与されている。
- すべての資金提供者または法律/規制タグに、実際に読んだ情報源からの引用がある。
- 統治元のテンプレートがセクションごとに読まれたか、またはアクセスできなかったことが明記され、結論が暫定的であるとマークされている。
- 追加された行が提供された行と視覚的に分離されている。
- 削除 / 維持 / 追加が存在し、各行に理由がある。