はじめに
開発で得たノウハウは、技術記事や開発事例として公開できます。ただし、実案件由来の素材には、顧客名、社内システム名、実データ、ファイルパス、APIキーなどが混ざることがあります。
公開前にリスクチェックを挟むことで、技術的な価値を残しながら、公開してはいけない情報を除外できます。
使う場面
- 技術記事を公開する前
- 開発事例として案件内容を一般化するとき
- スクリーンショットや図解を記事に使うとき
- AIに記事化や要約を依頼する前
- MDX記事の本文やコードブロックを最終確認するとき
公開前に確認する情報
次の情報は、公開禁止またはユーザー確認の対象にします。
| 種類 | 例 | |---|---| | 個人・顧客情報 | 個人名、顧客名、会社名、メールアドレス、電話番号、住所 | | 秘密情報 | APIキー、トークン、パスワード、ライセンスキー | | 案件固有情報 | 案件名、社内システム名、顧客固有の画面名、帳票名 | | 契約情報 | 金額、納期、契約条件、未公開の業務フロー | | 実環境情報 | 実ファイルパス、サーバー名、DB名、共有フォルダ名 |
記事に残す場合は、技術的なパターンとして一般化します。
匿名化の例
| 元の表現 | 公開用の表現 |
|---|---|
| 顧客名 | ある企業、ある事業者、クライアント |
| 会社固有システム名 | 社内管理システム |
| 案件名 | Excel帳票自動化案件 |
| 個人名 | 担当者、利用者 |
| 実ファイルパス | C:\path\to\sample |
| 実データ | サンプルデータ、テストデータ |
匿名化では、単に名前を消すだけでなく、特定できる組み合わせを減らすことが重要です。
スクリーンショット確認
画像を使う場合は、本文以上に慎重に確認します。
- 氏名、会社名、住所、電話番号が写っていないか
- URL、ファイルパス、メールアドレスが写っていないか
- 顧客ロゴ、サービス名、案件名が写っていないか
- タイトルバー、タブ名、シート名に固有名詞が出ていないか
- 業務データや個人情報がセルや一覧に入っていないか
必要なら、実画面ではなくサンプル画面や抽象図へ作り直します。
判定の目安
公開可: 汎用化済みで、機密情報なし
要修正: 匿名化すれば公開可能
要確認: 公開範囲についてユーザー確認が必要
公開不可: 機密性が高く、記事化対象外
判断に迷う素材は、記事化を進める前に確認します。AIエージェントに任せる場合も、「要確認」を勝手に「公開可」へ倒さない運用が必要です。
関連記事
まとめ
公開リスクチェックは、記事作成の最後に慌てて行うものではなく、素材確認の最初に入れる作業です。
技術的に有用な内容でも、顧客名や実パスが残っていると公開できません。公開用には、具体情報をサンプル化し、技術パターンとして再構成してから記事にします。